Public recordModerate
Software health reportschema 0.26.0 · metrics 1.13.0 · 2026-07-22 11:29 UTC
ShovelsAI / shovels-cli
ShovelsAI/shovels-cli holds a health index of 51 out of 100, placing it in the Moderate band. It scores highest on AI Readiness (78/100) and lowest on Community & Adoption (31/100). It was last updated 2 days ago. A single contributor accounts for most of its recent work.
51
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.
51
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
ShovelsOrganization
14 followers4 public repossince Aug 2015
This repository is backed by an organization — shared, accountable stewardship that can outlive any single maintainer.
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
77
Development activity
68Moderate
How it's scored
| 36/36 | Push recency — last push 2 days ago |
| 3.5/36 | Commit cadence — 5/52 weeks with commits |
| 18/18 | Commit volume — 135 commits in the last year |
| 10/10 | OpenSSF Scorecard: Maintained — 12 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
Inputs used
| commits_last_year | 135 |
| human_commit_share | 0.96 |
| days_since_last_push | 2 |
| active_weeks_last_year | 5 |
Release discipline
90Excellent
How it's scored
| 27/27 | Ships releases — 10 releases published |
| 36/36 | Release recency — latest release 4 days ago |
| 27/27 | Release cadence — a release every ~15.2 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — Project has not signed or included provenance with any releases. |
Inputs used
| releases_count | 10 |
| latest_release_tag | v0.7.1 |
| releases_from_tags | no |
| days_since_latest_release | 4 |
| mean_days_between_releases | 15.2 |
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
31
Popularity & adoption
15Critical
How it's scored
| 14.6/60 | Stars — 9 stars |
| 0/25 | Forks — 0 forks |
| 0/15 | Watchers — 0 watchers |
Inputs used
| forks | 0 |
| stars | 9 |
| watchers | 0 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Community health
50Moderate
How it's scored
| 22.5/22.5 | README |
| 22.5/22.5 | License — recognized license (MIT) |
| 0/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 | no |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | no |
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
45
Maintainer resilience (bus factor)
13Critical
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 |
| 3/10 | OpenSSF Scorecard: Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 1 |
| top_contributor_share | 1 |
How it's scored
| 0/46.8 | Issue resolution — no issues or no data |
| 38.2/38.3 | PR acceptance — 12/12 decided PRs merged |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 0/9 approved changesets -- score normalized to 0 |
Inputs used
| merged_prs | 12 |
| open_issues | 0 |
| closed_issues | 0 |
| issue_closed_ratio | — |
| closed_unmerged_prs | 0 |
Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.
Ownership & stewardship
56Moderate
How it's scored
| 30/30 | Ownership backing — organization-owned |
| 0/20 | Verified domain |
| 8.5/25 | Owner reach — 14 followers of ShovelsAI |
| 17.1/25 | Track record — 4 public repos, account ~10 yr old |
Inputs used
| followers | 14 |
| owner_type | Organization |
| is_verified | — |
| owner_login | ShovelsAI |
| public_repos | 4 |
| account_age_days | 3,978 |
Engineering Quality
Are baseline engineering and documentation practices in place?
53
Engineering practices
68Moderate
How it's scored
| 24/24 | CI workflows — 2 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
30At risk
How it's scored
| 30/30 | README |
| 0/25 | Documentation directory |
| 0/15 | Documentation / homepage site |
| 0/10 | Repository description |
| 0/10 | Topics |
| 0/10 | Wiki |
Inputs used
| topics | — |
| has_wiki | no |
| homepage | — |
| has_readme | yes |
| has_docs_dir | no |
| has_description | no |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
43
Security posture
43At risk
How it's scored
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 2.2/7.5 | Branch-Protection — branch protection is not maximal on development and all 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/9 approved changesets -- score normalized to 0 |
| 0.8/2.5 | Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 7.5/7.5 | Dependency-Update-Tool — update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | License — license file detected |
| 7.5/7.5 | Maintained — 12 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 5/5 | Packaging — packaging workflow detected |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 0/5 | Security-Policy — security policy file not 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 |
| 0/7.5 | Vulnerabilities — 15 existing vulnerabilities detected |
Inputs used
| source | openssf_scorecard |
| checks_evaluated | 18 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 0 |
| scorecard_aggregate | 4.3 |
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.
78
Agent context & guidance
85Excellent
How it's scored
| 45/45 | Agent instructions — CLAUDE.md |
| 0/15 | Machine-readable docs (llms.txt) |
| 40/40 | Legible commit history — 87 of 96 human commits state their intent (structured subject or explanatory body) |
Inputs used
| has_llms_txt | no |
| legible_history_share | 0.906 |
| agent_instruction_files | CLAUDE.md |
| agent_instruction_max_bytes | 5,541 |
Verify loop (build / test / typecheck)
64Moderate
How it's scored
| 12.6/18 | One-command bootstrap — go.mod (toolchain convention, no task runner) |
| 22/22 | Automated tests |
| 0/11 | Lint / format config |
| 11/11 | Static type checking — Go (statically typed) |
| 10/10 | Reproducible environment — lockfile |
| 0/10 | Demonstrated agent practice — no agent-authored commits among the last 100 |
| 8/8 | Automated maintenance — 4 of the last 100 commits are automated dependency updates |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | go.sum |
| has_dockerfile | no |
| typed_language | yes |
| bootstrap_files | — |
| has_devcontainer | no |
| has_linter_config | no |
| typecheck_configs | — |
| agent_commit_share | 0 |
| toolchain_manifests | go.mod |
| dependency_bot_commit_share | 0.04 |
Code legibility for models
99Excellent
How it's scored
| 45/45 | Type-checkable code — Go (statically typed) |
| 54.4/55 | Manageable file sizes — 1/85 source files over 60KB |
Inputs used
| primary_language | Go |
| largest_source_bytes | 83,253 |
| source_files_sampled | 85 |
| oversized_source_files | 1 |
Key facts
9GitHub stars
1contributors
135commits, last 12 months
2days since last push
10releases
1bus factor
0open issues
Gopackage ecosystems
Data collection warnings
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- Could not fetch go package 'github.com/shovels-ai/shovels-cli' from its registry
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
More detail
OpenSSF Scorecard 4.3 / 10
4.3aggregate
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 |
| 3 | Branch-Protection | branch protection is not maximal on development and all 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/9 approved changesets -- score normalized to 0 |
| 3 | Contributors | project has 1 contributing companies or organizations -- score normalized to 3 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 10 | Dependency-Update-Tool | update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 12 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 10 | Packaging | packaging workflow detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 0 | Security-Policy | security policy file not detected |
| 0 | Signed-Releases | Project has not signed or included provenance with any releases. |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 0 | Vulnerabilities | 15 existing vulnerabilities detected |
Direct dependencies 4
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| Go | github.com/creativeprojects/go-selfupdate | v1.5.2 | go.mod |
| Go | github.com/spf13/cobra | v1.10.2 | go.mod |
| Go | github.com/spf13/pflag | v1.0.10 | go.mod |
| Go | gopkg.in/yaml.v3 | v3.0.1 | go.mod |
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
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [],
"is_fork": false,
"size_kb": 459,
"has_wiki": false,
"homepage": null,
"languages": {
"Go": 807434,
"Shell": 6365
},
"pushed_at": "2026-07-20T03:14:49Z",
"created_at": "2026-03-02T14:20:19Z",
"owner_type": "Organization",
"updated_at": "2026-07-17T15:58:25Z",
"description": null,
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "Go",
"significant_languages": [
"Go"
]
},
"owner": {
"blog": "https://www.shovels.ai",
"name": "Shovels",
"type": "Organization",
"login": "ShovelsAI",
"company": null,
"location": "United States of America",
"followers": 14,
"avatar_url": "https://avatars.githubusercontent.com/u/14048501?v=4",
"created_at": "2015-08-31T04:06:31Z",
"is_verified": null,
"public_repos": 4,
"account_age_days": 3978
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v0.7.1",
"kind": "patch",
"published_at": "2026-07-17T16:00:07Z"
},
{
"tag": "v0.7.0",
"kind": "minor",
"published_at": "2026-06-01T23:50:59Z"
},
{
"tag": "v0.6.0",
"kind": "minor",
"published_at": "2026-05-31T20:49:29Z"
},
{
"tag": "v0.5.1",
"kind": "patch",
"published_at": "2026-04-03T08:23:57Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2026-03-09T11:24:03Z"
},
{
"tag": "v0.4.0",
"kind": "minor",
"published_at": "2026-03-08T20:53:53Z"
},
{
"tag": "v0.3.0",
"kind": "minor",
"published_at": "2026-03-05T09:32:38Z"
},
{
"tag": "v0.2.1",
"kind": "patch",
"published_at": "2026-03-03T00:09:13Z"
},
{
"tag": "v0.2.0",
"kind": "minor",
"published_at": "2026-03-02T23:50:52Z"
},
{
"tag": "v0.1.0",
"kind": "minor",
"published_at": "2026-03-02T16:43:05Z"
}
],
"recent_commits": [
{
"oid": "18e79b023de69c64705b3ad9f9548e583a8270be",
"body": "Four persistent flags (--limit, --max-records, --base-url, --timeout)\nhand-wrote a (default ...) note in their usage string while cobra also\nauto-appends its own for any flag with a non-zero default, so --help\nrendered each default twice. Drop the manual text; cobra supplies it.\n\nFixes ENG-3840",
"is_bot": false,
"headline": "Remove duplicate default annotations from global-flag help (#14)",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-07-17T15:57:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "70b6e80e355a927f57bad79e001289f34e357a60",
"body": "Verify a blind agent can discover and use decisions search for a\nnatural-language zoning task, satisfying the usability gate for the\nnew command. The task is state-level to avoid ZIP, which decisions\nrejects, and city-resolution flakiness. Sparse decisions data makes\nusability the gate, not result volume, so empty data is accepted and\na decisions-distinctive field is checked only when data is present.",
"is_bot": false,
"headline": "Add zoning decisions eval scenario",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-06-01T23:47:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c0fccb7d2eea7bbc0b58f543f5c0426b46b4dc07",
"body": "Register the --schema flag on both decisions subcommands and route it\nthrough the offline schema lookup, so an agent can discover the field\nset and meta shape without spending credits on a live call.\n\nList decisions in the root help among the commands that answer\n--schema.",
"is_bot": false,
"headline": "Wire --schema onto decisions search and get",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-06-01T23:47:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f76640fa82f9fac5098031ed1c1149add755d65f",
"body": "Add the decisions search and get entries to the generated schema so\nagents can inspect their fields offline via --schema.\n\nThe generator distinguishes batch-get meta from paginated meta: a get\nreturns a fixed set of records keyed by ID, so its envelope reports\ncount, missing, and credit fields but n\n[…]\naginates and does. Encoding that distinction in the get branch\nyields a correct decisions get schema and aligns the sibling permits\nand contractors get schemas, whose envelopes likewise omit has_more.",
"is_bot": false,
"headline": "Generate offline schema for decisions commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-06-01T23:47:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ce90a6f3aa4d9d1ca391b5e7ae6b74ad6b9f43f6",
"body": "Agents need to fetch specific zoning and land-use decisions by ID in a\nsingle batch request. The command accepts up to 50 IDs as positional\narguments, returns found decisions in the data envelope, and surfaces\nany unknown IDs in meta.missing so callers can tell which lookups\nfailed.",
"is_bot": false,
"headline": "Add decisions get subcommand",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-06-01T23:47:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4f87df431529b39d7fdfc473fd15529f4f04c1ed",
"body": "Wrap GET /decisions/search as a new top-level decisions resource with\na search subcommand, so agents can query zoning and land-use decisions\nby geography and date range.\n\nDecisions owns its flag set, validation, and query builder rather than\nreusing the permits-shaped search helpers, because it rejects ZIP\ngeo_ids, emits decision_* date params, and exposes a distinct filter\nset. Only resource-agnostic plumbing (pagination, dry-run, timeout,\nclient construction, and API-error mapping) is shared.",
"is_bot": false,
"headline": "Add decisions search command",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-06-01T23:47:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "028e6ec40cb16d513d74a4c116096191ba57e10c",
"body": "The shared cause text is reused by state and zip coverage, so the\nzero-permits explanation is worded by geography rather than naming a\njurisdiction, keeping it accurate across all five coverage commands.",
"is_bot": false,
"headline": "Explain why a coverage field is missing",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-05-31T20:44:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "be59b18e096b3e4e509c153353b1662c28c4fc1e",
"body": "Imperative-task agents read search help then immediately query,\nskimming past a coverage tip placed lower down. Surfacing the\ncredit-exempt coverage directive before the required-flag walls\ncatches them before the first credit-burning query.",
"is_bot": false,
"headline": "Lead search help with coverage pre-flight",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-05-31T20:44:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bd01126f85a8dfb6aecf34d6b043038f509d7f82",
"body": "Root, search, and metrics help direct agents to check coverage before\nrunning field-dependent searches, so they confirm field availability\nwithout spending credits on queries the data cannot support.\n\nThe coverage workflow only references geographies coverage supports\n(city, county, jurisdiction, st\n[…]\ndoes not imply address\ncoverage exists. The directive frames coverage as flagging the fields\nthat are NOT reliably populated, rather than implying a positive field\nlist or a single total-count scalar.",
"is_bot": false,
"headline": "Point help at coverage as credit-exempt pre-flight",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-05-31T20:44:14Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "cfca373e3121880abcda1d90644c28b6de79196e",
"body": "The /v2/usage response now returns a per-day daily_usage array over the\nrolling 30-day window, so the help text describes it for agents reading\n--help before inspecting output.",
"is_bot": false,
"headline": "Document daily_usage breakdown in usage help",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-05-31T20:44:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cfb4d7b5f290c701b4b4545226e32fcbb251540d",
"body": "Coverage commands are non-paginated and credit-exempt, so they need\ndistinct schema generation: an empty meta envelope, a positional GEO_ID\nplus coverage date filters, and a surfaced tier enum. A loud-fail guard\nnow aborts generation when a named response schema yields zero fields,\nturning a silent typo into a build failure.",
"is_bot": false,
"headline": "Add coverage --schema catalog entries",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-05-31T20:44:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "34e3270efea7f586097a163ea583f232af00b645",
"body": "Wraps GET /meta/coverage so agents can check which permit fields are\nreliably populated for a geography and date window before spending\ncredits on a query. Coverage is credit-exempt and non-paginated, so it\nuses a single Get and maps the items array into the standard data\nenvelope.",
"is_bot": false,
"headline": "Add coverage command for all five geographies",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-05-31T20:44:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b8753020e2a8f42a171714a8ff242c97526816de",
"body": "Mechanical change across 14 call sites: replace field-by-field\nunpacking with output.PrintPaginated(w, result).",
"is_bot": false,
"headline": "Update all PrintPaginated callers to pass result directly",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-04-03T08:16:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2bb2e5a60200be7255cd3eafd64c7278bada5c1d",
"body": "Replaces the 6-parameter signature with (io.Writer, *PaginatedResult).\nThe output layer reads fields directly from the result struct, so\nadding fields to PaginatedResult no longer requires updating callers.",
"is_bot": false,
"headline": "Simplify PrintPaginated to accept *PaginatedResult",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-04-03T08:16:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2116073a50b505382f05cdaf88ad86e913248e74",
"body": "credits_used reported only the last page's cost because PaginatedResult\nreused the per-response CreditMeta struct. Replace Credits CreditMeta\nwith explicit CreditsUsed/CreditsRemaining *int fields so the type\nsystem distinguishes per-request from aggregate credit data.\n\nAdd creditsUsedPtr helper and four tests covering multi-page\naccumulation (cursor exhausted and limit reached), single-page\npass-through, and nil preservation when API returns no credit headers.",
"is_bot": false,
"headline": "Accumulate credits_used across paginated pages",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-04-03T08:16:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9607e9b308b77f1b305914e7ceb7850f52c2611b",
"body": "The API accepts up to 100 items per page but the CLI\ncapped at 50, doubling HTTP round-trips for large\nresult sets. Raising apiPageSizeMax to 100 halves the\nrequest count for any fetch exceeding 100 records.",
"is_bot": false,
"headline": "Raise API page size from 50 to 100",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-09T11:07:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "668377e649b7e2003a129b368f11bd521cafa468",
"body": "Reject invalid --contractor-classification values before making an API\ncall, matching the client-side validation pattern used for --status and\n--property-type. Includes 13 canonical enum values from the OpenAPI spec,\nhelp text examples, and schema descriptions.",
"is_bot": false,
"headline": "Add classification flag validation",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-09T11:07:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d73fd8e86503d047c1136dc33e92f0ca83f5423d",
"body": "The CLI hard-rejected 6 valid API property types (agricultural,\nvacant land, exempt, miscellaneous, office, recreational) because\nvalidPropertyTypes only contained residential, commercial, industrial.\n\nExpand the validation slice, update help text and schema descriptions\nacross all commands that accept --property-type, and regenerate\nschema_data.go. E2e tests assert all 9 types in every help context.",
"is_bot": false,
"headline": "Accept all 9 API property type values",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-09T11:07:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "468fc586166813108d3131db50ff2436f0d8f388",
"body": null,
"is_bot": false,
"headline": "Document pre-commit hook setup in CLAUDE.md",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "babb5c3d31959c09f14c764cb882a2b01595aeb1",
"body": "Run gofmt on cmd/schema_test.go and e2e/schema_test.go to fix CI\nlint failure. Add .githooks/pre-commit that runs gofmt, go vet, and\ngo test before each commit to catch these locally.",
"is_bot": false,
"headline": "Fix gofmt and add pre-commit hook mirroring CI",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3b066eb9e645805781957442bab25bf56a149de7",
"body": "The schema generator wrote schema_data.go directly to disk without\nrunning gofmt, causing persistent formatting drift. Buffer output\nand apply go/format.Source before writing so regeneration always\nproduces gofmt-compliant code.",
"is_bot": false,
"headline": "Format generated schema via go/format",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "219421bae8ff77052c7366d34f76b44ef6aba165",
"body": "Agents skip --schema and guess at field semantics. A short tip in\neach data command's help text nudges them to inspect metadata first.",
"is_bot": false,
"headline": "Add --schema discovery hints to help text",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "949f6b7bbc4595ab10fc6ffe7f07679aefa82ecb",
"body": "Agents try --id as a flag on commands that accept ID positionally,\ngetting cryptic \"unknown flag\" errors. Each ID-accepting command\nnow has a Note block with correct/incorrect usage examples.",
"is_bot": false,
"headline": "Add positional arg hints to ID commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0b3bf5977b15c03f93418468b9ca22e1bd4fd5d9",
"body": "Spec requires 3-5 lines for scoping section and 1-2 lines for\n--no-tallies warning. Fix the upper bound from 6 to 5 and add\na missing conciseness assertion for the flag description.",
"is_bot": false,
"headline": "Tighten e2e boundary assertions",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a0f4e1922d0b2bf64d7aafbebc722e916bad4fa7",
"body": "Agents reading only --help confuse global lifetime stats (permit_count)\nwith search-filtered results (tag_tally), leading to absurd analysis.\nThe scoping section and --no-tallies warning make the distinction clear\nwithout requiring agents to discover --schema.",
"is_bot": false,
"headline": "Add scoping guidance to contractor search",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b35515b77eae15d1016ab59aa3a3322c4b3c158a",
"body": "Refactor to table-driven assertions covering every GLOBAL field\n(permit_count, avg_job_value, total_job_value, avg_construction_duration,\navg_inspection_pass_rate) and every FILTERED field (tag_tally,\nstatus_tally) to ensure complete boundary coverage.",
"is_bot": false,
"headline": "Cover all contractor scope fields in e2e tests",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "62ec07e3473a6505e65c0b3e82fdc327e846ce10",
"body": "Agents confuse contractor lifetime stats (permit_count=93,259) with\nsearch-filtered results (tag_tally sum=39), producing absurd analysis.\nLabel aggregate fields as GLOBAL or FILTERED so agents know which\nvalues reflect search parameters and which are lifetime totals.",
"is_bot": false,
"headline": "Add scope labels to contractor schema fields",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1cf79af5c809693206a24a50847945cf44149e2f",
"body": "Agents read the description text but skip the separate unit metadata\nfield, causing 100x dollar errors. All 20 monetary fields now include\n\"in cents (divide by 100 for dollars)\" directly in the description.",
"is_bot": false,
"headline": "Bake units into schema field descriptions",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69091bffa6b212c6d77a53126f048b70d7c14d50",
"body": "Flag descriptions and schema filter entries said \"in dollars\" but the\nAPI accepts cents. Corrected all four monetary flags to say \"in cents\"\nwith dollar-equivalent conversions, added Unit:\"cents\" metadata to\nschema output, and updated the --no-tallies description to warn that\ntallies are the only search-filtered contractor fields.",
"is_bot": false,
"headline": "Fix monetary filter help text units",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-08T20:50:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4b26e9e3fc205bf82a83e6b872b7c8571877b8b0",
"body": "CI lint requires all files pass gofmt. The schema generator\nand schema e2e tests had formatting drift.",
"is_bot": false,
"headline": "Fix gofmt formatting in generated schema data",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a7787ebf75795958ef943efc76edee5059831cf7",
"body": "Jq eval scenarios must prove the agent discovered jq rather than\nproducing lucky output. Monthly breakdowns must show temporal\nstructure, not just multi-entry JSON.",
"is_bot": false,
"headline": "Strengthen eval output validators and ratings",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4d30cd722a161c32e3fb3890197fb3c3b7120c4a",
"body": "Blind agents need to discover metrics, schema, dry-run, and jq\npipeline workflows without hints. Six new scenarios validate\ndiscoverability of v0.3.0 features alongside existing four.",
"is_bot": false,
"headline": "Add LLM eval scenarios for new commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6dc2eae9cca11922818b1da23e536a571f444a33",
"body": "Cobra skips PersistentPostRunE when RunE or validation\nreturns an error, leaving the update goroutine orphaned.\nDefer the wait in Execute() to guarantee cleanup regardless\nof command outcome.",
"is_bot": false,
"headline": "Wait for update goroutine on all exit paths",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fdf714432ead9ab479f5f0e4d81f3ba269844bd3",
"body": "New users without an existing config directory had cache writes\nfail silently, causing update checks on every CLI invocation\ninstead of respecting the 24-hour throttle.",
"is_bot": false,
"headline": "Create parent dirs in update cache writer",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d35e763c67c83cbac703ca500a10958fe3816651",
"body": "Users should always run the latest CLI without manual intervention.\nAll failures are silent to avoid disrupting the user's command.",
"is_bot": false,
"headline": "Add background autoupdate via GitHub Releases",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7cef4ccc326f021d464cde9c2e127a7ce3fa9da3",
"body": "Users need a way to opt out of background autoupdate. The Autoupdate\nfield defaults to true (nil = enabled) so existing configs work\nwithout changes.",
"is_bot": false,
"headline": "Add autoupdate config field",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5224df8f56a96088b921defde5f28363d9b927d8",
"body": "Schema and --schema flag need regression coverage to catch init\nordering issues and ensure offline operation without auth.",
"is_bot": false,
"headline": "Add e2e tests for schema introspection",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f7f9bf797dc2e7f419d3574238f003ab2b153478",
"body": "LLM agents need offline access to response field schemas to construct\njq pipelines without trial-and-error API calls or auth credentials.",
"is_bot": false,
"headline": "Add schema command and --schema flag",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fd190e3a60e91c3f3a274af167821ad57d25e47a",
"body": "LLM agents need offline access to annotated response schemas\nto construct jq pipelines without trial-and-error API calls.\nCommitted Go source ensures schema availability without\nruntime OpenAPI dependency.",
"is_bot": false,
"headline": "Add schema data generation pipeline",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f73ff5cf62b0e43c4dec589626cfa5a89b9acc55",
"body": "Global flags like --timeout must be validated even when --dry-run\nshort-circuits before client creation, so invalid values are\nnever silently accepted.",
"is_bot": false,
"headline": "Wire --dry-run into all data commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8fd20374b0395434f7f2e38aafd280dd71a332d5",
"body": "LLM agents and pipeline builders need to inspect resolved HTTP\nrequests without spending credits or hitting the API.",
"is_bot": false,
"headline": "Add --dry-run flag infrastructure",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8d8423dee2c518bce5acbfbb3916053090cf7029",
"body": "The version command needs API credentials from environment\nvariables and flag overrides even when the config file is\nmalformed, otherwise data_release_date is always null despite\nvalid auth being available.",
"is_bot": false,
"headline": "Preserve env vars in version config fallback",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4692a62c1d3562badb28ef63b9c6e76dc42f88fd",
"body": "Only the version command needs to survive config failures.\nOther commands depend on correct config values and should\nfail explicitly rather than proceeding with empty defaults.",
"is_bot": false,
"headline": "Scope config-error bypass to version only",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b407fac6a99a616c34cfdc18ff4ede2e90ff36a2",
"body": "Version must always exit 0 regardless of environment state,\nsince it is the primary diagnostic tool when configuration\nis broken.",
"is_bot": false,
"headline": "Harden version command against config failures",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d8918c5c398ffac92ba748aa7a6d7884060d9f43",
"body": "Users and agents need to know how current the API data is\nbefore trusting query results. The version command degrades\nsilently to null when auth is missing or the API is unreachable.",
"is_bot": false,
"headline": "Add data freshness to version command",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8878e423184e304ffb7eafe76b0744d5811189e",
"body": "Exposes PII resident data at GET /v2/addresses/{geo_id}/residents\nwith paginated output. Help text documents the personal nature of\nthe data and the address-first resolution workflow.",
"is_bot": false,
"headline": "Add addresses residents subcommand",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cd4f997d2b6f43757296e2419fb74011b7afa891",
"body": "Completes geographic search coverage so users can discover\nzip codes and state abbreviations for --geo-id on other\ncommands without needing to know them in advance.",
"is_bot": false,
"headline": "Add zipcodes and states search commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "26527756184f0e6739abf1de258e065658e743f3",
"body": "Counties, jurisdictions, and addresses each need current and monthly\nmetrics endpoints. Addresses metrics omits property_type to match the\nAPI contract where addresses lack that dimension.",
"is_bot": false,
"headline": "Add remaining geo-metrics commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d690fd95f8975d3249bdb963675a876cd466e8b0",
"body": "Cities metrics validation and request plumbing needs reuse across\ncounties, jurisdictions, and addresses without copy-paste divergence.",
"is_bot": false,
"headline": "Extract shared geo-metrics helpers",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bfd546d434d164cbcc222352f70826808374b501",
"body": "Cities need geo metrics endpoints for permit activity analysis.\nThe current variant returns aggregate snapshots while monthly\nreturns time-series data with date fields over a specified range.\nDate flags are rejected on current with a clear message directing\nusers to the monthly variant.",
"is_bot": false,
"headline": "Add cities metrics current and monthly commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-05T09:29:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "954253207d87cb961e5587430b9d76a56f5c1d7a",
"body": null,
"is_bot": false,
"headline": "Document LLM eval suite in CLAUDE.md",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-03T01:25:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2953efc83d5d70f6ed7529b41090d12c81f2fea2",
"body": "Spawns blind Claude agents that discover and execute CLI commands\nusing only --help output. Four natural-language scenarios test\npermit search, contractor lookup, geo_id resolution, and tag\ndiscovery. Run with: go test -tags=eval ./evals/... -v -timeout 10m",
"is_bot": false,
"headline": "Add LLM eval suite for CLI help text usability",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-03T01:17:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "15cf37aa08e9358b1fbda7e942e7bbe85348747d",
"body": null,
"is_bot": false,
"headline": "List valid contractor classification values in help text",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-03T00:07:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e3dd6a8e0e700dba23b7e3c2f80b21de0308c14b",
"body": null,
"is_bot": false,
"headline": "Fix Go Report Card badge URL casing",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:53:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "719ecaf9bb4b32096f31a5fe994c2fb6daaa90bc",
"body": "Agents and engineers can see the tag-push release\nprocess without reading CI config files.",
"is_bot": false,
"headline": "Document release workflow in CLAUDE.md",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8232e032265b07824e736d51e8d82b7974f1d357",
"body": "The command tree must reflect all commands visible in\n`shovels --help`, including Cobra built-ins.",
"is_bot": false,
"headline": "Add completion and help to README command tree",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ad06478421157935ffc670fa0c3eef1937dcb7a9",
"body": "All --geo-id references now show cities search, counties search,\njurisdictions search, and addresses search as resolution paths.\nRoot help lists the four new commands in available resources.",
"is_bot": false,
"headline": "Update help text for geo resolution commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2f82fee88f5102fa5c5293bcbea494bbfcbac13f",
"body": "All --query validation errors now use the same format\nacross cities, counties, jurisdictions, and addresses.",
"is_bot": false,
"headline": "Standardize addresses search error message",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c83bf42fffc7e18008c6ff0256a3c3c867f4ae47",
"body": "Invalid property types cause silent empty results\nfrom the API. Validation catches mistakes early\nwith an actionable error listing valid options.",
"is_bot": false,
"headline": "Validate --property-type enum values",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "11ba9c5bd2bf3b400167dda7f580089f50352860",
"body": "Agents need to discover valid --tags values instead of guessing,\nwhich leads to silent empty results from invalid tag names.",
"is_bot": false,
"headline": "Add tags list command for tag discovery",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0b91b8634d42f7369dd62f7383aaf2b999f6a1ef",
"body": "Agents need to resolve jurisdiction names to Shovels geo_ids for\njurisdiction-level permit and contractor searches.",
"is_bot": false,
"headline": "Add jurisdictions search for geo_id resolution",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c5b7d1192948ce4c079fbd427235f38c4c62a314",
"body": "Agents need to resolve county names to Shovels geo_ids for\ncounty-level permit and contractor searches.",
"is_bot": false,
"headline": "Add counties search command for geo_id resolution",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f80f09024a535d728798af27889a710890068d55",
"body": "The /cities/search endpoint ignores the size parameter and\nreturns all matches. The mock handler now does the same, so\nthe limit test verifies client-side truncation.",
"is_bot": false,
"headline": "Match cities mock to real endpoint behavior",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3b2228c59ec5dc506fa7e7f2fdcfe18017fa433f",
"body": "Endpoints like /cities/search ignore the size parameter and\nreturn all matches at once. The paginator now slices results\nto the requested limit when no cursor is present.",
"is_bot": false,
"headline": "Truncate single-page responses to effective limit",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8fe84717b5338851fc44aacd18281203ff2ef755",
"body": "Geo_id validation rejects prefixed formats like ZIP_90210.\nE2e tests use bare 5-digit codes to match the accepted format.",
"is_bot": false,
"headline": "Use bare zip codes in e2e tests",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "715c4c8ee5f59bbc79416f57ae4cdc4b92968d86",
"body": "Agents need to resolve city names to Shovels geo_ids before\nsearching permits or contractors by city. This was the primary\ngap found in blind usability testing.",
"is_bot": false,
"headline": "Add cities search command for geo_id resolution",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T23:48:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "512d7db8c61acf0cdf08f4260533ed3c14ffd30b",
"body": null,
"is_bot": false,
"headline": "Add .playwright-mcp/ to .gitignore",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T22:37:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cb17a79bbf3944092c6c3879c206fd0a2b6b080d",
"body": null,
"is_bot": false,
"headline": "Add .gambit/ to .gitignore",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T22:33:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "183d824332d859e5da0d94b64d969947c4ecc054",
"body": "Validates --geo-id before hitting the API. Detects common wrong\nformats (ZIP_90210, CITY_*, COUNTY_*, STATE_*, ADDR_*) and tells\nthe agent exactly what to do: use bare zip/state codes, or resolve\nvia addresses search.",
"is_bot": false,
"headline": "Catch wrong geo_id prefixes with actionable error message",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T19:36:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1acf2d58b36677833e8b8fd8fb228f7323f1392c",
"body": "Replace wrong formats (ZIP_90210, CITY_LOS_ANGELES_CA, etc.) with\ncorrect ones: bare zip codes (92024), state codes (CA), and opaque\nShovels IDs resolved via addresses search.\n\nAdd \"Geographic IDs\" section to permits search and contractors search\nhelp text explaining the two-step resolution workflow. Flag description\nnow includes the resolve command as a one-liner.",
"is_bot": false,
"headline": "Fix geo_id docs across all help text and README",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T19:33:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06268f8dea6025a16ef306657e4d64ca313dc7a9",
"body": "The install script is now hosted at the marketing site root.\n curl -LsSf https://shovels.ai/install.sh | sh",
"is_bot": false,
"headline": "Update install URL to shovels.ai/install.sh",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T18:57:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "17ba7cb70cf44c8e6cdc32e454c57cba44dd947c",
"body": "Zip codes use bare 5-digit codes (92024), states use 2-letter codes\n(CA). All other geographies (addresses, cities, counties) have opaque\nIDs that must be resolved via addresses search. Formats like\nCITY_LOS_ANGELES_CA do not exist.",
"is_bot": false,
"headline": "Document geo_id format rules in CLAUDE.md",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T18:39:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "03a41890dcd6de16a38d53d5d12f6ca78d6ed4cf",
"body": "Remove Homebrew (not set up), go install (niche), manual download\ntable (redundant with install.sh). Tighten Quick start, Commands,\nOutput format, and reference sections. 343 → 261 lines.",
"is_bot": false,
"headline": "Trim README to working sections only",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T17:22:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "12d64c28525cbe1fabac0bf7d1cd828b92febfef",
"body": "Promoted as the first install option — one command, no prerequisites\nbeyond curl and tar. Downloads latest release, verifies checksum,\ninstalls to ~/.shovels/bin, adds to PATH.",
"is_bot": false,
"headline": "Add curl | sh quick install to README",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T17:20:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "23a975d6a383ff4f3274d4bb6543435f634518e8",
"body": "Detects OS/arch, downloads from GitHub Releases, verifies SHA256\nchecksum, installs to ~/.shovels/bin, and appends to PATH in the\nuser's shell profile. Supports GITHUB_TOKEN for private repos.",
"is_bot": false,
"headline": "Add curl | sh install script",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T17:17:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "74bdb31de021326e280930c02d5d3c2e22b376d1",
"body": "- Remove .spade/ from git (internal tooling state, Linear URLs, local paths)\n- Remove Linear tracking link from CLAUDE.md\n- Replace staging.shovels.ai with example.com in help text and README\n- Add .spade/, worktrees/, .env, *.pem, *.key to .gitignore",
"is_bot": false,
"headline": "Remove internal references and harden .gitignore before going public",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T17:17:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ff1d8084d6959593170621f2c58ff2400ad01853",
"body": "Bumps [github.com/spf13/pflag](https://github.com/spf13/pflag) from 1.0.9 to 1.0.10.\n- [Release notes](https://github.com/spf13/pflag/releases)\n- [Commits](https://github.com/spf13/pflag/compare/v1.0.9...v1.0.10)\n\n---\nupdated-dependencies:\n- dependency-name: github.com/spf13/pflag\n dependency-version: 1.0.10\n dependency-type: direct:production\n update-type: version-update:semver-patch\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>",
"is_bot": true,
"headline": "Bump github.com/spf13/pflag from 1.0.9 to 1.0.10",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-03-02T17:03:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "aa0436bc548acfad733c66fac5efa960d09e0300",
"body": "Bumps [actions/setup-go](https://github.com/actions/setup-go) from 5 to 6.\n- [Release notes](https://github.com/actions/setup-go/releases)\n- [Commits](https://github.com/actions/setup-go/compare/v5...v6)\n\n---\nupdated-dependencies:\n- dependency-name: actions/setup-go\n dependency-version: '6'\n dependency-type: direct:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>",
"is_bot": true,
"headline": "Bump actions/setup-go from 5 to 6",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-03-02T17:03:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "558a3d12212525d7520a30280d656240092df972",
"body": "Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 6.\n- [Release notes](https://github.com/actions/checkout/releases)\n- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)\n- [Commits](https://github.com/actions/checkout/compare/v4...v6)\n\n---\nupdated-dependenc\n[…]\n:\n- dependency-name: actions/checkout\n dependency-version: '6'\n dependency-type: direct:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>",
"is_bot": true,
"headline": "Bump actions/checkout from 4 to 6",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-03-02T17:03:07Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "59ffc8a497f5115fe1a856af80884eab0a74bae5",
"body": "Bumps [goreleaser/goreleaser-action](https://github.com/goreleaser/goreleaser-action) from 6 to 7.\n- [Release notes](https://github.com/goreleaser/goreleaser-action/releases)\n- [Commits](https://github.com/goreleaser/goreleaser-action/compare/v6...v7)\n\n---\nupdated-dependencies:\n- dependency-name: goreleaser/goreleaser-action\n dependency-version: '7'\n dependency-type: direct:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>",
"is_bot": true,
"headline": "Bump goreleaser/goreleaser-action from 6 to 7",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-03-02T17:01:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f9327c504dded047c7136c9c8e1dac20a07d1067",
"body": "Comment out Homebrew tap config until tap repo and secret are ready.\nFix release owner casing to ShovelsAI. Re-add release badge to README.",
"is_bot": false,
"headline": "Prepare for v0.1.0 release",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T16:40:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c7ac1ade1eb08eecd0485883c1a4dddd7fa7a1f7",
"body": "Capitalize title to \"Shovels CLI\". Fix CI badge org casing to match\nactual GitHub org (ShovelsAI). Remove release badge until first tag\nis pushed.",
"is_bot": false,
"headline": "Fix README title and badge URLs",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:46:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "21e1d9c687dc8bacfa6c64324ed43b18c89b7ea6",
"body": "…arch\n\nRestored from the original README — documents that --include-count\nreturns total_count (capped at 10,000) in the meta envelope.",
"is_bot": false,
"headline": "Add --include-count optional flag docs for permits and contractors se…",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:44:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "855ac79efbe00cda1dcb6692f7de384612e4d462",
"body": "Bug report and feature request issue templates. Weekly Dependabot\nupdates for Go modules and GitHub Actions dependencies.",
"is_bot": false,
"headline": "Add GitHub issue templates and Dependabot config",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:43:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "22cebb20f03ef47b47d8f08f52f5a7c078d5eaf9",
"body": "Badges: CI status, latest release, Go Report Card, MIT license.\nNew sections: \"What is this\" value prop, command tree overview for\nLLM scanning, stderr error format with error_type values, platform\ntable for binary downloads, API reference link.",
"is_bot": false,
"headline": "Add production README with badges and agent-friendly structure",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:43:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "83a6ff3c0e05d6af8b619d82b29dc57f2c8d99b9",
"body": "Copyright 2025 Shovels, Inc. Unblocks the license badge in the\nREADME and the Homebrew formula license field in GoReleaser.",
"is_bot": false,
"headline": "Add MIT license",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:43:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2cbd46a3b786acabdf4c204f2d60d72293cfcc34",
"body": null,
"is_bot": false,
"headline": "Fix gofmt trailing newline in config_test.go",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "29d530014e0f859ee60bef5c8457263c2f69e82d",
"body": "Search endpoints can request server-side result counts via the API's\ninclude_count parameter. The count is capped at 10,000 and only\nreturned on the first page of results.",
"is_bot": false,
"headline": "Add --include-count flag for total result counts",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "73d4677b7453dc7a4dbb140a16c6d14791569138",
"body": null,
"is_bot": false,
"headline": "Populate version commit and date from git for local builds",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1e22ac06f97b5b3b3a6bb0a130c8ffdf18f818e8",
"body": null,
"is_bot": false,
"headline": "Update go.mod and SPADE state",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cdb809d4e51c5cb91cc8fa341db6ba9faaff80f5",
"body": "- Add missing exit code 5 (transient/server error) to design principles\n- Fix envelope format docs to match actual {data, meta} structure\n- Add .gitignore for build artifacts, .envrc, and IDE files",
"is_bot": false,
"headline": "Fix stale CLAUDE.md docs and add .gitignore",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7cdb4c50fd4cd48cc46f25fd16d3700a174ff177",
"body": "Security improvement: remove --api-key CLI flag since passing secrets\nvia command-line arguments exposes them in process lists. Auth now\nresolves via SHOVELS_API_KEY env var or config file only.\n\nAdd --version flag via cobra's built-in version support, enabled by\nsetting rootCmd.Version in SetVersionInfo.\n\nUpdate all e2e tests to use env-based auth (withIsolatedConfig sets\nSHOVELS_API_KEY=sk-test, withIsolatedConfigNoAuth clears it) and\nremove all --api-key flag references from test invocations.",
"is_bot": false,
"headline": "Remove --api-key flag and add --version support",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3b9dd312da711ea9ba240d9a878e317a54ee39d6",
"body": "The API parameters are permit_from and permit_to on both\npermits and contractors search endpoints. Aligning flag\nnames with API parameters removes ambiguity about what\ndate range is being filtered.",
"is_bot": false,
"headline": "Rename --from/--to to --permit-from/--permit-to",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8ceb6568da952f297bd24e5f4e5553d48bb222eb",
"body": "The API serves address search at /addresses/search, not\n/addresses. Incorrect path caused 404 responses for all\naddress queries.",
"is_bot": false,
"headline": "Fix addresses search endpoint path",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3d4d562a6058bd0931e5b12f9e92ddfa94d4adf8",
"body": "Users and AI agents need a single document covering\ninstallation, authentication setup, and available commands\nto get started without reading source code.",
"is_bot": false,
"headline": "Add README with install and command reference",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "95c3652d3ae7cf67e24fa97f817053253e9aaf42",
"body": "Multi-platform distribution requires automated build and\nrelease pipelines triggered by git tags. CI validates every\npush and pull request before code reaches main.",
"is_bot": false,
"headline": "Add GoReleaser and GitHub Actions workflows",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "98f66ff2bb2ddf88cf9ecad15668dd661aa72243",
"body": "Full command surface coverage for plain-text and exit-0 assertions\nprevents help regressions across all subcommands. Default value\nassertions ensure global flag documentation stays accurate.",
"is_bot": false,
"headline": "Expand help e2e test coverage",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "837e81e4c5250b5da0dbe145ff44ba15a12b23e0",
"body": "Help text is the primary documentation for AI agents consuming\nthis CLI. Descriptions use concrete language with example values\nand format hints so agents can construct valid commands without\ntrial and error.",
"is_bot": false,
"headline": "Add LLM-optimized help text for all commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bf257d90ce69cc76c2a53179cc68e020b7452fb1",
"body": "Address search and credit usage checking complete the v1\nresource command set. Address search is paginated with a\nquery parameter; usage is a non-paginated single-object\nendpoint for account credit introspection.",
"is_bot": false,
"headline": "Add addresses search and usage commands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6fd40c1f27aa1f79261883614566c4ac6ee4a5be",
"body": "Cobra's ExactArgs(1) validator rejects zero or multiple positional\narguments at the framework level, preventing silent ignore of extra\nargs that violated the single-ID contract.",
"is_bot": false,
"headline": "Enforce exact arg count on contractor subcommands",
"author_name": "Luka Kacil",
"author_login": "lknix",
"committed_at": "2026-03-02T15:08:46Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 10,
"commits_last_year": 135,
"latest_release_at": "2026-07-17T16:00:07Z",
"latest_release_tag": "v0.7.1",
"releases_from_tags": false,
"days_since_last_push": 2,
"active_weeks_last_year": 5,
"days_since_latest_release": 4,
"mean_days_between_releases": 15.2
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": false,
"has_contributing": false,
"health_percentage": 37,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": []
},
"popularity": {
"forks": 0,
"stars": 9,
"watchers": 0,
"fork_history": {
"days": [],
"complete": true,
"collected": 0,
"total_forks": 0
},
"star_history": null,
"open_issues_and_prs": 3
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [
"go.mod"
],
"largest_source_bytes": 83253,
"source_files_sampled": 85,
"oversized_source_files": 1,
"agent_instruction_files": [
"CLAUDE.md"
],
"agent_instruction_max_bytes": 5541
},
"dependencies": {
"manifests": [
"go.mod"
],
"advisories": {
"error": null,
"scope": null,
"source": null,
"findings": [],
"collected": false,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 0,
"malicious_count": 0,
"assessed_package": null,
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"go"
],
"dependencies": [
{
"name": "github.com/creativeprojects/go-selfupdate",
"manifest": "go.mod",
"ecosystem": "go",
"version_constraint": "v1.5.2"
},
{
"name": "github.com/spf13/cobra",
"manifest": "go.mod",
"ecosystem": "go",
"version_constraint": "v1.10.2"
},
{
"name": "github.com/spf13/pflag",
"manifest": "go.mod",
"ecosystem": "go",
"version_constraint": "v1.0.10"
},
{
"name": "gopkg.in/yaml.v3",
"manifest": "go.mod",
"ecosystem": "go",
"version_constraint": "v3.0.1"
}
],
"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": 3,
"merged_prs": 12,
"open_issues": 0,
"closed_ratio": null,
"closed_issues": 0,
"closed_unmerged_prs": 0
},
"bus_factor": 1,
"bot_contributors": 1,
"top_contributors": [
{
"type": "User",
"login": "lknix",
"commits": 131,
"avatar_url": "https://avatars.githubusercontent.com/u/954612?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"release.yml"
],
"has_docs_dir": false,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [
"go.sum"
],
"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": 3,
"reason": "branch protection is not maximal on development and all 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/9 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"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": 10,
"reason": "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": "12 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": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"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": 0,
"reason": "security policy file not 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": 0,
"reason": "15 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "18e79b023de69c64705b3ad9f9548e583a8270be",
"ran_at": "2026-07-22T11:29:16Z",
"aggregate_score": 4.3,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": true
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-20T03:14:51Z",
"oldest_open_prs": [
{
"number": 12,
"created_at": "2026-06-22T03:13:34Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 13,
"created_at": "2026-07-13T03:14:15Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 15,
"created_at": "2026-07-20T03:14:50Z",
"last_comment_at": null,
"last_comment_author": null
}
],
"last_merged_pr_at": "2026-07-17T15:57:18Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/ShovelsAI/shovels-cli",
"host": "github.com",
"name": "shovels-cli",
"owner": "ShovelsAI"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 51,
"inputs": {
"security": 43,
"vitality": 77,
"community": 31,
"governance": 45,
"engineering": 53
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 77,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "moderate",
"name": "Development activity",
"note": null,
"notes": [],
"value": 68,
"inputs": {
"commits_last_year": 135,
"human_commit_share": 0.96,
"days_since_last_push": 2,
"active_weeks_last_year": 5
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 2 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 2
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "5/52 weeks with commits",
"points": 3.5,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 5
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "135 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 135
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "12 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": 10,
"latest_release_tag": "v0.7.1",
"releases_from_tags": false,
"days_since_latest_release": 4,
"mean_days_between_releases": 15.2
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "10 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 10
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 4 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 4
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~15.2 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 15.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": 31,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 15,
"inputs": {
"forks": 0,
"stars": 9,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "9 stars",
"points": 14.6,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 9
}
}
],
"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": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 50,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"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": 0,
"status": "missed",
"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
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "at_risk",
"name": "Sustainability & Governance",
"value": 45,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 13,
"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 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": "Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"issue_resolution"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 72,
"inputs": {
"merged_prs": 12,
"open_issues": 0,
"closed_issues": 0,
"issue_closed_ratio": null,
"closed_unmerged_prs": 0
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "no issues or no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_issues_or_data",
"params": {}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "12/12 decided PRs merged",
"points": 38.2,
"status": "met",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 12,
"decided": 12
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/9 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 56,
"inputs": {
"followers": 14,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "ShovelsAI",
"public_repos": 4,
"account_age_days": 3978
},
"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": "14 followers of ShovelsAI",
"points": 8.5,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 14,
"login": "ShovelsAI"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "4 public repos, account ~10 yr old",
"points": 17.1,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 4
}
},
{
"code": "account_age_years",
"params": {
"years": 10
}
}
],
"max_points": 25
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "moderate",
"name": "Engineering Quality",
"value": 53,
"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": "2 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 2
}
}
],
"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": "at_risk",
"name": "Documentation",
"note": null,
"notes": [],
"value": 30,
"inputs": {
"topics": [],
"has_wiki": false,
"homepage": null,
"has_readme": true,
"has_docs_dir": false,
"has_description": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 43,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": null,
"notes": [],
"value": 43,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 18,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 0,
"scorecard_aggregate": 4.3
},
"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 is not maximal on development and all release branches",
"points": 2.2,
"status": "partial",
"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/9 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"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": "update tool detected",
"points": 7.5,
"status": "met",
"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": "12 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 0",
"points": 0,
"status": "missed",
"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 not detected",
"points": 0,
"status": "missed",
"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": "15 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 1
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"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": "good",
"name": "AI Readiness",
"value": 78,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "excellent",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.906,
"agent_instruction_files": [
"CLAUDE.md"
],
"agent_instruction_max_bytes": 5541
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "CLAUDE.md"
}
}
],
"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": "87 of 96 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 87,
"sampled": 96
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "moderate",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 64,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [
"go.sum"
],
"has_dockerfile": false,
"typed_language": true,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [],
"agent_commit_share": 0,
"toolchain_manifests": [
"go.mod"
],
"dependency_bot_commit_share": 0.04
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": "go.mod (toolchain convention, no task runner)",
"points": 12.6,
"status": "partial",
"details": [
{
"code": "toolchain_convention",
"params": {
"files": "go.mod"
}
}
],
"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": "Go (statically typed)",
"points": 11,
"status": "met",
"details": [
{
"code": "statically_typed_language",
"params": {
"language": "Go"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "lockfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "lockfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no agent-authored commits among the last 100",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_authored_commits",
"params": {
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "4 of the last 100 commits are automated dependency updates",
"points": 8,
"status": "met",
"details": [
{
"code": "dependency_bot_commits",
"params": {
"count": 4,
"sampled": 100
}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "excellent",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 99,
"inputs": {
"primary_language": "Go",
"largest_source_bytes": 83253,
"source_files_sampled": 85,
"oversized_source_files": 1
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Go (statically typed)",
"points": 45,
"status": "met",
"details": [
{
"code": "statically_typed_language",
"params": {
"language": "Go"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "1/85 source files over 60KB",
"points": 54.4,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 85,
"oversized": 1
}
}
],
"max_points": 55
}
]
}
],
"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": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"Could not fetch go package 'github.com/shovels-ai/shovels-cli' from its registry",
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-07-22T11:29:30.705561Z",
"schema_version": "0.26.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/s/ShovelsAI/shovels-cli.svg",
"full_name": "ShovelsAI/shovels-cli",
"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.26.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics.