README.md

metadata

title: SIN-GitHub-Issues
emoji: 🤖
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false

SIN-GitHub-Issues

SIN-GitHub-Issues is a SIN A2A agent package for the Silicon Workforce.

Identity

• Slug: sin-github-issues
• Team: Team - Coding
• Team Manager: SIN-Coding-CEO
• Purpose: GitHub issue execution agent for confirmed bugs, repo issue lifecycle, branch-based fixes, and verification handoff. Extended with enterprise profile management capabilities.
• Usage: Use after enterprise-deep-debug confirms a bug to search/create/update GitHub issues, open a repo branch, execute the fix workflow, commit, push, and report verification status back to the orchestrating CLI agent. For profile and achievement operations use the new profile/achievement actions.
• Primary Model: opencode/nemotron-3-super-free

Deployment

• Local path: /Users/jeremy/dev/SIN-Solver/a2a/team-coding/A2A-SIN-GitHub-Issues
• GitHub repo: https://github.com/Delqhi/sin-github-issues
• Workforce index: https://a2a.delqhi.com
• Landing page: https://delqhi-sin-github-issues.hf.space
• Public A2A / CIMD: https://a2a.delqhi.com/agents/sin-github-issues
• Hugging Face Space: https://huggingface.co/spaces/delqhi/sin-github-issues
• Hugging Face repo id: delqhi/sin-github-issues
• Cloudflare tunnel: sin-github-issues
• Runtime target: Target: Hugging Face Space free CPU VM

Runtime Shape

• A2A JSON-RPC runtime
• MCP stdio runtime
• CLI wrapper for local and automated use
• publish-ready Docker/Hugging Face Space layout
• keep-alive ping + HF dataset session backup hooks
• best-effort sin-supabase audit persistence for workflow events
• canonical env names: SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY (legacy SIN_SUPABASE_* still accepted)

A2A Surface

• Card: GET /.well-known/agent-card.json
• Alias: GET /.well-known/agent.json
• Health: GET /health
• RPC: POST /a2a/v1

MCP Surface

• Transport: stdio
• Config: ./mcp-config.json
• OpenCode client: ./clients/opencode-mcp.json
• Codex client: ./clients/codex-config.toml

Local Commands

sin-github-issues serve-a2a
sin-github-issues serve-mcp
sin-github-issues print-card
sin-github-issues run-action '{"action":"agent.help"}'
sin-github-issues run-action '{"action":"sin.github.issues.health"}'
sin-github-issues run-action '{"action":"sin.github.issues.auth.status"}'
sin-github-issues run-action '{"action":"sin.github.issues.profile.get"}'
sin-github-issues run-action '{"action":"sin.github.issues.profile.update","name":"Delqhi","company":"AIOMETRICS","blog":"https://www.delqhi.com"}'
sin-github-issues run-action '{"action":"sin.github.issues.profile.pinned_repos.list"}'
sin-github-issues run-action '{"action":"sin.github.issues.repo.metadata.update","repo":"owner/name","description":"...","topics":["ai","automation"]}'
sin-github-issues run-action '{"action":"sin.github.issues.achievement.quickdraw.trigger"}'
sin-github-issues run-action '{"action":"sin.github.issues.issue.ensure","repo":"owner/name","title":"Bug title","body":"..."}'
sin-github-issues run-action '{"action":"sin.github.issues.issue.evidence.policy"}'
sin-github-issues run-action '{"action":"sin.github.issues.repo.branch.start","repoPath":"/abs/repo","branchName":"fix/example"}'
sin-github-issues run-action '{"action":"sin.github.issues.runners.list","repo":"Delqhi/SIN-Solver"}'
sin-github-issues run-action '{"action":"sin.github.issues.workflow.runs.list","repo":"Delqhi/SIN-Solver","branch":"sin-github-issues-bootstrap"}'
sin-github-issues run-action '{"action":"sin.github.issues.workflow.local_suite.run","repoPath":"/abs/repo","suite":"docs-and-architecture","confirm":true}'

Current Action Surface

Issue & Repo Lifecycle

• issue.ensure / issue.comment / issue.close
• issue.evidence.policy
• repo.status / repo.branch.start / repo.commit / repo.push
• workflow.finalize_fix comment/closure handoff

Issue Evidence Standard

• Use OpenCode /share links as the source of truth for issue evidence whenever a debugging or fix session exists.
• Put the share URL directly into the issue body or comment.
• Open that shared session in the browser and capture screenshots from the browser-rendered share page instead of from a local editor window.
• Always pair the share link and screenshot with exact path:line references.
• Keep the screenshot artifact in the issue timeline even if the backing session is later archived.

Workflow & Runner Control

• runners.list
• workflow.runs.list
• workflow.run.rerun
• workflow.run.cancel
• workflow.local_suite.run for predefined local CI suites when GitHub-hosted Actions are unavailable or budget-blocked

Profile & Achievement Management

• auth.check / auth.login guidance
• profile.get / profile.update (name, company, blog, location, bio, twitter, hireable)
• profile.pinned_repos.list / profile.pinned_repos.set
• repo.description.update / repo.metadata.update
• achievement.quickdraw.trigger / achievement.quickdraw.status

Auth & Onboarding

• auth.status / onboarding.status / onboarding.save

Publication Notes

• This package is Docker/Hugging Face Space ready via the repository Dockerfile.
• The standalone GitHub repo should contain the same contents as this directory root.
• Remote publication is only complete after landing, agent card, and A2A endpoint reachability are verified with the live audit.