@wspc/cli 0.0.22 → 0.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 Official TypeScript SDK and CLI for [wspc.ai](https://wspc.ai).
 
-> Status: **v0 walking skeleton.** Covers the todo domain only.
+> Status: **v0 walking skeleton.** Covers todo commands plus the first manual Drive sync slice.
 
 ## Install
 
@@ -39,10 +39,30 @@ scopes todos per project. Run `wspc todo project ls` to discover ids.
 | `wspc todo project {add, ls}` | Project scope. |
 | `wspc todo type ls` | List todo types. |
 | `wspc todo rule ls` | List recurrence rules. |
+| `wspc drive bind --library <id> [path]` | Bind an existing Drive library to a local folder. |
+| `wspc drive sync once [path]` | Run one manual whole-file Drive sync pass. |
 | `wspc config` | Inspect / clear local config. |
 
 Pass `--help` to any subcommand for flags, aliases, and examples.
 
+## Drive sync
+
+Bind a local folder to an existing Drive library, then run sync explicitly:
+
+```bash
+wspc drive bind --library lib_xxx ./notes
+wspc drive sync once ./notes
+```
+
+`bind` does not create a server library. It verifies the existing library, writes
+`.wspc-drive/state.json`, and waits for an explicit `sync once`.
+
+`sync once` is the v1 safe manual sync path: it performs a full folder scan,
+compares local files with the remote manifest, uploads/downloads whole files,
+uses optimistic remote versions for updates/deletes, and records conflicts in
+local state instead of auto-merging them. It does not run a watcher, preserve
+empty directories, detect renames, or create remote libraries.
+
 ### Running a command as a specific account
 
 You can run any single command as a particular account without switching the active one:

package/dist/cli.d.ts

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
+import { Command } from 'commander';
+
+declare function mountDriveCommands(program: Command): void;
+declare function isCliEntrypoint(argv?: string[], metaUrl?: string): boolean;
 declare function dispatch(argv: string[], { allowRetry }?: {
     allowRetry?: boolean;
 }): Promise<void>;
 
-export { dispatch };
+export { dispatch, isCliEntrypoint, mountDriveCommands };