Scaffold CLI tool for working with brand-guidelines #2

Closed

agent wants to merge 0 commits from scaffold-mvp into main

agent commented

2026-02-27 12:40:34 -08:00

Collaborator

Summary

Complete MVP implementation of sigil CLI tool following the commune/bloc pattern.

What's included

Core functionality

Commands: info, colors, palettes, logos
Fetches brand.json from Forgejo repositories via API
Rich terminal output with optional --json flag
Pydantic models matching brand.schema.json
Error handling with helpful hints

Architecture

src/sigil/
  cli.py         # Main app + typer commands
  client.py      # Forgejo API client
  models.py      # Pydantic schema models
  output.py      # Rich formatting
  exceptions.py  # Custom errors

Usage examples

# Show metadata
sigil brad/brand-guidelines

# List colors with formatted output
sigil brad/brand-guidelines colors

# JSON output for scripting
sigil brad/brand-guidelines palettes --json

Testing

Basic unit tests for models and CLI parsing

Future work (not in MVP)

Modify operations
Local file reading
Export generation

Closes #1

## Summary Complete MVP implementation of sigil CLI tool following the commune/bloc pattern. ## What's included ### Core functionality - **Commands**: `info`, `colors`, `palettes`, `logos` - Fetches `brand.json` from Forgejo repositories via API - Rich terminal output with optional `--json` flag - Pydantic models matching brand.schema.json - Error handling with helpful hints ### Architecture ``` src/sigil/ cli.py # Main app + typer commands client.py # Forgejo API client models.py # Pydantic schema models output.py # Rich formatting exceptions.py # Custom errors ``` ### Usage examples ```bash # Show metadata sigil brad/brand-guidelines # List colors with formatted output sigil brad/brand-guidelines colors # JSON output for scripting sigil brad/brand-guidelines palettes --json ``` ### Testing - Basic unit tests for models and CLI parsing ## Future work (not in MVP) - Modify operations - Local file reading - Export generation Closes #1