English Français العربية

Steadfast Repository Governance

السجل الرسمي أدوات المطورين

Local-first repository governance and verification tools for AI coding agents.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Steadfast Repository Governance؟

  • Scope: compare changed paths with repository policy.
  • Evidence: check required proof files and evidence-bundle integrity.
  • Security signals: flag selected risky source patterns and workflow trust-boundary issues.
  • Documentation and code truth: detect stale command examples and package-entrypoint drift.
  • Goals and releases: validate goal dependencies and evaluate release readiness.
  • Agent support: discover skills, inspect MCP configuration, and install repo-local guidance.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package steadfast-governance
Claude Code 
claude mcp add steadfast-repository-governance -- uvx steadfast-governance==0.4.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "steadfast-repository-governance": {
            "command": "uvx",
            "args": [
                "steadfast-governance==0.4.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Steadfast
  2. Quick start
  3. The commands most people need
  4. What it checks—and what it cannot
  5. Configuration
  6. Project links
  7. Development

Steadfast

Repository checks and guardrails for coding agents.

Steadfast is a local-first CLI that helps developers and AI agents inspect repository health, enforce change scope, verify evidence, and spot documentation drift. It does not generate code, require an AI API key, or send repository contents to a Steadfast-hosted service.

Quick start

Requires Python 3.10+ and Git.

python -m pip install --upgrade steadfast-governance
cd /path/to/your/repository
steadfast onboard --agent codex
steadfast verify

Replace codex with claude, cursor, or all to configure another supported agent. Review generated files before trusting a repository. Existing files are preserved by default.

For the latest unreleased source, install from Git instead:

python -m pip install --upgrade "git+https://github.com/rllibo833-sudo/Steadfast.git"

The commands most people need

CommandPurpose
steadfast onboardSet up repository guidance and selected agent integration.
steadfast verifyRun the unified, read-only governance checks.
steadfast reportGenerate a human-readable audit report.
steadfast auditCheck changed files, evidence, contracts, and documentation drift.
steadfast discoverPrint a machine-readable capability map for tools and agents.
steadfast mcp-serverStart the read-only MCP server for compatible agents.

See the quick-start guide for a short walkthrough and the command reference for the full CLI list. For a copy-ready pull-request workflow and an adoption checklist, see Adopt in GitHub Actions.

What it checks—and what it cannot

  • Scope: compare changed paths with repository policy.
  • Evidence: check required proof files and evidence-bundle integrity.
  • Security signals: flag selected risky source patterns and workflow trust-boundary issues.
  • Documentation and code truth: detect stale command examples and package-entrypoint drift.
  • Goals and releases: validate goal dependencies and evaluate release readiness.
  • Agent support: discover skills, inspect MCP configuration, and install repo-local guidance.

These checks are guardrails, not a sandbox or proof of semantic correctness. Results depend on repository policy and configuration; review findings before treating them as release decisions. Steadfast does not silently rewrite plans or execute the configured pipeline as part of verify. Run steadfast pipeline separately only after reviewing its manifest.

Configuration

Run steadfast init to create starter governance files. Repository policy lives in .steadfast/policy.json; pipeline steps are configured in .steadfast/pipeline.json. Treat pipeline manifests as executable configuration and review their commands before running them.

Development

python -m pip install -e .
python -m unittest discover -s tests -v
steadfast docs-check
steadfast code-truth

MIT licensed. See LICENSE.

الأسئلة الشائعة

ما هو Steadfast Repository Governance؟

Local-first repository governance and verification tools for AI coding agents.

كيف أثبّت Steadfast Repository Governance؟

يعمل على جهازك. في Claude Code: claude mcp add steadfast-repository-governance -- uvx steadfast-governance==0.4.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Steadfast Repository Governance إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Steadfast Repository Governance مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Steadfast Repository Governance؟

ينشره rllibo833-sudo. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.