{"id":51251390,"url":"https://github.com/heurema/emporium","last_synced_at":"2026-06-29T07:02:07.858Z","repository":{"id":340603486,"uuid":"1166777809","full_name":"heurema/emporium","owner":"heurema","description":"Plugin marketplace for heurema tools. Craft, not conjuring.","archived":false,"fork":false,"pushed_at":"2026-05-16T12:49:15.000Z","size":118,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-16T14:45:19.981Z","etag":null,"topics":["ai-engineering","claude-code","claude-code-plugin","marketplace","plugin-marketplace"],"latest_commit_sha":null,"homepage":"https://skill7.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heurema.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T15:44:02.000Z","updated_at":"2026-05-16T12:49:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/heurema/emporium","commit_stats":null,"previous_names":["real-ai-engineering/emporium","heurema/emporium"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/heurema/emporium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heurema%2Femporium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heurema%2Femporium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heurema%2Femporium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heurema%2Femporium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heurema","download_url":"https://codeload.github.com/heurema/emporium/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heurema%2Femporium/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34916411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-engineering","claude-code","claude-code-plugin","marketplace","plugin-marketplace"],"created_at":"2026-06-29T07:02:05.827Z","updated_at":"2026-06-29T07:02:07.844Z","avatar_url":"https://github.com/heurema.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n                                   _\n  ___  ____ ___  ____  ____  _____(_)_  ______ ___\n / _ \\/ __ `__ \\/ __ \\/ __ \\/ ___/ / / / / __ `__ \\\n/  __/ / / / / / /_/ / /_/ / /  / / /_/ / / / / / /\n\\___/_/ /_/ /_/ .___/\\____/_/  /_/\\__,_/_/ /_/ /_/\n             /_/\n```\n\n**Claude Code plugin marketplace.**\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n\u003e All [heurema](https://github.com/heurema) open-source AI agent tools. Craft, not conjuring.\n\n---\n\n## Install\n\n\u003c!-- INSTALL:START — auto-synced from emporium/INSTALL_REFERENCE.md --\u003e\n```bash\nclaude plugin marketplace add heurema/emporium\n```\n\u003c!-- INSTALL:END --\u003e\n\nThen install any plugin:\n\n```bash\nclaude plugin install signum@emporium\nclaude plugin install herald@emporium\nclaude plugin install arbiter@emporium\nclaude plugin install anvil@emporium\nclaude plugin install reporter@emporium\nclaude plugin install genesis@emporium\nclaude plugin install sentinel@emporium\nclaude plugin install teams-field-guide@emporium\n```\n\n## Catalog\n\n| Plugin | Description | Repo |\n|--------|-------------|------|\n| **signum** | Risk-adaptive development pipeline with adversarial consensus code review | [signum](https://github.com/heurema/signum) |\n| **herald** | Daily curated news digest — zero API keys, fully local | [herald](https://github.com/heurema/herald) |\n| **arbiter** | Multi-AI orchestrator — Codex CLI + Gemini CLI for review, ask, implement, panel | [arbiter](https://github.com/heurema/arbiter) |\n| **anvil** | Plugin dev/test toolkit — scaffold, validate, test, review | [anvil](https://github.com/heurema/anvil) |\n| **reporter** | Report bugs, request features, and ask questions for any heurema product | [reporter](https://github.com/heurema/reporter) |\n| **sentinel** | AI workstation security audit — secrets, MCP, plugins, hooks, trust | [sentinel](https://github.com/heurema/sentinel) |\n| **genesis** | Evolve startup ideas through AI-powered natural selection with 3 agent personas | [genesis](https://github.com/heurema/genesis) |\n| **teams-field-guide** | Comprehensive guide to Claude Code multi-agent systems | [teams-field-guide](https://github.com/heurema/teams-field-guide) |\n\n## Quality Infrastructure\n\nEmporium includes tooling to enforce plugin quality before acceptance into the marketplace.\n\n### Architecture\n\n```\nlib/rubric/     12 pure check functions (no IO in core logic)\nlib/trace/      Signum artifact archival with PII/secret redaction\nscripts/        CLI tools for running checks\ntests/          pytest test suite\n```\n\n### CLI Tools\n\nAll scripts follow a common pattern: `--plugin-root DIR` (default: `~/personal/skill7/devtools/`), `--output FILE` (JSON report), exit 0 = PASS, exit 1 = FAIL.\n\n#### Ingestion Gate — 6 safety checks\n\n```bash\npython3 scripts/ingestion-gate.py --plugin herald\npython3 scripts/ingestion-gate.py --plugin signum --output /tmp/report.json\npython3 scripts/ingestion-gate.py --plugin arbiter --plugin-root /path/to/plugins\n```\n\nChecks: `hardcoded_secrets`, `dangerous_commands`, `suspicious_urls`, `shell_true`, `line_count` (300 max), `required_sections`.\n\n#### Quality Rubric — 12-point scoring\n\n```bash\npython3 scripts/quality-rubric.py --plugin=herald\npython3 scripts/quality-rubric.py --plugin=arbiter --output=/tmp/arbiter.json\n```\n\n4 structural + 4 safety + 4 quality checks. Score 0-12, gate PASS at \u003e= 9.\n\n#### Line Cap Enforcer — batch 300-line scanner\n\n```bash\npython3 scripts/enforce-line-cap.py\npython3 scripts/enforce-line-cap.py --plugin-root /path/to/plugins --output /tmp/linecap.json\n```\n\nScans all plugins, reports files exceeding 300 lines.\n\n#### Failure Modes Checker — required SKILL.md sections\n\n```bash\npython3 scripts/check-failure-modes.py\npython3 scripts/check-failure-modes.py --plugin-root /path/to/plugins\n```\n\nVerifies every plugin SKILL.md has description, usage, and known failure modes sections.\n\n#### Trace Archive — Signum artifact archival\n\n```bash\npython3 scripts/trace-archive.py --archive\npython3 scripts/trace-archive.py --prune --max-age 30\npython3 scripts/trace-archive.py --archive --prune\n```\n\nArchives `.signum/` run artifacts with automatic redaction of secrets, API keys, emails, and IP addresses. Prunes old archives by age.\n\n### Library API\n\n#### lib/rubric — Check Functions\n\n```python\nfrom lib.rubric import (\n    # Structural\n    check_skill_md,           # SKILL.md exists and non-empty\n    check_required_sections,  # description + usage + failure modes\n    check_line_count,         # no file \u003e 300 lines\n    check_skill_id_format,    # valid skill_id pattern\n\n    # Safety\n    check_hardcoded_secrets,  # no embedded credentials\n    check_no_dangerous_commands,  # no rm -rf, eval, etc.\n    check_no_suspicious_urls,     # no non-HTTPS URLs\n    check_no_shell_true,          # no shell=True in subprocess\n\n    # Quality\n    check_has_bench_tasks,    # bench/ tasks exist\n    check_has_examples,       # usage examples present\n    check_semver,             # valid semver version\n    check_metadata_complete,  # author, description, category\n)\n\n# Every function: (Path) -\u003e (bool, str)\npassed, detail = check_hardcoded_secrets(Path(\"/path/to/plugin\"))\n```\n\n#### lib/trace — Archive \u0026 Redaction\n\n```python\nfrom lib.trace import redact_text, archive_signum_run, prune_old_runs\n\n# Redact secrets/PII from text\nclean = redact_text(\"key=sk-1234567890abcdef, email: user@example.com\")\n\n# Archive .signum/ with redaction (returns Path to archived run)\narchive_path = archive_signum_run(\".signum\", \"~/.local/share/emporium/traces\")\n\n# Delete runs older than 90 days\ndeleted = prune_old_runs(\"~/.local/share/emporium/traces\", max_age_days=90)\n```\n\n### Tests\n\n```bash\ncd ~/personal/heurema/emporium\npython3 -m pytest tests/ -v\n```\n\n8 tests covering archive, redaction, pruning, file integrity, and error handling.\n\n## Adding a New Plugin\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## See Also\n\n- **[signum](https://github.com/heurema/signum)** — risk-adaptive development pipeline with adversarial code review\n- **[herald](https://github.com/heurema/herald)** — daily curated news digest plugin for Claude Code\n- **[arbiter](https://github.com/heurema/arbiter)** — multi-AI orchestrator (Codex + Gemini)\n- **[anvil](https://github.com/heurema/anvil)** — plugin dev/test toolkit\n- **[reporter](https://github.com/heurema/reporter)** — issue reporter for heurema products\n- **[genesis](https://github.com/heurema/genesis)** — evolve startup ideas with memetic algorithm and 3 AI agent personas\n- **[sentinel](https://github.com/heurema/sentinel)** — AI workstation security audit\n- **[teams-field-guide](https://github.com/heurema/teams-field-guide)** — comprehensive guide to Claude Code multi-agent teams\n- **[proofpack](https://github.com/heurema/proofpack)** — proof-carrying CI gate for AI agent changes\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheurema%2Femporium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheurema%2Femporium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheurema%2Femporium/lists"}