generated from coulomb/repo-seed
tegwick
b605d970e3
Renames the package, distribution, CLI alias, Makefile targets, and working directory from issue-facade to issue-core, signalling its role as the authoritative task lifecycle manager for the Coulomb org (peer to activity-core, rules-core, project-core). Adds POST /issues/ ingestion endpoint for activity-core's IssueSink, under a new optional [api] extra. The endpoint is served by `issue serve`, authenticates via the ISSUE_CORE_API_KEY env var (Bearer or X-API-Key header), and routes the TaskSpec payload to the configured default backend with full traceability metadata embedded in sync_metadata. - T01: Python package issue_tracker -> issue_core, dir rename - T02: registered in state hub under custodian domain - T03: INTENT.md (what it is, what it isn't, how it fits) - T04: SCOPE.md (in/out-of-scope, integration boundaries) - T05: POST /issues/ via FastAPI + Uvicorn, 9 unit tests - T06: docs/nats-task-ingestion.md design stub Closes ISSC-WP-0001. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
136 lines
4.3 KiB
Python
136 lines
4.3 KiB
Python
"""
|
|
Main CLI Entry Point
|
|
|
|
Universal Issue Tracking System CLI
|
|
"""
|
|
|
|
import click
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
from .commands import issue_group
|
|
from .backend_commands import backend_group
|
|
from .sync_commands import sync_group
|
|
from .serve_command import serve_command
|
|
from .. import __version__
|
|
|
|
|
|
@click.group()
|
|
@click.version_option(version=__version__, package_name='issue-core')
|
|
@click.option('--config', type=click.Path(), help='Configuration file path')
|
|
@click.option('--backend', help='Backend to use (local, gitea)')
|
|
@click.option('--verbose', '-v', is_flag=True, help='Verbose output')
|
|
@click.pass_context
|
|
def cli(ctx, config, backend, verbose):
|
|
"""
|
|
Universal Issue Tracking System
|
|
|
|
A backend-agnostic issue tracking tool that works with local SQLite,
|
|
Gitea, GitHub, and other issue tracking systems.
|
|
|
|
Examples:
|
|
issue list # List all issues
|
|
issue create "Bug in parser" # Create new issue
|
|
issue show 42 # Show issue #42
|
|
issue close 42 # Close issue #42
|
|
|
|
backend add local ~/.issues # Add local backend
|
|
backend add gitea myrepo # Add Gitea backend
|
|
|
|
sync pull gitea # Sync from Gitea
|
|
sync push gitea # Sync to Gitea
|
|
"""
|
|
# Ensure the object exists
|
|
ctx.ensure_object(dict)
|
|
|
|
# Store global options in context
|
|
ctx.obj['config_path'] = config
|
|
ctx.obj['backend'] = backend
|
|
ctx.obj['verbose'] = verbose
|
|
|
|
|
|
# Register command groups
|
|
cli.add_command(issue_group, name='issue')
|
|
cli.add_command(backend_group, name='backend')
|
|
cli.add_command(sync_group, name='sync')
|
|
cli.add_command(serve_command)
|
|
|
|
|
|
# Convenience aliases - direct issue commands
|
|
@cli.command('list')
|
|
@click.option('--state', type=click.Choice(['open', 'closed', 'all']), default='open', help='Issue state filter')
|
|
@click.option('--assignee', help='Filter by assignee')
|
|
@click.option('--label', multiple=True, help='Filter by labels')
|
|
@click.option('--milestone', help='Filter by milestone')
|
|
@click.option('--search', help='Search in title and description')
|
|
@click.option('--limit', type=int, default=30, help='Maximum number of issues to show')
|
|
@click.option('--format', 'output_format', type=click.Choice(['table', 'json', 'compact']), default='table', help='Output format')
|
|
@click.pass_context
|
|
def list_issues(ctx, state, assignee, label, milestone, search, limit, output_format):
|
|
"""List all issues (alias for 'issue list')."""
|
|
ctx.invoke(
|
|
issue_group.get_command(ctx, 'list'),
|
|
state=state,
|
|
assignee=assignee,
|
|
label=label,
|
|
milestone=milestone,
|
|
search=search,
|
|
limit=limit,
|
|
output_format=output_format
|
|
)
|
|
|
|
|
|
@cli.command('show')
|
|
@click.argument('issue_number', type=int)
|
|
@click.pass_context
|
|
def show_issue(ctx, issue_number):
|
|
"""Show issue details (alias for 'issue show')."""
|
|
ctx.invoke(issue_group.get_command(ctx, 'show'), issue_number=issue_number)
|
|
|
|
|
|
@cli.command('create')
|
|
@click.argument('title')
|
|
@click.option('--description', '-d', help='Issue description')
|
|
@click.option('--label', '-l', multiple=True, help='Labels to add')
|
|
@click.option('--assignee', '-a', help='Assign to user')
|
|
@click.option('--milestone', '-m', help='Milestone')
|
|
@click.pass_context
|
|
def create_issue(ctx, title, description, label, assignee, milestone):
|
|
"""Create new issue (alias for 'issue create')."""
|
|
ctx.invoke(
|
|
issue_group.get_command(ctx, 'create'),
|
|
title=title,
|
|
description=description,
|
|
label=label,
|
|
assignee=assignee,
|
|
milestone=milestone
|
|
)
|
|
|
|
|
|
@cli.command('close')
|
|
@click.argument('issue_number', type=int)
|
|
@click.option('--comment', '-c', help='Closing comment')
|
|
@click.pass_context
|
|
def close_issue(ctx, issue_number, comment):
|
|
"""Close issue (alias for 'issue close')."""
|
|
ctx.invoke(
|
|
issue_group.get_command(ctx, 'close'),
|
|
issue_number=issue_number,
|
|
comment=comment
|
|
)
|
|
|
|
|
|
def main():
|
|
"""Main entry point for the CLI."""
|
|
try:
|
|
cli(obj={})
|
|
except KeyboardInterrupt:
|
|
click.echo("\nAborted by user", err=True)
|
|
sys.exit(1)
|
|
except Exception as e:
|
|
click.echo(f"Error: {e}", err=True)
|
|
sys.exit(1)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main() |