mirror of
https://github.com/boxpositron/absolute-dotfiles.git
synced 2026-02-28 03:30:37 +00:00
feat(opencode): add with-context custom commands for documentation management
- Add commands: setup-notes, sync-notes, ingest-notes, teleport-notes - Add commands: validate-notes-config, preview-notes-delegation - Add vault organization commands: analyze-vault, reorganize-notes - Update .withcontextconfig.jsonc with delegation patterns - Archive deprecated with-context.ts plugin
This commit is contained in:
111
.config/opencode/command/sync-notes.md
Normal file
111
.config/opencode/command/sync-notes.md
Normal file
@@ -0,0 +1,111 @@
|
||||
---
|
||||
description: Bidirectionally sync documentation files between local project and Obsidian vault
|
||||
agent: general
|
||||
subtask: true
|
||||
---
|
||||
|
||||
# Sync Notes
|
||||
|
||||
Bidirectionally synchronizes documentation files between local project and Obsidian vault. Files are moved based on delegation rules (deleted from source after successful copy).
|
||||
|
||||
## What This Command Does
|
||||
|
||||
This command performs bidirectional synchronization:
|
||||
|
||||
- **Local → Vault**: Files matching "vault" patterns are moved from local to vault
|
||||
- **Vault → Local**: Files matching "local" patterns are moved from vault to local
|
||||
- **Move operation**: Files are DELETED from source after successful copy
|
||||
- **Structure preserved**: Directory structure is maintained in both directions
|
||||
- **Dry-run preview**: See what will happen before executing
|
||||
|
||||
**Prerequisites:**
|
||||
|
||||
- `.withcontextconfig.jsonc` must exist (run `/setup-notes` first if not)
|
||||
- Configuration defines which files are delegated to vault vs local
|
||||
|
||||
## Your Task
|
||||
|
||||
Execute the sync_notes tool immediately with dry-run by default for safety:
|
||||
|
||||
```javascript
|
||||
// Check for --execute flag in arguments
|
||||
const args = '$ARGUMENTS';
|
||||
const shouldExecute = args.includes('--execute');
|
||||
|
||||
const result = await sync_notes({
|
||||
dry_run: !shouldExecute,
|
||||
});
|
||||
|
||||
return result;
|
||||
```
|
||||
|
||||
**Usage:**
|
||||
|
||||
- `/sync-notes` - Preview changes (safe, dry-run mode)
|
||||
- `/sync-notes --execute` - Execute sync for real (moves and deletes files)
|
||||
|
||||
**Important:** This is a destructive operation - files are DELETED from source after successful copy. Always preview first!
|
||||
|
||||
## Parameters
|
||||
|
||||
### dry_run (optional, default: false)
|
||||
|
||||
Preview mode - shows what will happen without making changes:
|
||||
|
||||
```javascript
|
||||
dry_run: true; // Preview only
|
||||
dry_run: false; // Execute for real
|
||||
```
|
||||
|
||||
## Sync Behavior
|
||||
|
||||
**Files with delegation decision "vault":**
|
||||
|
||||
- Moved from local → vault
|
||||
- Deleted from local after successful copy
|
||||
|
||||
**Files with delegation decision "local":**
|
||||
|
||||
- Moved from vault → local
|
||||
- Deleted from vault after successful copy
|
||||
|
||||
**Important notes:**
|
||||
|
||||
- Only files matching `.withcontextconfig.jsonc` patterns are synced
|
||||
- Directory structure is preserved in both locations
|
||||
- Files are DELETED from source automatically (this is a MOVE operation, not COPY)
|
||||
- The tool checks for configuration existence automatically
|
||||
|
||||
## Example Output
|
||||
|
||||
```
|
||||
=== Sync Results ===
|
||||
|
||||
Files moved from local to vault: 12
|
||||
- docs/guides/getting-started.md
|
||||
- docs/architecture/decisions/001-use-typescript.md
|
||||
- CHANGELOG.md
|
||||
... (9 more files)
|
||||
|
||||
Files moved from vault to local: 3
|
||||
- README.md
|
||||
- CONTRIBUTING.md
|
||||
- src/utils/README.md
|
||||
|
||||
Total files deleted from source: 15
|
||||
Errors: 0
|
||||
|
||||
⚠️ Source files were deleted after successful copy (expected behavior)
|
||||
```
|
||||
|
||||
## Related Commands
|
||||
|
||||
- `/setup-notes` - Create configuration file
|
||||
- `/preview-notes-delegation` - Preview sync decisions
|
||||
- `/ingest-notes` - One-way copy to vault (keeps local files)
|
||||
- `/teleport-notes` - One-way download from vault (keeps vault files)
|
||||
- `/validate-notes-config` - Validate configuration
|
||||
|
||||
---
|
||||
|
||||
_The sync-notes tool performs bidirectional synchronization with automatic source deletion._
|
||||
Reference in New Issue
Block a user