fix: restore docs deleted in v0.2.3 release, add Paperclip branding

- Restored docs/ directory that was accidentally deleted by `git add -A`
  in the v0.2.3 release script
- Replaced generic "P" favicon with actual paperclip icon using brand
  primary color (#2563EB)
- Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark)
- Updated docs.json with logo configuration for dark/light mode
- Fixed release.sh to stage only release-related files instead of `git add -A`
  to prevent sweeping unrelated changes into release commits

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/api/goals-and-projects.md

@@ -0,0 +1,121 @@
+---
+title: Goals and Projects
+summary: Goal hierarchy and project management
+---
+
+Goals define the "why" and projects define the "what" for organizing work.
+
+## Goals
+
+Goals form a hierarchy: company goals break down into team goals, which break down into agent-level goals.
+
+### List Goals
+
+```
+GET /api/companies/{companyId}/goals
+```
+
+### Get Goal
+
+```
+GET /api/goals/{goalId}
+```
+
+### Create Goal
+
+```
+POST /api/companies/{companyId}/goals
+{
+  "title": "Launch MVP by Q1",
+  "description": "Ship minimum viable product",
+  "level": "company",
+  "status": "active"
+}
+```
+
+### Update Goal
+
+```
+PATCH /api/goals/{goalId}
+{
+  "status": "completed",
+  "description": "Updated description"
+}
+```
+
+## Projects
+
+Projects group related issues toward a deliverable. They can be linked to goals and have workspaces (repository/directory configurations).
+
+### List Projects
+
+```
+GET /api/companies/{companyId}/projects
+```
+
+### Get Project
+
+```
+GET /api/projects/{projectId}
+```
+
+Returns project details including workspaces.
+
+### Create Project
+
+```
+POST /api/companies/{companyId}/projects
+{
+  "name": "Auth System",
+  "description": "End-to-end authentication",
+  "goalIds": ["{goalId}"],
+  "status": "planned",
+  "workspace": {
+    "name": "auth-repo",
+    "cwd": "/path/to/workspace",
+    "repoUrl": "https://github.com/org/repo",
+    "repoRef": "main",
+    "isPrimary": true
+  }
+}
+```
+
+Notes:
+
+- `workspace` is optional. If present, the project is created and seeded with that workspace.
+- A workspace must include at least one of `cwd` or `repoUrl`.
+- For repo-only projects, omit `cwd` and provide `repoUrl`.
+
+### Update Project
+
+```
+PATCH /api/projects/{projectId}
+{
+  "status": "in_progress"
+}
+```
+
+## Project Workspaces
+
+Workspaces link a project to a repository and directory:
+
+```
+POST /api/projects/{projectId}/workspaces
+{
+  "name": "auth-repo",
+  "cwd": "/path/to/workspace",
+  "repoUrl": "https://github.com/org/repo",
+  "repoRef": "main",
+  "isPrimary": true
+}
+```
+
+Agents use the primary workspace to determine their working directory for project-scoped tasks.
+
+### Manage Workspaces
+
+```
+GET /api/projects/{projectId}/workspaces
+PATCH /api/projects/{projectId}/workspaces/{workspaceId}
+DELETE /api/projects/{projectId}/workspaces/{workspaceId}
+```