Deliverables Hub Playbook

Version: 1.0 | Last Updated: 2026-04-06 | Author: Ares

What Is the Deliverables Hub?

The Deliverables Hub is a centralized web interface and REST API for browsing, searching, previewing, and uploading agent deliverables. All agent output files (reports, strategies, documents, images) are accessible through a single UI and API layer.

Public URL: https://dashboard.thesherminator.com/deliverables

How to Access the Hub

Web UI

Visit: https://dashboard.thesherminator.com/deliverables

Features available:

Browse all files by agent folder
Search files by name
Filter by file type (markdown, image, JSON, other)
Sort by name, date, or size
Preview file contents in a modal (markdown rendered, images displayed)
Switch between List and Folders view
View this playbook by clicking the 📖 Playbook button in the header

API Access (for agents)

Base URLs:

Backend (internal): http://localhost:3003/api/deliverables
Frontend proxy: http://localhost:3001/api/deliverables

API Endpoints

1. List All Deliverables

GET /api/deliverables

Returns all files grouped by agent with metadata.

Response:

{
  "success": true,
  "total": 210,
  "deliverables": [
    {
      "agent": "ares",
      "files": [
        {
          "name": "DELIVERABLES-HUB-PLAYBOOK.md",
          "path": "ares/DELIVERABLES-HUB-PLAYBOOK.md",
          "size": 15821,
          "modified": "2026-04-06T01:00:00Z",
          "type": "markdown"
        }
      ]
    }
  ]
}

Example:

curl http://localhost:3003/api/deliverables

2. Read a File

GET /api/deliverables/file?path=<agent>/<filename>

Returns the content of a specific file.

Parameters:

path — relative path in format agentname/filename.ext

Response:

{
  "success": true,
  "content": "# File content here...",
  "fileType": "markdown",
  "size": 15821,
  "name": "DELIVERABLES-HUB-PLAYBOOK.md"
}

Example:

curl "http://localhost:3003/api/deliverables/file?path=ares/DELIVERABLES-HUB-PLAYBOOK.md"

3. Search Deliverables

GET /api/deliverables/search?q=<query>

Search files by filename (case-insensitive).

Parameters:

q — search query string

Response:

{
  "success": true,
  "query": "playbook",
  "total": 2,
  "results": [
    {
      "name": "DELIVERABLES-HUB-PLAYBOOK.md",
      "path": "ares/DELIVERABLES-HUB-PLAYBOOK.md",
      "agent": "ares",
      "size": 15821,
      "type": "markdown"
    }
  ]
}

Example:

curl "http://localhost:3003/api/deliverables/search?q=playbook"

4. Get Hub Statistics

GET /api/deliverables/stats

Returns summary statistics for the entire hub.

Response:

{
  "success": true,
  "stats": {
    "total_files": 210,
    "total_agents": 11,
    "total_size_mb": "4.92",
    "by_type": {
      "markdown": 154,
      "image": 38,
      "json": 9,
      "other": 9
    },
    "by_agent": {
      "ares": 2,
      "aria": 7,
      "cassius": 11,
      "darrow": 94
    }
  }
}

Example:

curl http://localhost:3003/api/deliverables/stats

5. Upload a New Deliverable

POST /api/deliverables/upload
Content-Type: application/json

Upload a new file to an agent's deliverables folder.

Request body:

{
  "agentName": "ares",
  "fileName": "my-report.md",
  "content": "# My Report

Content here..."
}

Response:

{
  "success": true,
  "message": "File uploaded successfully",
  "path": "ares/my-report.md"
}

Example:

curl -X POST http://localhost:3003/api/deliverables/upload \
  -H "Content-Type: application/json" \
  -d '{"agentName":"ares","fileName":"my-report.md","content":"# My Report"}'

Notes:

Agent folder is created automatically if it doesn't exist
Existing files are NOT overwritten (will return error)
Maximum file size: 10MB
Content should be UTF-8 text (for binary files, use base64)

Common Workflows

Browse All Deliverables (Web)

Go to https://dashboard.thesherminator.com/deliverables
Use the folder list on the left to navigate by agent
Click any file to open the preview modal
Use search bar to find specific files

Read a File (API)

# Read a specific file
curl "http://localhost:3003/api/deliverables/file?path=darrow/STRATEGY-2026.md"

Search for Files (API)

# Find all files with "report" in the name
curl "http://localhost:3003/api/deliverables/search?q=report"

Upload Your Deliverable (API)

# Upload a new report
curl -X POST http://localhost:3003/api/deliverables/upload \
  -H "Content-Type: application/json" \
  -d '{
    "agentName": "yourname",
    "fileName": "Q2-REPORT.md",
    "content": "# Q2 Report\n\nContent..."
  }'

Check Hub Stats (API)

curl http://localhost:3003/api/deliverables/stats | jq .

File Organization

Files are stored per agent:

deliverables/
├── ares/          # Ares agent files
├── aria/          # Aria agent files
├── cassius/       # Cassius agent files
├── darrow/        # Darrow agent files
├── fitchner/      # Fitchner agent files
├── freddie/       # Freddie agent files
├── mustang/       # Mustang agent files
├── quinn/         # Quinn agent files
├── roque/         # Roque agent files
├── sevro/         # Sevro agent files
└── victra/        # Victra agent files

Naming conventions:

Use UPPERCASE-WITH-DASHES for report files (e.g., Q2-STRATEGY-REPORT.md)
Use descriptive names that include date or version when relevant
Markdown (.md) for text documents
JSON (.json) for structured data

Security Notes

All endpoints are read/write but protected against path traversal attacks
File reads are limited to the agents directory
No authentication is currently required (internal network only)
The public URL requires HTTPS

Troubleshooting

"Failed to load file content" — The file path is wrong or the file doesn't exist in the backend agent directory. Verify using the list endpoint.

"File already exists" — The upload endpoint prevents overwriting. Use a different filename or check if the file already exists.

502 Bad Gateway — The command-center service is down or restarting. Wait a few seconds and try again.

Search returns 0 results — Search is filename-based only. Check spelling and try a shorter query.

This playbook is maintained by Ares. For updates, contact the Deliverables Hub administrator.