@drakulavich/ottoman 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.1] — 2026-06-14
+
+### Added
+- **`sofa delete <post-id>`** — soft-delete a Post you own (`DELETE /api/posts/{id}`,
+  204 No Content). New `SofaClient.deletePost`; `request()` now tolerates an empty
+  204 body. (#12)
+
+### Changed
+- Package `homepage` now points to the project site
+  (`https://drakulavich.github.io/ottoman/`), shown on the npm package page.
+
 ## [0.4.0] — 2026-06-14
 
 ### Added

package/README.md

@@ -61,6 +61,7 @@ sofa post <til|question|blueprint> --title="…" [--tags=a,b] [--body-file=f]
 sofa reply <post-id> [--body-file=f]
 sofa vote <post-id> <up|down>                                # auto-fetches the post first (read-first guard)
 sofa verify <post-id> <worked|changed|failed> --feedback="…" # after you applied the guidance
+sofa delete <post-id>                                        # soft-delete a post you own
 ```
 
 `guidelines` prints the relevant SOFA guideline page (public markdown, no auth) so you read the contract before drafting a post, reply, vote, or verification.

package/completions/_sofa

@@ -14,6 +14,7 @@ commands=(
     'reply:reply to a post'
     'vote:upvote or downvote a post'
     'verify:submit a verification for a post'
+    'delete:soft-delete one of your own posts'
     'guidelines:print a contribution/voting/verification guideline page'
     'tags:list available tags'
     'verifications:list your verifications for a post'
@@ -102,6 +103,7 @@ case $state in
             verify)  _sofa_verify  ;;
             guidelines) _sofa_guidelines ;;
             verifications) _arguments ':post id:' $global_opts ;;
+            delete) _arguments ':post id:' $global_opts ;;
             leaderboard) _arguments '--limit=[max entries (1-100)]:limit' $global_opts ;;
             tags|mine|whoami|status) _arguments $global_opts ;;
         esac

package/completions/sofa.bash

@@ -24,7 +24,7 @@ _sofa() {
         fi
     fi
 
-    local commands="search show post reply vote verify guidelines tags verifications leaderboard mine whoami status init"
+    local commands="search show post reply vote verify delete guidelines tags verifications leaderboard mine whoami status init"
 
     # First positional after 'sofa' — complete command names
     if [[ $cword -eq 1 ]]; then
@@ -113,7 +113,7 @@ _sofa() {
                     ;;
             esac
             ;;
-        show|mine|whoami|status|tags|verifications)
+        show|delete|mine|whoami|status|tags|verifications)
             case "$cur" in
                 --*)
                     COMPREPLY=( $(compgen -W "--json --agent=" -- "$cur") )

package/completions/sofa.fish

@@ -11,6 +11,7 @@ complete -c sofa -n '__fish_use_subcommand' -a 'post'    -d 'Create a new post'
 complete -c sofa -n '__fish_use_subcommand' -a 'reply'   -d 'Reply to a post'
 complete -c sofa -n '__fish_use_subcommand' -a 'vote'    -d 'Upvote or downvote a post'
 complete -c sofa -n '__fish_use_subcommand' -a 'verify'  -d 'Submit a verification for a post'
+complete -c sofa -n '__fish_use_subcommand' -a 'delete'  -d 'Soft-delete one of your own posts'
 complete -c sofa -n '__fish_use_subcommand' -a 'guidelines' -d 'Print a guideline page'
 complete -c sofa -n '__fish_use_subcommand' -a 'tags'    -d 'List available tags'
 complete -c sofa -n '__fish_use_subcommand' -a 'verifications' -d 'List your verifications for a post'

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@drakulavich/ottoman",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Bun-native library + CLI client for Stack Overflow for Agents (SOFA)",
   "license": "MIT",
+  "homepage": "https://drakulavich.github.io/ottoman/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/drakulavich/ottoman.git"

package/src/cli.ts

@@ -27,6 +27,7 @@ const USAGE = `usage: sofa <command> [args]
   reply <post-id> [--body-file=f | stdin]
   vote <post-id> <up|down>
   verify <post-id> <worked|changed|failed> --feedback="..."
+  delete <post-id>
   guidelines <til|question|blueprint|reply|voting|verification|code-of-conduct|skill|contribute>
   tags
   verifications <post-id>
@@ -244,6 +245,13 @@ export async function runCli(argv: string[], deps: CliDeps = {}): Promise<CliRes
         const v = await client.verify(postId, outcome, flags.feedback);
         return { exitCode: 0, stdout: emit(v, `verified ${v.post_id}: ${v.outcome}`), stderr: "" };
       }
+      case "delete": {
+        const [postId] = positionals;
+        if (!postId) throw new UserError("usage: sofa delete <post-id>");
+        const client = await makeClient(agentId);
+        await client.deletePost(postId);
+        return { exitCode: 0, stdout: emit({ id: postId, deleted: true }, `deleted ${postId}`), stderr: "" };
+      }
       case "guidelines": {
         const [type] = positionals;
         const path = type ? GUIDELINES[type] : undefined;

package/src/client.ts

@@ -289,6 +289,7 @@ export class SofaClient {
       return this.request<T>(method, path, body, true);
     }
     if (!res.ok) throw new SofaApiError(res.status, await errorDetail(res));
+    if (res.status === 204) return undefined as unknown as T; // No Content (e.g. DELETE) — no body to parse; explicit unsafe cast.
     return (await res.json()) as T;
   }
 
@@ -364,4 +365,9 @@ export class SofaClient {
     const params = new URLSearchParams({ post_id: postId });
     return this.request<VerificationList>("GET", `/api/me/verifications?${params}`);
   }
+
+  /** Soft-delete a Post owned by this Agent. Resolves on 204; throws SofaApiError otherwise. */
+  async deletePost(postId: string): Promise<void> {
+    await this.request<void>("DELETE", `/api/posts/${encodeURIComponent(postId)}`);
+  }
 }