{"id":50118655,"url":"https://github.com/nold-ai/specfact-demo-repo","last_synced_at":"2026-05-23T17:05:28.864Z","repository":{"id":338512138,"uuid":"1158127636","full_name":"nold-ai/specfact-demo-repo","owner":"nold-ai","description":"Demo repository to show specfact cli capabilities ","archived":false,"fork":false,"pushed_at":"2026-02-14T23:21:42.000Z","size":125,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-15T05:24:32.674Z","etag":null,"topics":["backlog-sync","contract-enforcement","demo","devops","python","sdd","spec-driven-development","tdd","validation"],"latest_commit_sha":null,"homepage":"https://docs.specfact.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nold-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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":"CLA.md"}},"created_at":"2026-02-14T20:57:05.000Z","updated_at":"2026-02-14T23:21:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nold-ai/specfact-demo-repo","commit_stats":null,"previous_names":["nold-ai/specfact-demo-repo"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nold-ai/specfact-demo-repo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nold-ai%2Fspecfact-demo-repo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nold-ai%2Fspecfact-demo-repo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nold-ai%2Fspecfact-demo-repo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nold-ai%2Fspecfact-demo-repo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nold-ai","download_url":"https://codeload.github.com/nold-ai/specfact-demo-repo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nold-ai%2Fspecfact-demo-repo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33404364,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["backlog-sync","contract-enforcement","demo","devops","python","sdd","spec-driven-development","tdd","validation"],"created_at":"2026-05-23T17:05:26.210Z","updated_at":"2026-05-23T17:05:28.851Z","avatar_url":"https://github.com/nold-ai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SpecFact Demo Repo\n\nA one-repo proof of the core SpecFact promise:\n\n\u003e point the real `specfact-cli` at existing code, generate machine-readable specs,\n\u003e and run enforceable checks that can block regressions.\n\nThis demo is intentionally small and reproducible.\n\nSee `docs/real-cli-vs-demo.md` for scope boundaries and official docs for deeper workflows:\n\n- https://docs.specfact.io/use-cases/\n- https://docs.specfact.io/getting-started/installation/\n- https://docs.specfact.io/guides/\n\n## 90-Second Proof\n\nRun the real CLI smoke path:\n\n```bash\nmake real-smoke\n```\n\nEquivalent direct commands:\n\n```bash\nspecfact-cli --version\nspecfact-cli import from-code demo-repo --repo . --shadow-only --force\nspecfact-cli enforce stage --preset minimal\n```\n\nExpected indicators:\n\n- `SpecFact CLI version ...`\n- `Import complete!`\n- `Enforcement mode set to minimal`\n\nSample output logs:\n\n- `results/real-smoke.log`\n- `results/test.log`\n\n## What Success Looks Like\n\nAfter a successful run, you should have:\n\n- a generated bundle under `.specfact/projects/demo-repo/`\n- enforcement preset configured via `enforce stage`\n- reproducible logs you can inspect or attach to a PR\n\n## Read Output Fast\n\nUse this quick interpretation guide for new users:\n\n- `Import complete!` means the codebase was parsed and bundled successfully.\n- `Enforcement mode set ...` means gate policy is configured for this bundle.\n- `BLOCK` in an enforcement/repro summary means at least one contract/policy violation failed the gate.\n- `ALLOW` means configured checks passed for the evaluated scope.\n\n## Demo Lanes\n\n### 1) Brownfield smoke lane\n\n```bash\nmake real-smoke\n```\n\nThis is the fastest onboarding path and should complete in about one minute on a typical laptop.\n\n### 2) Legacy sidecar validation lane\n\n```bash\nmake sidecar-demo\n```\n\nThis imports and validates the deliberately buggy sample in `examples/buggy-sidecar/`.\n\nExpected logs:\n\n- `results/sidecar-import.log`\n- `results/sidecar-repro.log`\n\n### 3) Backlog sync lane (GitHub adapter)\n\n```bash\nmake real-backlog-sync REPO_OWNER=nold-ai REPO_NAME=specfact-demo-repo BACKLOG_IDS=2\n```\n\nThis uses `specfact-cli sync bridge` in bidirectional mode and writes tracking artifacts under:\n\n- `openspec/changes/`\n- `.specfact/projects/\u003cbundle\u003e/change_tracking/`\n\nPrerequisite: authenticated GitHub access (`gh auth login` or `specfact-cli auth github`).\n\n## Install and Prerequisites\n\nInstall the real CLI:\n\n```bash\npip install specfact-cli\nspecfact-cli --version\n```\n\nFor backlog sync demos, ensure:\n\n- GitHub authentication is active\n- you can read/write issues in the target repository\n\n## Core Commands\n\n```bash\nmake real-version\nmake real-import\nmake real-enforce\nmake real-repro\nmake real-backlog-sync REPO_OWNER=\u003cowner\u003e REPO_NAME=\u003crepo\u003e BACKLOG_IDS=\u003cid-list\u003e\nmake sidecar-demo\nmake real-smoke\nmake test\n```\n\n## Visual Demo\n\nRendered terminal snapshot:\n\n- `docs/assets/demo-output.svg`\n\nCapture instructions:\n\n- `docs/assets/README.md`\n\n## Ways You Can Contribute\n\n- Improve demo scenarios and command ergonomics\n- Improve backlog sync examples for real-world repos\n- Add contributor-safe fixtures that demonstrate sync conflict handling\n- Improve CI reliability and run time for demo verification\n\nRecommended labels:\n\n- `good first issue`\n- `help wanted`\n- `demo-scenario`\n- `docs`\n\n## Repo Layout\n\n```text\nexamples/                    # runnable demo examples\nopenspec/                    # OpenSpec change artifacts for dogfooding examples\nrepro/                       # reproducibility runners\nevidence/                    # evidence manifest and threat model\nresults/                     # sample run outputs\ndocs/                        # supporting demo docs\ntests/                       # local tests for demo harness modules\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnold-ai%2Fspecfact-demo-repo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnold-ai%2Fspecfact-demo-repo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnold-ai%2Fspecfact-demo-repo/lists"}