feat(cli): wire the expanded v2 files surface

Regeneration picked up seven new operations (72 → 79), every one of which
derived badly. `/files/move` and `/files/bulk-archive` put a verb where the
deriver expects a sub-resource, so each became a group holding a lone `create`;
`GET /files/[id]/share` fetches one share and was read as a collection and
named `list`; and `PATCH /files/[id]` derived to `files update` while its own
summary said "Rename File".

Named them: batch-archive (matching tables rows batch-delete), move, rename,
restore, set-content, share get, share set. Bulk archive is gated behind --yes
like the other batch destructives.

`files list` gained --scope active|archived, and its rows now carry folderPath —
added as a column, since which folder a file sits in is what distinguishes two
rows sharing a name.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0148a65fkPhP4N8tgGPYtRTU

Author: TheodoreSpeaks

packages/sim-cli/src/contract/commands.ts

@@ -122,6 +122,9 @@ export const CLI_CONTRACT: CliContract = {
     columns: [
       { header: 'id' },
       { header: 'name' },
+      // Now that files live in folders, which one is the difference between two
+      // identically-named rows.
+      { header: 'folder', path: 'folderPath' },
       { header: 'size', format: 'bytes' },
       { header: 'type' },
       { header: 'uploaded', path: 'uploadedAt', format: 'timestamp' },
@@ -200,6 +203,43 @@ export const CLI_CONTRACT: CliContract = {
     ],
   },
 
+  // ─── The expanded files surface ───────────────────────────────────────────
+  // Every one of these derives badly. `/files/move` and `/files/bulk-archive`
+  // are verbs sitting where the deriver expects a sub-resource, so it made them
+  // groups holding a lone `create`; and `GET /files/[id]/share` fetches one
+  // share, which the deriver read as a collection and named `list`.
+  bulkArchiveFileItems: {
+    // `batch-` for the bulk form, matching `tables rows batch-delete`.
+    command: 'files batch-archive',
+    describe: 'Archive several files and folders at once',
+    confirm: 'This archives every listed file and folder, and everything inside those folders.',
+  },
+  moveFileItems: {
+    command: 'files move',
+    describe: 'Move files and folders into another folder',
+  },
+  renameFile: {
+    // Derived to `files update`, which contradicted its own summary.
+    command: 'files rename',
+    describe: 'Rename a file',
+  },
+  restoreFile: {
+    command: 'files restore',
+    describe: 'Restore an archived file',
+  },
+  updateFileContent: {
+    command: 'files set-content',
+    describe: 'Replace a file’s contents',
+  },
+  getFileShare: {
+    command: 'files share get',
+    describe: 'Show a file’s share settings',
+  },
+  upsertFileShare: {
+    command: 'files share set',
+    describe: 'Enable or disable sharing for a file',
+  },
+
   // ─── Documents, not records ───────────────────────────────────────────────
   // The payload is the artifact: `sim workflows export <id> > wf.json` has to
   // produce something `sim workflows import` accepts back.