sova: Command for Claude Code

Verify Local

Run a 6-phase smoke test to verify SOVA works end-to-end on this machine. Exercises real CLI commands, creates a temp project, checks adapter creation, and briefly starts the dashboard.

Context: $ARGUMENTS

Instructions

Phase 1: CLI Entrypoints

Verify the CLI loads and new subcommands are registered:

sova --help
sova --version
sova doctor --help
sova commands sync --help

All four must exit 0. If any fails, report which one and stop.

Phase 2: sova doctor

Run the doctor on the SOVA project itself:

sova doctor --project .

Expected: exit 0, all required checks pass (Python, git, gh, claude). Report the output table.

Phase 3: Fresh Project Install

Test the full install pipeline on a disposable temp project:

tmp=$(mktemp -d)
git init "$tmp/smoke-test"

Then run:

sova install "$tmp/smoke-test"

Verify these artifacts exist:

• $tmp/smoke-test/.claude/sova.db (config is database-backed; sova install writes no TOML)
• $tmp/smoke-test/.claude/commands/ (non-empty)
• $tmp/smoke-test/.claude/agent-memory/MEMORY.md

Run doctor on the new project:

sova doctor --project "$tmp/smoke-test"

Clean up:

rm -rf "$tmp/smoke-test"

Report PASS if all artifacts exist and install exits 0.

Phase 4: Command Sync

Test multi-project command synchronization:

sova commands sync

If registered projects exist: verify it reports per-project results and a summary line. If no projects registered: verify it prints the "no projects" message and exits 0. Report as PASS (expected on fresh machines).

Phase 5: Adapter Factory

Verify the adapter factory creates both adapter types correctly:

python3 -c "
from sova.config.models import ProjectConfig, TaskSourceConfig
from sova.adapters import create_adapter

# GitHub adapter
cfg = ProjectConfig(github_repo='test/repo', github_user='testuser')
a = create_adapter(cfg)
assert a.__class__.__name__ == 'GitHubAdapter', f'Expected GitHubAdapter, got {a.__class__.__name__}'
assert a.github_user == 'testuser'
print('  GitHub adapter: OK')

# Jira adapter
cfg = ProjectConfig(task_source=TaskSourceConfig(
    type='jira',
    jira_base_url='https://test.atlassian.net',
    jira_email='[email protected]',
    jira_api_token='test-token',
    jira_project_key='TEST',
))
a = create_adapter(cfg)
assert a.__class__.__name__ == 'JiraAdapter', f'Expected JiraAdapter, got {a.__class__.__name__}'
assert a.project_key == 'TEST'
print('  Jira adapter: OK')

# Unknown type raises ValueError
try:
    ts = TaskSourceConfig()
    ts.type = 'unknown'
    create_adapter(ProjectConfig(task_source=ts))
    assert False, 'Should have raised ValueError'
except ValueError as e:
    assert 'Unknown adapter type' in str(e)
    print('  Unknown type rejection: OK')

print('  All adapter checks passed')
"