Versioning

curl 'http://localhost:3333/api/kiwi/versions?path=concepts/auth.md'

[
  {
    "hash": "e4f5g6h",
    "author": "agent:docs-writer",
    "message": "update concepts/auth.md",
    "timestamp": "2026-04-25T14:30:00Z"
  },
  {
    "hash": "a1b2c3d",
    "author": "agent:importer",
    "message": "create concepts/auth.md",
    "timestamp": "2026-04-24T09:15:00Z"
  }
]

curl 'http://localhost:3333/api/kiwi/version?path=concepts/auth.md&version=a1b2c3d'

# Authentication

Original content from the first commit...

curl 'http://localhost:3333/api/kiwi/diff?path=concepts/auth.md&from=a1b2c3d&to=e4f5g6h'

--- a/concepts/auth.md
+++ b/concepts/auth.md
@@ -1,3 +1,5 @@
 # Authentication

-Original content from the first commit...
+OAuth2 + JWT based authentication system.
+
+Supports refresh token rotation.

curl 'http://localhost:3333/api/kiwi/blame?path=concepts/auth.md'

[
  {
    "line": 1,
    "content": "# Authentication",
    "hash": "a1b2c3d",
    "author": "agent:importer",
    "timestamp": "2026-04-24T09:15:00Z"
  },
  {
    "line": 3,
    "content": "OAuth2 + JWT based authentication system.",
    "hash": "e4f5g6h",
    "author": "agent:docs-writer",
    "timestamp": "2026-04-25T14:30:00Z"
  }
]

GET /api/kiwi/changes

curl 'http://localhost:3333/api/kiwi/changes?limit=10'

{
  "changes": [
    {"seq": 1, "path": "concepts/auth.md", "action": "write", "actor": "agent:docs-writer", "timestamp": "2026-05-04T12:00:00Z"},
    {"seq": 2, "path": "concepts/billing.md", "action": "delete", "actor": "agent:cleanup", "timestamp": "2026-05-04T12:01:00Z"}
  ],
  "last_seq": "e4f5g6h..."
}

# 1. Read the file and capture the ETag
ETAG=$(curl -sI 'http://localhost:3333/api/kiwi/file?path=concepts/auth.md' \
  | grep -i etag | awk '{print $2}' | tr -d '\r"')

# 2. Write with If-Match to prevent conflicts
curl -X PUT 'http://localhost:3333/api/kiwi/file?path=concepts/auth.md' \
  -H "Content-Type: text/markdown" \
  -H "X-Actor: agent:updater" \
  -H "If-Match: $ETAG" \
  -d '# Authentication (updated)

Revised content.'

{"error": "conflict: file was modified since your last read"}