Core Implementation (BAT-010):
- Add daemon registry schema and CRUD operations (req-023)
- Implement single-daemon asset assignment constraint (one asset per daemon)
- Add daemon_id field to service_token for daemon identification
- Add daemon.py CLI module for daemon management commands
- Add 20260513_0016_daemon_model.py migration for daemon tables
API Changes:
- GET /v1/assets: include daemon_id in AssetResponse
- POST /v1/assets/{asset_id}/ledger/trades: require daemon token binding
- GET /v1/user_info: include daemon metadata
- Enhanced service-token rotate to preserve daemon bindings
CLI Commands:
- pfhub daemon register --name <name> --runtime-id <runtime-id>
- pfhub daemon list
- pfhub daemon get <daemon-id>
- pfhub daemon revoke <daemon-id>
Requirements (REQ-023, REQ-028):
- REQ-023: Daemon Registry and Service Token Daemon Binding (Interface, Approved)
* AC-1: daemon CRUD operations
* AC-2: service token daemon binding for POST /v1/assets/{asset_id}/ledger/trades
* AC-3: single daemon per asset (exact-one assignment model)
- REQ-028: README.md Daemon Provisioning Runbook update (Documentation, Approved)
Documentation:
- Add dcy-006 Discovery for daemon-id and single-daemon asset assignment
- Update README.md with Daemon Provisioning Runbook section
- Add BAT-010 batch documentation with planning, implementation, verification
- Update rel-006 release document (daemon model implementation)
- Update data-model.md with daemon and daemon_asset_assignment tables
- Update interface-contract.md with daemon registry APIs
- Update runtime-flows.md with daemon lifecycle flows
Breaking Changes:
- REQ-005~009, REQ-011~012 status reverted to Approved due to revised contract
* daemon_id field addition and exact-one asset assignment requirement
* Existing Implemented evidence invalidated by contract revision
* BAT-001/002/008 re-verification required
Testing:
- Add test_daemon_registry.py for daemon CRUD operations
- Add test_daemon_assignment.py for single-asset assignment constraints
- Update test_auth.py, test_cli.py, test_v1.py for daemon support
- Verify daemon token binding in trade endpoint authorization
Impact:
- Database: 2 new tables (daemons, daemon_asset_assignments)
- Migration: 20260513_0016 creates daemon model schema
- CLI: 4 new daemon subcommands
- API: daemon_id propagation through v1 endpoints
- Verification: BAT-001/002/008 re-verification gates next release
70 lines
2.6 KiB
Python
70 lines
2.6 KiB
Python
"""Daemon model: daemons table, auth_tokens.daemon_id, portfolios.managed_by_daemon_id
|
|
|
|
Revision ID: 20260513_0016
|
|
Revises: 20260511_0015
|
|
Create Date: 2026-05-13 00:00:00
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sqlalchemy as sa
|
|
from alembic import op
|
|
from sqlalchemy import inspect
|
|
|
|
revision = "20260513_0016"
|
|
down_revision = "20260511_0015"
|
|
branch_labels = None
|
|
depends_on = None
|
|
|
|
|
|
def _table_exists(inspector: sa.engine.Inspector, table_name: str) -> bool:
|
|
return table_name in inspector.get_table_names()
|
|
|
|
|
|
def _column_exists(inspector: sa.engine.Inspector, table_name: str, column_name: str) -> bool:
|
|
if not _table_exists(inspector, table_name):
|
|
return False
|
|
return any(c["name"] == column_name for c in inspector.get_columns(table_name))
|
|
|
|
|
|
def upgrade() -> None:
|
|
bind = op.get_bind()
|
|
inspector = inspect(bind)
|
|
|
|
# Step 1: Create daemons table
|
|
if not _table_exists(inspector, "daemons"):
|
|
op.create_table(
|
|
"daemons",
|
|
sa.Column("id", sa.Text(), nullable=False),
|
|
sa.Column("owner_user_id", sa.Text(), nullable=False),
|
|
sa.Column("daemon_slug", sa.Text(), nullable=False),
|
|
sa.Column("display_name", sa.Text(), nullable=True),
|
|
sa.Column("is_active", sa.Boolean(), nullable=False, server_default=sa.text("true")),
|
|
sa.Column("created_at", sa.TIMESTAMP(timezone=True), nullable=False, server_default=sa.text("NOW()")),
|
|
sa.Column("updated_at", sa.TIMESTAMP(timezone=True), nullable=False, server_default=sa.text("NOW()")),
|
|
sa.PrimaryKeyConstraint("id"),
|
|
sa.UniqueConstraint("owner_user_id", "daemon_slug", name="uq_daemons_owner_slug"),
|
|
)
|
|
|
|
# Step 2: Add auth_tokens.daemon_id (nullable FK to daemons.id, no DB-level FK constraint — soft reference)
|
|
if not _column_exists(inspector, "auth_tokens", "daemon_id"):
|
|
op.add_column("auth_tokens", sa.Column("daemon_id", sa.Text(), nullable=True))
|
|
|
|
# Step 3: Add portfolios.managed_by_daemon_id (nullable soft reference to daemons.id)
|
|
if not _column_exists(inspector, "portfolios", "managed_by_daemon_id"):
|
|
op.add_column("portfolios", sa.Column("managed_by_daemon_id", sa.Text(), nullable=True))
|
|
|
|
|
|
def downgrade() -> None:
|
|
bind = op.get_bind()
|
|
inspector = inspect(bind)
|
|
|
|
if _column_exists(inspector, "portfolios", "managed_by_daemon_id"):
|
|
op.drop_column("portfolios", "managed_by_daemon_id")
|
|
|
|
if _column_exists(inspector, "auth_tokens", "daemon_id"):
|
|
op.drop_column("auth_tokens", "daemon_id")
|
|
|
|
if _table_exists(inspector, "daemons"):
|
|
op.drop_table("daemons")
|