Public recordModerate
Software health reportschema 0.27.0 · metrics 1.13.0 · 2026-07-27 22:18 UTC
CognitiveThoughtEngine / constitutional-agent-governance
The WHY layer for AI agents: six constitutional gates + 12 hard constraints, plus cross-session risk composition — catches agents that pass every individual gate but accumulate risk across a sequence (stateless engines can't). pip install constitutional-agent
CognitiveThoughtEngine/constitutional-agent-governance holds a health index of 61 out of 100, placing it in the Moderate band. It scores highest on Engineering Quality (81/100) and lowest on Community & Adoption (35/100). It was last updated 8 days ago. A single contributor accounts for most of its recent work.
61
overall / 100Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
61
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Ownership
CognitiveThoughtEngineOrganization
1 follower6 public repossince Apr 2026
This repository is backed by an organization — shared, accountable stewardship that can outlive any single maintainer.
Package ecosystems
| Registry | Package | Version | Downloads / mo | Versions | Last publish | Tags |
|---|---|---|---|---|---|---|
| PyPI | constitutional-agent | 0.7.0 | 331 | 12 | 8 days ago | aiagentsgovernanceconstitutionalllmautonomy |
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
72
Development activity
60Moderate
How it's scored
| 28.8/36 | Push recency — last push 8 days ago |
| 4.8/36 | Commit cadence — 7/52 weeks with commits |
| 16.2/18 | Commit volume — 62 commits in the last year |
| 10/10 | OpenSSF Scorecard: Maintained — 16 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
Inputs used
| commits_last_year | 62 |
| human_commit_share | 1 |
| days_since_last_push | 8 |
| active_weeks_last_year | 7 |
Release discipline
90Excellent
How it's scored
| 27/27 | Ships releases — 12 releases published |
| 36/36 | Release recency — latest release 8 days ago |
| 27/27 | Release cadence — a release every ~11.2 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases. |
Inputs used
| releases_count | 12 |
| latest_release_tag | v0.7.0 |
| releases_from_tags | no |
| days_since_latest_release | 8 |
| mean_days_between_releases | 11.2 |
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
35
Popularity & adoption
1Critical
How it's scored
| 0/60 | Stars — 0 stars |
| 0/25 | Forks — 0 forks |
| 0/15 | Watchers — 0 watchers |
Inputs used
| forks | 0 |
| stars | 0 |
| watchers | 0 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Community health
70Good
How it's scored
| 22.5/22.5 | README |
| 22.5/22.5 | License — recognized license (MIT) |
| 18/18 | CONTRIBUTING guide |
| 0/13.5 | Code of conduct |
| 0/7.2 | Issue template |
| 0/6.3 | PR template |
Inputs used
| has_readme | yes |
| has_license | yes |
| has_contributing | yes |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | no |
Ecosystem adoption (downloads)
42At risk
How it's scored
| 33.6/80 | Monthly downloads — 331 downloads/month across pypi |
| 0/20 | Registry dependents — not reported by this ecosystem |
Inputs used
| packages | constitutional-agent |
| dependents | — |
| ecosystems | pypi |
| total_downloads | — |
| monthly_downloads | 331 |
Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
54
Maintainer resilience (bus factor)
10Critical
How it's scored
| 9/54 | Bus factor — 1 contributor(s) cover half of all commits |
| 0/22.5 | Commit distribution — top contributor authored 100% of commits |
| 1.4/13.5 | Contributor breadth — 1 contributors |
| 0/10 | OpenSSF Scorecard: Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 1 |
| top_contributor_share | 1 |
Issue & PR responsiveness
85Excellent
How it's scored
| 46.8/46.8 | Issue resolution — 100% of issues closed |
| 38.2/38.3 | PR acceptance — 7/7 decided PRs merged |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 0/21 approved changesets -- score normalized to 0 |
Inputs used
| merged_prs | 7 |
| open_issues | 0 |
| closed_issues | 1 |
| issue_closed_ratio | 1 |
| closed_unmerged_prs | 0 |
Ownership & stewardship
39At risk
How it's scored
| 30/30 | Ownership backing — organization-owned |
| 0/20 | Verified domain |
| 2.2/25 | Owner reach — 1 followers of CognitiveThoughtEngine |
| 6.8/25 | Track record — 6 public repos, account ~0 yr old |
Inputs used
| followers | 1 |
| owner_type | Organization |
| is_verified | — |
| owner_login | CognitiveThoughtEngine |
| public_repos | 6 |
| account_age_days | 110 |
Package maintenance
100Excellent
How it's scored
| 25/25 | Published & resolvable — 1 package(s) on pypi |
| 35/35 | Publish recency — latest publish 8 days ago |
| 20/20 | Version history — 12 published versions |
| 20/20 | Not deprecated — active, not deprecated or yanked |
Inputs used
| packages | constitutional-agent |
| ecosystems | pypi |
| any_deprecated | no |
| min_days_since_publish | 8 |
Engineering Quality
Are baseline engineering and documentation practices in place?
81
Engineering practices
68Moderate
How it's scored
| 24/24 | CI workflows — 3 workflow(s) |
| 24/24 | Tests present |
| 0/16 | Linter config |
| 0/9.6 | Pre-commit hooks |
| 0/6.4 | .editorconfig |
| 20/20 | OpenSSF Scorecard: CI-Tests — 6 out of 6 merged PRs checked by a CI test -- score normalized to 10 |
Inputs used
| has_ci | yes |
| has_tests | yes |
| has_editorconfig | no |
| has_linter_config | no |
| has_precommit_config | no |
Documentation
100Excellent
How it's scored
| 30/30 | README |
| 25/25 | Documentation directory |
| 15/15 | Documentation / homepage site — https://pypi.org/project/constitutional-agent/ |
| 10/10 | Repository description |
| 10/10 | Topics — 10 topics |
| 10/10 | Wiki |
Inputs used
| topics | agent-governance, ai-governance, autonomous-agents, constitutional-ai, llm-agents, python, agentic-ai, ai-safety, eu-ai-act, risk-management |
| has_wiki | yes |
| homepage | https://pypi.org/project/constitutional-agent/ |
| has_readme | yes |
| has_docs_dir | yes |
| has_description | yes |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
58
Security posture
47At risk
How it's scored
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — branch protection not enabled on development/release branches |
| 2.5/2.5 | CI-Tests — 6 out of 6 merged PRs checked by a CI test -- score normalized to 10 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 0/21 approved changesets -- score normalized to 0 |
| 0/2.5 | Contributors — project has 0 contributing companies or organizations -- score normalized to 0 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | License — license file detected |
| 7.5/7.5 | Maintained — 16 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 5/5 | Packaging — packaging workflow detected |
| 2/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 4 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — Project has not signed or included provenance with any releases. |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 7.5/7.5 | Vulnerabilities — 0 existing vulnerabilities detected |
Inputs used
| source | openssf_scorecard |
| checks_evaluated | 18 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 0 |
| scorecard_aggregate | 4.7 |
Dependency advisories
100Excellent
How it's scored
| 35/35 | Direct dependencies free of known advisories — no direct dependency carries a known advisory |
| 25/25 | Indirect dependencies free of known advisories — no indirect dependency carries a known advisory |
| 0/40 | No advisories left outstanding — no advisory carries a publication date |
Inputs used
| source | osv |
| advisories | 0 |
| affected_packages | 0 |
| assessed_packages | 1 |
| unassessed_packages | 0 |
| affected_by_severity | none |
| direct_affected_packages | 0 |
Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:constitutional-agent@0.7.0 runtime dependency closure — what installing the published package pulls in — 1 packages. Reachability is not analyzed.
AI Readiness
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
40
Agent context & guidance
40At risk
How it's scored
| 0/45 | Agent instructions — no CLAUDE.md / AGENTS.md / editor rules |
| 0/15 | Machine-readable docs (llms.txt) |
| 40/40 | Legible commit history — 58 of 62 human commits state their intent (structured subject or explanatory body) |
Inputs used
| has_llms_txt | no |
| legible_history_share | 0.935 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
How it's scored
| 0/18 | One-command bootstrap |
| 22/22 | Automated tests |
| 0/11 | Lint / format config |
| 0/11 | Static type checking |
| 0/10 | Reproducible environment |
| 10/10 | Demonstrated agent practice — 27 of the last 62 commits agent-authored or agent-credited |
| 0/8 | Automated maintenance — no automated dependency updates observed |
| 4/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 4 |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | — |
| has_dockerfile | no |
| typed_language | no |
| bootstrap_files | — |
| has_devcontainer | no |
| has_linter_config | no |
| typecheck_configs | — |
| agent_commit_share | 0.435 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
Code legibility for models
52Moderate
How it's scored
| 0/45 | Type-checkable code — Python without a type-check config |
| 52.4/55 | Manageable file sizes — 1/21 source files over 60KB |
Inputs used
| primary_language | Python |
| largest_source_bytes | 63,584 |
| source_files_sampled | 21 |
| oversized_source_files | 1 |
Machine-readable interfaces
40At risk
How it's scored
| 0/40 | API schema (OpenAPI/GraphQL/proto) |
| 0/20 | MCP server |
| 40/40 | Runnable examples — examples |
Inputs used
| example_dirs | examples |
| has_mcp_signal | no |
| api_schema_files | — |
Key facts
0GitHub stars
1contributors
62commits, last 12 months
8days since last push
12releases
1bus factor
0open issues
PyPIpackage ecosystems
Data collection warnings
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
More detail
OpenSSF Scorecard 4.7 / 10
4.7aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).
| 10 | Binary-Artifacts | no binaries found in the repo |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| 10 | CI-Tests | 6 out of 6 merged PRs checked by a CI test -- score normalized to 10 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 0/21 approved changesets -- score normalized to 0 |
| 0 | Contributors | project has 0 contributing companies or organizations -- score normalized to 0 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 16 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 10 | Packaging | packaging workflow detected |
| 4 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 4 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 10 | Security-Policy | security policy file detected |
| 0 | Signed-Releases | Project has not signed or included provenance with any releases. |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
Direct dependencies 1
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| PyPI | pyyaml | >=6.0,<7 | pyproject.toml |
All dependencies not collected
The resolved dependency set could not be collected for this report: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
Dependency advisories 0
Installing pypi:constitutional-agent@0.7.0 pulls in 1 packages, direct and transitive: 0 carry known advisories, of which 0 are direct dependencies.
No known advisories affect the assessed dependencies.
An advisory means the version recorded in the dependency graph falls inside an advisory’s affected range. Reachability is not analysed, and the graph includes development and test pins — a finding may concern tooling rather than shipped software.
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"agent-governance",
"ai-governance",
"autonomous-agents",
"constitutional-ai",
"llm-agents",
"python",
"agentic-ai",
"ai-safety",
"eu-ai-act",
"risk-management"
],
"is_fork": false,
"size_kb": 429,
"has_wiki": true,
"homepage": "https://pypi.org/project/constitutional-agent/",
"languages": {
"Python": 344487
},
"pushed_at": "2026-07-19T17:53:42Z",
"created_at": "2026-04-08T22:18:49Z",
"owner_type": "Organization",
"updated_at": "2026-07-19T17:40:26Z",
"description": "The WHY layer for AI agents: six constitutional gates + 12 hard constraints, plus cross-session risk composition — catches agents that pass every individual gate but accumulate risk across a sequence (stateless engines can't). pip install constitutional-agent",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "master",
"license_spdx_raw": "MIT",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": null,
"name": null,
"type": "Organization",
"login": "CognitiveThoughtEngine",
"company": null,
"location": null,
"followers": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/274643667?v=4",
"created_at": "2026-04-08T22:08:30Z",
"is_verified": null,
"public_repos": 6,
"account_age_days": 110
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v0.7.0",
"kind": "minor",
"published_at": "2026-07-19T18:08:54Z"
},
{
"tag": "v0.6.0",
"kind": "minor",
"published_at": "2026-07-17T13:05:48Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2026-04-17T14:58:40Z"
},
{
"tag": "v0.4.1",
"kind": "patch",
"published_at": "2026-04-12T11:41:17Z"
},
{
"tag": "v0.4.0-beta3",
"kind": "prerelease",
"published_at": "2026-04-10T12:10:59Z"
},
{
"tag": "v0.4.0-beta2",
"kind": "prerelease",
"published_at": "2026-04-10T12:02:32Z"
},
{
"tag": "v0.4.0-beta",
"kind": "prerelease",
"published_at": "2026-04-09T23:52:56Z"
},
{
"tag": "v0.3.2",
"kind": "patch",
"published_at": "2026-04-09T23:36:14Z"
},
{
"tag": "v0.3.1",
"kind": "patch",
"published_at": "2026-04-09T23:21:37Z"
},
{
"tag": "v0.3.0",
"kind": "minor",
"published_at": "2026-04-09T22:58:00Z"
},
{
"tag": "v0.2.0",
"kind": "minor",
"published_at": "2026-04-08T23:52:08Z"
},
{
"tag": "v0.1.0",
"kind": "minor",
"published_at": "2026-04-08T22:52:44Z"
}
],
"recent_commits": [
{
"oid": "6adf69d0a0b7bcc3e552ed2e16bb7db2883aea8e",
"body": "Release-prep v0.7.0: set release date + finalize notes (review only — do not tag/publish)",
"is_bot": false,
"headline": "Merge pull request #28 from CognitiveThoughtEngine/release/v0.7.0-prep",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T17:40:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6de7a4e2d6b4806e977d468e33787bf7e769ba22",
"body": "… to the release\n\nMakes the finalized release-note claim ('the SHA-256 checksums are published with\nthe release') operationally true: release.yml uploads SHA256SUMS.txt and the wheel/\nsdist only as workflow artifacts, which are NOT auto-attached to the public release.\nStep 7 now requires downloading the release-checksums + release-dist artifacts from\nthe successful tag run and attaching them (plus recording the tag commit + run ID).",
"is_bot": false,
"headline": "release-prep: runbook step 7 — attach checksums + validated artifacts…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T17:32:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "39d4cedb71426ca5a93584413f0b294e56b2d13a",
"body": "Release-state changes only (narrow scope):\n- CHANGELOG.md: [0.7.0] UNRELEASED -> 2026-07-19.\n- Rename docs/release/v0.7.0-release-notes-DRAFT.md -> v0.7.0-release-notes.md;\n remove the DRAFT banner; finalize the install/verify wording.\n- v0.6 correction notice stays DRAFT (applied only after v0.7 is public + verified).\n\nNo code changes. Do NOT tag/publish from this PR — separate authorization gate.",
"is_bot": false,
"headline": "release-prep v0.7.0: set release date + finalize release notes",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T17:12:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "11f7c4b657490239b1ecd2d84ee785435e9028e5",
"body": "…sure\n\nv0.7.0 release-closure: doc accuracy, Bandit gate, reproducible package validation (review only — do not tag/publish)",
"is_bot": false,
"headline": "Merge pull request #27 from CognitiveThoughtEngine/release/v0.7.0-clo…",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T16:06:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "539176c61c6db6c4fee00bb9517f4a1fbf993b86",
"body": "…tive credential checks\n\n- Pin all GitHub Actions in release.yml + release-validation.yml to full commit\n SHAs (with version comments): checkout v4.3.1, setup-python v5.6.0,\n upload-artifact v4.6.2, download-artifact v4.3.0 (the last runs in the\n id-token:write publish job). Publish action alread\n[…]\nercase positive tests (39 package-check cases total).\n\nReview-only. NOT for tag/publish. NOTE: the pypi environment still has no\nrequired reviewers — do not push a v0.7.0 tag until that is configured.",
"is_bot": false,
"headline": "release-closure round 3 hardening: pin actions to SHAs + case-insensi…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T15:49:49Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "48e0c08154e36449bceadc0b85f597191543c80b",
"body": "…ucible release\n\nSingle clean commit off master (supersedes the prior branch history, which briefly\ntracked a local .venv-rel virtualenv). Full contents:\n\nDoc accuracy & bounded claims\n- CHANGELOG: precise key-name secret-redaction boundary (not \"never stored\");\n IdentityVerifier cannot time out a \n[…]\n-matrix ref removed),\n RELEASE_RUNBOOK.md (reviewed release-prep PR sets date/renames notes; verify pypi\n reviewers + Trusted Publishing before tagging).\n\nReview-only. NOT for tag/publish/promotion.",
"is_bot": false,
"headline": "v0.7.0 release-closure: accuracy, security gate, deterministic reprod…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T15:34:13Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7ee4885596c9fe991f54128b7476a5dccb3ff147",
"body": "…ed-governance\n\nv0.7.0: enforce amendment authority + separation of duties; FRIA-support crosswalk; doc reconciliation",
"is_bot": false,
"headline": "Merge pull request #26 from CognitiveThoughtEngine/feat/v0.7.0-enforc…",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-07-19T01:44:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5d4103103cf3fd5496baabb1d5c5e031a1759b9a",
"body": "…esent_and_reviewed)\n\nThe example return key was corrected but the following comment still referenced the old\n'complete' key. Now matches fria.py's crosswalk_fields_present_and_reviewed. Doc-only.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "README: fix stale FRIA key reference (complete -> crosswalk_fields_pr…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-18T23:04:51Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "806eaaa3ca7aa614b5b9eedb18107dd070fec5b9",
"body": "…curacy\n\n- _reconstruct_version() now requires a POSITIVE, NON-BOOLEAN integer for a RATIFIED\n record's constitution_version (int() coercion removed). Rejects True/float/None/str and\n <=0 — any of which could reissue an existing version. Parameterized test over\n [True, 1.5, 0, -1, None, 'not-an-i\n[…]\nd before persistence'\n (key-name detection, not a guarantee about secrets under generic keys).\n\nLocal: 253 tests pass, ruff clean, mypy clean.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "PR #26 re-review round 2: stricter version validation + doc/metric ac…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-18T22:31:25Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "364b0131a58920acb9d0c19a2d9d04fe6e869481",
"body": "…reconstruction\n\nTwo integrity corrections from the re-review at 5f5bd9dd:\n\n1. Rejection persistence is now atomic. The rejection path set status=REJECTED before\n _finalize_amendment() wrote the durable record; a store-write failure left the proposal\n terminal in memory with no decision record. \n[…]\nitignore\nalready excludes *.egg-info/, dist/, build/, sdist/ — nothing to remove.\n\nLocal: 247 tests pass (244 + 3 new), ruff clean, mypy clean.\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "PR #26 re-review: atomic rejection persistence + fail-closed version …",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-18T22:19:35Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "5f5bd9dd8e626e58d91ed8e579d32eb015f3f6c1",
"body": "Secret-scrub of stored amendment changes (redact_secrets), atomic ledger\n(rollback on apply/store-write failure), monotonic version restore across\nrestart, terminal REJECTED status (no replay), registry id validation\n(empty/whitespace + canonical collision), callback-timeout wording +\nbounded_verifi\n[…]\name (crosswalk_fields_present_and_reviewed) + Article27Applicability,\nand reference-defaults wording. +21 regression tests (244 total passing).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "v0.7.0: apply pre-merge review corrections (10 items)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-18T20:25:18Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "5b365e747404e47e8710cced5eb0c14f89e1cb8f",
"body": "…t crosswalk; doc reconciliation (v0.7.0)\n\nTurns the governance thesis from recorded into enforced.\n\nA — Amendment protocol enforcement (new authority.py + constitution.py):\n- AuthorityRegistry (PROPOSER < RATIFIER < CONSTITUTIONAL_AUTHORITY), opaque\n canonical principal ids, rejects a zero-root bo\n[…]\nt_amendment_authority.py, test_fria_article27.py); 223 pass.\n Version bump 0.6.0 -> 0.7.0. BREAKING: ratification is enforced (see CHANGELOG).\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: enforce amendment authority + separation of duties; FRIA-suppor…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-18T17:57:21Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "c188447d3dcecc333c14d61ad5fbd6140288658b",
"body": "The six gates are memoryless — every vendor-neutral engine shipped in H1 2026\n(MS ACS, Galileo, Runlayer, NVIDIA OpenShell) is stateless the same way, and\nshares the blind spot: an agent can pass every individual gate yet be dangerous\nover a sequence.\n\nAdds the stateful layer:\n- composition module: \n[…]\nith it as the differentiator; ROADMAP v0.6.0; CHANGELOG.\n\n24 new tests (174 total), mypy strict + ruff clean. Backward compatible.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: cross-session risk composition (v0.6.0) (#25)",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-07-17T13:05:08Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "ea48c96c774eaa99c5e5fa9e3a24abdf71fe6712",
"body": "…x DOI labels\n\n- Opener now leads with the decision-governance category and the WHO/HOW/WHY\n question, with an honest 'cross-session composition is roadmap, not shipped' note\n- Add the measured AgentCore Payments finding as first-screen proof\n- Fix preprint mislabel (19343034 is 'Beyond Identity Governance', not 'Harness Design')\n- Add CSG (six-gate model) + 'Authorized but Refused' DOIs; correct preprint count to eight\n\nCo-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "README: lead with decision-governance/WHY-layer + AgentCore proof; fi…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-07-12T20:52:38Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "cdada9957236e13e8c709bd55dc51968bff262d1",
"body": "…orcement toolkits (#24)",
"is_bot": false,
"headline": "docs: position constitutional-agent as the WHY layer vs HOW-layer enf…",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-06-17T13:27:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "947e81803bc6806921b36fd75910e5bbe23f8bf6",
"body": "…tern (#23)\n\n* docs(examples): add hrao_e_production_evidence — 19-retraction-ledger pattern\n\nDocuments the failure-mode evidence behind the README's \"98 days in\nHRAO-E, 52 agents, 1,929 evaluations\" claim. Maps 4 representative\nincidents (R-019 sub-agent overstate, R-018 comfort-claim of\nexhausted \n[…]\n counterfactual prevented count not measured.\n\nCo-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(examples): hrao_e_production_evidence — 19-retraction-ledger pat…",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-05-24T19:11:33Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "ebeb38493606dc42a50f2324bc1859401ed69a99",
"body": null,
"is_bot": false,
"headline": "docs: add CITATION.cff for academic citation rendering",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-04-25T17:29:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f22e9cbf44d1dbbb5bdedc7ae58448ef358ba127",
"body": null,
"is_bot": false,
"headline": "docs: add Citation section with ORCID and Zenodo DOIs",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-04-25T17:29:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2dac060e480af5c6a5fb20b870171231d82b2e0d",
"body": "…ured on PyPI)",
"is_bot": false,
"headline": "fix: restore PYPI_API_TOKEN auth in publish workflow (OIDC not config…",
"author_name": "Michael Saleme",
"author_login": null,
"committed_at": "2026-04-17T14:58:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8e7feb8cfea812c4788c361f3f2f6118decab27a",
"body": "…0.5.0\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: update all counts and versions, add FRIA to changelog, bump to v…",
"author_name": "Michael Saleme",
"author_login": null,
"committed_at": "2026-04-17T14:50:40Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "82e02e3718228d04cee3950247b4779a53089c91",
"body": "__main__.py is a CLI entry point with 0% coverage, dropping the total\nbelow the 95% fail-under gate. Exclude it via [tool.coverage.run] omit.\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: exclude CLI entry point from coverage threshold",
"author_name": "Michael Saleme",
"author_login": null,
"committed_at": "2026-04-12T11:40:33Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "28da9d20251c6c63951b2e293fc79bf3cb4cb305",
"body": "Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: resolve ruff E702 lint errors in __main__.py",
"author_name": "Michael Saleme",
"author_login": null,
"committed_at": "2026-04-12T11:39:03Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "cd485addf38eba15d4a911e7c3429563c2080350",
"body": "Adds __main__.py with colorized gate output, console_scripts entry,\nand bumps version to 0.4.1.\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: add CLI demo via python -m constitutional_agent",
"author_name": "Michael Saleme",
"author_login": null,
"committed_at": "2026-04-12T11:36:37Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "fc872a180b37636447e3ea7251d4de604c9982c6",
"body": "- Add HRAO-E production stats (98 days, 52 agents) right after tagline\n- Add PyPI version mismatch note (badge says 0.4.0, published is 0.3.2)\n- Move working Quick Start above \"Who This Is For\" with gate-grouped comments\n- Snippet evaluates to RUN, not FREEZE\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "readme: surface Quick Start and social proof above the fold",
"author_name": "Michael Saleme",
"author_login": null,
"committed_at": "2026-04-12T11:03:41Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "a4be956a202f8763bf1326dc810a263eb779f547",
"body": "Replace 'missing from every open-source governance toolkit until now'\nwith 'complements identity and policy tools — does not replace them.'\nAligns with enterprise credibility guidance.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "README: soften vendor framing to 'complements' (reviewer feedback)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-11T16:06:34Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "ab7a51a6a54c6162ba3e63bde4fb5601ca750c01",
"body": "Three ~40-50 line working examples showing how to wrap constitutional\nevaluation around node execution (LangGraph), agent step hooks (CrewAI),\nand on_tool_call lifecycle hooks (OpenAI Agents SDK). Each doc includes\ngate relevance table and links to FRIA/SECURITY docs.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: add LangGraph/CrewAI/OpenAI Agents SDK integration quickstarts",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-11T14:37:58Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "f69e657d44fa1bb575343e66d3d97f252f6fb8a1",
"body": "Production-validated stable release. CGST self-assessment 63/100.\nNo breaking changes from v0.4.0b3. Updated version in pyproject.toml,\n__init__.py, README badge, ROADMAP, and CHANGELOG.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: promote v0.4.0b3 to v0.4.0 stable",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-11T14:37:54Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9489dd93b6e37ac68b43a2f439314254c9c94d6d",
"body": "…rary), add CGST 63/100 self-assessment link\n\nDistinguishes portable library extract (HC-1-12, 77 tests) from HRAO-E production\n(HC-1-17, 1,929 tests). Adds self-assessment credibility section.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "README: fix production vs library stats — 77 tests/12 HC/6 gates (lib…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-11T14:28:32Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "1ab3c2f2757bc8e3b5c30e55a15113920ce5c03c",
"body": null,
"is_bot": false,
"headline": "docs: add WHO/HOW/WHY architecture diagram to README",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:57:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9e6cd078839c6b2341823ea1cf479fbcc0d12d97",
"body": "…se, softer positioning",
"is_bot": false,
"headline": "docs: rewrite README — who this is for, complement framing, when to u…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:47:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c36bd438a211877291fd2cd4b04a5f7b4c0df422",
"body": null,
"is_bot": false,
"headline": "docs: static version badge v0.4.0b3 (shields.io cache workaround)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:27:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bde0cc3e69b9434fc99ac6b63e1cb99d5c514d0f",
"body": null,
"is_bot": false,
"headline": "docs: simplify install — v0.4.0b3 is now Latest, no --pre needed",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:25:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "370c7e6fa21b96383a6c4d80dd17e21aed1f43e8",
"body": null,
"is_bot": false,
"headline": "docs: fix PyPI badge (shields.io standard) + release marked Latest",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:24:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa428d1f5ab21a7baccf31a77e727088f307656f",
"body": "…lease badge",
"is_bot": false,
"headline": "docs: README + ROADMAP — v0.4.0b3, beta install, FRIA section, pre-re…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:20:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0f564ec31c0978d6483ca32b1d43f1f6764aa838",
"body": null,
"is_bot": false,
"headline": "docs: update ROADMAP for v0.4.0b3 — add fria_evidence, 160 tests",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:14:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a8f576b488f534198cdb662f93738fec99e5cdd2",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 0.4.0b3",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:10:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b4cf46ebe8eb79f535e8177028620fcbacded7dd",
"body": null,
"is_bot": false,
"headline": "fix: mypy strict — add Optional import + type-arg fixes in fria.py",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:09:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8a6df4c4b9ce945c2f695bf892b4ae63b19ef842",
"body": "- Remove duplicate Constitution.fria_evidence() that shadowed PR #13 merge\n- Keep PR's fria.py module (FRIAEvidence, generate_fria_evidence, fria_summary, fria_narrative)\n- Rewrite TestFriaEvidence in test_constitution.py to match fria.py API\n- Auto-fix two ruff F401 (unused Optional in fria.py, unused FRIAEvidence in test_fria.py)\n- 160 tests passing, ruff clean, mypy strict",
"is_bot": false,
"headline": "fix: resolve duplicate fria_evidence + ruff clean (160 tests passing)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:08:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4e99e845d94d53424882a8a9593ca23720cf24ac",
"body": null,
"is_bot": false,
"headline": "fix: remove unused Constitution import in TestFriaEvidence (ruff F401)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:04:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5183fbda05268d66f4ed1f10ec5b421588ddce13",
"body": "FRIA (Fundamental Rights Impact Assessment) evidence generation from\nexisting governance gate and hard constraint evaluations:\n\n- src/constitutional_agent/fria.py: 6-category FRIA mapping\n (safety, non-discrimination, privacy, human oversight,\n transparency, accountability)\n- Constitution.fria_evi\n[…]\n,\nAutonomyGate → human oversight, GovernanceGate → transparency/accountability.\n\nCo-authored-by: Michael Saleme <mikes@example.com>\nCo-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add FRIA gate output for EU AI Act Article 27 (#12) (#13)",
"author_name": "Michael 'Mike' K. Saleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:04:32Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "d838ffa5074e136becdb1bbb6425423ca4cb0eee",
"body": null,
"is_bot": false,
"headline": "fix: remove unused Any import + fix test file encoding (ruff E902)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T12:03:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "62680c9bafb85b1e59c9d0f308c9e8fcd0e5fdde",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 0.4.0b2 (includes fria_evidence, issue #12)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T11:54:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "913fb0a4a37c3b414a447428363f3cd1b533e9db",
"body": "Maps six constitutional gate results to the six FRIA categories required\nby EU AI Act Article 27 for high-risk AI systems:\n\n Safety & robustness → RiskGate + HC-1/7 violation status\n Non-discrimination → EpistemicGate\n Human oversight → AutonomyGate + HC-12 violation status\n \n[…]\nEvidence cover no-result, all-covered,\nHOLD→PARTIAL, FAIL→GAP, HC evidence lines, gate_source presence, and\nISO-8601 timestamp format.\n\n152 tests passing, 97% coverage (--cov-fail-under=95 satisfied).",
"is_bot": false,
"headline": "feat: fria_evidence() — EU AI Act Article 27 FRIA output (issue #12)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-10T11:53:44Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e8d35d79486d40212cb03c95cd89148807899131",
"body": "v0.4.0 (Persistence & Observability), v0.5.0 (Multi-Agent Coalition),\nv0.6.0 (Adaptive Thresholds), v1.0.0 criteria, Not Planned section,\nversioning policy.",
"is_bot": false,
"headline": "docs: replace old strategic roadmap with versioned product roadmap",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T23:50:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "84a51a8c669507d597e9558bbc76a5338713edea",
"body": "- Add tests for lt, lte, gt YAML HC operators with boundary checks\n (both violation and non-violation side of each boundary)\n- Add test for negative positive-metric warning (runway_months: -1.0)\n- Tighten _KNOWN_GATE_METRICS test to exact equality — catches stale\n entries as well as missing additi\n[…]\nDMAP.md: v0.4.0 (Persistence), v0.5.0 (Multi-Agent Coalition),\n v0.6.0 (Adaptive Thresholds), v1.0.0 criteria, versioning policy\n- Bump version to 0.4.0b1\n- 141 tests, 97% coverage, mypy strict clean",
"is_bot": false,
"headline": "v0.4.0b1: YAML HC operators tested, coverage floor, ROADMAP",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T23:44:24Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "357e7b92a05452852229ec76770ad778ceb96494",
"body": "- Fix amendment.status not set before config merge succeeds (status only\n set after successful ratify_amendment, so rollback leaves PENDING)\n- Add monkeypatch rollback test exercising actual error path\n- Add 26 gate coverage tests for all FAIL/HOLD branches across all six\n gates (fixed metric key \n[…]\nltv_cac_ratio)\n- Add _KNOWN_GATE_METRICS frozenset with sync comment; strict mode now\n checks for overlap with known metrics (not empty context)\n- Add Python 3.13 to CI matrix\n- Bump version to 0.3.2",
"is_bot": false,
"headline": "v0.3.2: rollback correctness, coverage tests, Python 3.13 CI",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T23:35:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "3e8c75bd925c1ad1ad3a1c1a067c4a783dc944cd",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 0.3.1",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T23:21:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2ebf60cd9ae8337cfa7ed6aa652e604c38c660ee",
"body": "…ack, schema\n\n- schema.py: all ConstitutionResult fields have defaults; blocking_gates\n adjacent to hold_gates (consistent ordering, no API break — output type only)\n- constitution.py: _make_check gains 'required' param — absent key fails-CLOSED\n when required=True (safe default: required=False = \n[…]\nnew tests (110 total): multi-FAIL via dry_run, required=True HC,\n strict_mode with irrelevant keys, rollback path, strengthened summary test\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "v0.3.1: address second review — mypy, required HC, strict mode, rollb…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T23:18:44Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "17c04aafa338839d7df4fc337a8cadd829613da2",
"body": null,
"is_bot": false,
"headline": "fix: remove unused Optional import (ruff F401)",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T23:01:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b2f8721e944fd005ae815268a7e3608b4237edcd",
"body": "…ersistence hooks, input validation, version — closes #critical-review\n\n- Issue 1 (HIGH): YAML hard_constraints now parsed and appended to builtins\n- Issue 2 (HIGH): ratify_amendment() deep-merges changes and rebuilds evaluator\n- Issue 3 (MEDIUM): enabled:false gate config replaced with _DisabledGat\n[…]\nIssue 9: version bumped 0.1.0/0.2.0 -> 0.3.0 in __init__.py and pyproject.toml\n- Issue 10: blocking_gates list added to ConstitutionResult for all FAIL gates\n- 26 new tests added (103 total, 0 failed)",
"is_bot": false,
"headline": "v0.3.0: fix YAML HCs, amendment effects, enabled flag, strict mode, p…",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-09T20:11:26Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b51578d0fed33109e07e23d385d064999c3133f1",
"body": "Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: remove unused imports flagged by ruff",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T23:51:11Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "b863b7afe55e6dcc96499e7225b9d28f806601eb",
"body": "YAML threshold configuration:\n- All six gates now accept keyword-only threshold params in __init__\n- Constitution._build_evaluator() wires governance.yaml values to gate\n constructors — Constitution.load() was broken (loaded YAML, ignored it)\n\ndry_run mode:\n- Constitution.evaluate(dry_run=True) run\n[…]\nn both Python 3.11 and 3.12\n\nDocs: CHANGELOG.md, ROADMAP.md, CONTRIBUTING.md, SECURITY.md,\n 3 issue templates, GitHub Discussions seeded\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: v0.2.0 — YAML thresholds, dry_run, 77 tests, ruff CI",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T23:49:55Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "89335d24fd511188aae7cd0f7c4a1e3de7320d0f",
"body": "Three issue templates: bug report (with fail-open severity flag),\ngate threshold proposal (requires evidence field), hard constraint\nproposal (requires maintainer sign-off). SECURITY.md documents\ncritical fail-open vulnerabilities vs standard bugs, 24h/72h SLA,\nand the fail-CLOSED principle that governs all safety checks.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: add issue templates and SECURITY.md",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T23:41:26Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "ce8a7c7a614e1a8c37bfeec8218208a0276317db",
"body": "Links section now points to relevant articles instead of cteinvest.com\nhomepage (which leads to DLI quiz, not governance content):\n- Launch post: constitutional-agent-open-source-why-layer-governance\n- WHO vs HOW: the AI agent governance gap\n- Six-Gate Architecture\n- Why AI safety code must fail-closed\n- Constitutional vs behavioral governance\n- Consulting link → launch post (has the assessment CTA) not homepage\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: replace homepage links with specific blog posts in README",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T23:36:52Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "fae606c9a570173f7b22e43255808fae20e84c45",
"body": "Four phases: Establish Standard → Evidence Base → Own the Category →\nScale Commercial Layer. Includes competitive moat analysis, monetization\npath (reviews → hosted API → enterprise licensing), four key risks with\nmitigations, metrics dashboard, and explicit decision gates for phase\nadvancement, pivot triggers, and shutdown evaluation.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: add 18-month strategic roadmap",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T23:31:10Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "326093d47ae7d177a2f45a9d0ed4dc3b3aecaf9b",
"body": "Gate threshold changes require evidence. HC changes require maintainer\nsign-off. Fail-CLOSED principle documented for safety code contributors.\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: add CONTRIBUTING.md with amendment-style contribution process",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:59:28Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "c9501b0596a77840bac48d08b3db846ec83cc16c",
"body": "Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: add .gitignore, remove tracked __pycache__",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:58:00Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "38c8e06a94f9fbab22a72bf3b938cf097d189f49",
"body": "Three CI failures fixed:\n- Gate name strings changed to class names (EpistemicGate, EconomicGate,\n ConstitutionalGate) — GateResult.gate stores the class name, not lowercase\n- HC-11 is the silent outage check (hours_since_last_execution > 24);\n HC-12 is the gate override check — corrected test ass\n[…]\ningly\n- HEALTHY dict missing value_demo_count caused EconomicGate PRE_REVENUE\n to FAIL (check: value_demos <= 0) — added value_demo_count: 5\n\nCo-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: correct gate names, HC-11 ID, and HEALTHY value_demo_count",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:50:17Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "bc5abb44c33943de1210f29158222cd4751c2278",
"body": null,
"is_bot": false,
"headline": "Fix tests: use correct (SystemState, list[GateResult]) tuple return type",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:45:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0a8cc99a5c229cb97ad390f7da319f507553c75a",
"body": null,
"is_bot": false,
"headline": "Fix build backend: setuptools.backends.legacy -> setuptools.build_meta",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:43:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3118903e847097e8dfd7e42928481f2103cf5d15",
"body": null,
"is_bot": false,
"headline": "Add CI/publish workflows, tests, README badges",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:42:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dfee235747f1ea65ac744cabeea6c9dcf3725f5f",
"body": null,
"is_bot": false,
"headline": "Initial release: constitutional-agent v0.1.0",
"author_name": "msaleme",
"author_login": "msaleme",
"committed_at": "2026-04-08T22:16:03Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 12,
"commits_last_year": 62,
"latest_release_at": "2026-07-19T18:08:54Z",
"latest_release_tag": "v0.7.0",
"releases_from_tags": false,
"days_since_last_push": 8,
"active_weeks_last_year": 7,
"days_since_latest_release": 8,
"mean_days_between_releases": 11.2
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 87,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "constitutional-agent",
"exists": true,
"license": "MIT",
"keywords": [
"ai",
"agents",
"governance",
"constitutional",
"llm",
"autonomy",
"Development Status :: 4 - Beta",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Topic :: Scientific/Engineering :: Artificial Intelligence",
"Topic :: Software Development :: Libraries :: Python Modules"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/constitutional-agent/",
"is_deprecated": false,
"latest_version": "0.7.0",
"repository_url": "https://github.com/CognitiveThoughtEngine/constitutional-agent-governance",
"versions_count": 12,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 331,
"first_published_at": "2026-04-08T22:53:07.518245Z",
"latest_published_at": "2026-07-19T17:56:11.041243Z",
"latest_version_yanked": null,
"days_since_latest_publish": 8
}
]
},
"popularity": {
"forks": 0,
"stars": 0,
"watchers": 0,
"fork_history": {
"days": [],
"complete": true,
"collected": 0,
"total_forks": 0
},
"star_history": {
"days": [],
"complete": true,
"collected": 0,
"total_stars": 0,
"collected_at": null
},
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples"
],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 63584,
"source_files_sampled": 21,
"oversized_source_files": 1,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 1,
"malicious_count": 0,
"assessed_package": "pypi:constitutional-agent@0.7.0",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "pyyaml",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=6.0,<7"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 7,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 1,
"closed_unmerged_prs": 0
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "msaleme",
"commits": 56,
"avatar_url": "https://avatars.githubusercontent.com/u/30388598?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"release-validation.yml",
"release.yml",
"tests.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 10,
"reason": "6 out of 6 merged PRs checked by a CI test -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/21 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 0,
"reason": "project has 0 contributing companies or organizations -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "16 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": 10,
"reason": "packaging workflow detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 4,
"reason": "dependency not pinned by hash detected -- score normalized to 4",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": 0,
"reason": "Project has not signed or included provenance with any releases.",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 10,
"reason": "0 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "6adf69d0a0b7bcc3e552ed2e16bb7db2883aea8e",
"ran_at": "2026-07-27T22:18:22Z",
"aggregate_score": 4.7,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-19T17:56:14Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-07-19T17:40:20Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/CognitiveThoughtEngine/constitutional-agent-governance",
"host": "github.com",
"name": "constitutional-agent-governance",
"owner": "CognitiveThoughtEngine"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"security": 58,
"vitality": 72,
"community": 35,
"governance": 54,
"engineering": 81
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 72,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "moderate",
"name": "Development activity",
"note": null,
"notes": [],
"value": 60,
"inputs": {
"commits_last_year": 62,
"human_commit_share": 1,
"days_since_last_push": 8,
"active_weeks_last_year": 7
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 8 days ago",
"points": 28.8,
"status": "partial",
"details": [
{
"code": "push_recency",
"params": {
"days": 8
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "7/52 weeks with commits",
"points": 4.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 7
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "62 commits in the last year",
"points": 16.2,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 62
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "16 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"releases_count": 12,
"latest_release_tag": "v0.7.0",
"releases_from_tags": false,
"days_since_latest_release": 8,
"mean_days_between_releases": 11.2
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "12 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 12
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 8 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 8
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~11.2 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 11.2
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "unverified",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": "repository_too_young",
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": null,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "maintenance record not established from the collected data",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_unverified",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 35,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 1,
"inputs": {
"forks": 0,
"stars": 0,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "0 stars",
"points": 0,
"status": "missed",
"details": [
{
"code": "stars",
"params": {
"count": 0
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "0 forks",
"points": 0,
"status": "missed",
"details": [
{
"code": "forks",
"params": {
"count": 0
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "0 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 0
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "good",
"name": "Community health",
"note": null,
"notes": [],
"value": 70,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "at_risk",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 42,
"inputs": {
"packages": [
"constitutional-agent"
],
"dependents": null,
"ecosystems": "pypi",
"total_downloads": null,
"monthly_downloads": 331
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "331 downloads/month across pypi",
"points": 33.6,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 331,
"ecosystems": "pypi"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 54,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 10,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "excellent",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"merged_prs": 7,
"open_issues": 0,
"closed_issues": 1,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 0
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 46.8,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "7/7 decided PRs merged",
"points": 38.2,
"status": "met",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 7,
"decided": 7
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/21 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "at_risk",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 39,
"inputs": {
"followers": 1,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "CognitiveThoughtEngine",
"public_repos": 6,
"account_age_days": 110
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "1 followers of CognitiveThoughtEngine",
"points": 2.2,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 1,
"login": "CognitiveThoughtEngine"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "6 public repos, account ~0 yr old",
"points": 6.8,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 6
}
},
{
"code": "account_age_years",
"params": {
"years": 0
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"constitutional-agent"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 8
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 8 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 8
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "12 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 12
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 81,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 68,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "3 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 3
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "6 out of 6 merged PRs checked by a CI test -- score normalized to 10",
"points": 20,
"status": "met",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"topics": [
"agent-governance",
"ai-governance",
"autonomous-agents",
"constitutional-ai",
"llm-agents",
"python",
"agentic-ai",
"ai-safety",
"eu-ai-act",
"risk-management"
],
"has_wiki": true,
"homepage": "https://pypi.org/project/constitutional-agent/",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://pypi.org/project/constitutional-agent/",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "10 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 10
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "moderate",
"name": "Security",
"value": 58,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": null,
"notes": [],
"value": 47,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 18,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 0,
"scorecard_aggregate": 4.7
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "6 out of 6 merged PRs checked by a CI test -- score normalized to 10",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/21 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 0 contributing companies or organizations -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "16 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 4",
"points": 2,
"status": "partial",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "0 existing vulnerabilities detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:constitutional-agent@0.7.0 runtime dependency closure — what installing the published package pulls in — 1 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:constitutional-agent@0.7.0",
"assessed": 1
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 1,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 1,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "at_risk",
"name": "AI Readiness",
"value": 40,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.935,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "58 of 62 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 58,
"sampled": 62
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 36,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [],
"agent_commit_share": 0.435,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "27 of the last 62 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 27,
"sampled": 62
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 4",
"points": 4,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 52,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 63584,
"source_files_sampled": 21,
"oversized_source_files": 1
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "1/21 source files over 60KB",
"points": 52.4,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 21,
"oversized": 1
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-07-27T22:18:33.038791Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/c/CognitiveThoughtEngine/constitutional-agent-governance.svg",
"full_name": "CognitiveThoughtEngine/constitutional-agent-governance",
"license_state": "standard",
"license_spdx": "MIT"
}Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.27.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics — PyPI.