Features API

Overview

Features are automatically discovered from your codebase. The API provides read-only access.

List Features

Get all discovered features.

GET /v1/features

Query Parameters

• limit - Results per page
• cursor - Pagination cursor

Response

{
  "features": [
    {
      "id": 42,
      "name": "user-authentication",
      "description": "User login and registration",
      "file": "src/auth/index.ts",
      "createdAt": "2025-12-08T..."
    }
  ]
}

Example

curl -H "Authorization: Bearer sk_admin_xxx" \
  http://localhost:3000/conduct/v1/features

Get Feature

Get a specific feature.

GET /v1/features/:id

Response

{
  "feature": {
    "id": 42,
    "name": "user-authentication",
    "description": "User login and registration",
    "file": "src/auth/index.ts",
    "createdAt": "2025-12-08T..."
  }
}

Example

curl -H "Authorization: Bearer sk_admin_xxx" \
  http://localhost:3000/conduct/v1/features/42

Get Feature Runs

Get all runs that modified this feature.

GET /v1/features/:id/runs

Response

{
  "runs": [
    {
      "id": 1,
      "runId": "RUN-001",
      "specId": "AUTH-001",
      "status": "completed",
      "createdAt": "2025-12-08T..."
    }
  ]
}

Example

curl -H "Authorization: Bearer sk_admin_xxx" \
  http://localhost:3000/conduct/v1/features/42/runs

Feature Discovery

Features are discovered by:

1. Analyzing codebase structure
2. Extracting function and class names
3. Parsing documentation
4. Tracking git history

New features are automatically added when runs reference them.