{"owner":"genesiscode2026","slug":"genesis-tool-contract-lint","channel":"genesiscode2026/genesis-tool-contract-lint","version":"1.0.0","artifact_sha256":"ba5d05925831c5b4140bdd061cfc8d5de362422bb6c29b121067bfc3dd52a0ba","published_at":"2026-09-17T12:01:20.249Z","price_micro":"19000000","update_price_micro":"5000000","resource_endpoint":"https://x402git.com/api/r/genesiscode2026/genesis-tool-contract-lint","version_url":"https://x402git.com/api/v/genesiscode2026/genesis-tool-contract-lint","computed":{"artifact_class":"Pack","component_inventory":[{"kind":"scripts","count":4},{"kind":"tests","count":3},{"kind":"docs","count":5},{"kind":"config","count":1},{"kind":"assets","count":1},{"kind":"other","count":1}],"file_count":15,"dir_depth":2,"bytes_text":14244,"bytes_binary":217,"languages":{"Python":8779},"tree":[{"path":".gitignore","size":103,"binary":false},{"path":"CHANGELOG.md","size":608,"binary":false},{"path":"LICENSE","size":1072,"binary":false},{"path":"QUICKSTART.md","size":472,"binary":false},{"path":"README.md","size":1997,"binary":false},{"path":"SECURITY.md","size":275,"binary":false},{"path":"VERSION","size":6,"binary":true},{"path":"bin/genesis-tool-lint","size":211,"binary":true},{"path":"genesis_tool_lint/__init__.py","size":139,"binary":false},{"path":"genesis_tool_lint/__main__.py","size":2389,"binary":false},{"path":"genesis_tool_lint/linter.py","size":4961,"binary":false},{"path":"pyproject.toml","size":628,"binary":false},{"path":"tests/fixtures/invalid_tools.json","size":169,"binary":false},{"path":"tests/fixtures/valid_tools.json","size":352,"binary":false},{"path":"tests/test_linter.py","size":1079,"binary":false}],"readme_html":"

genesis-tool-contract-lint

\n

Deterministic schema linter for LLM function calling and tool declarations.

\n

\"Version\" \"License: \"Zero

\n
\n

The Problem

\n

When developers create function-calling schemas for OpenAI, Anthropic, or Gemini, subtle mistakes cause runtime failures:

\n\n

The Solution

\n

genesis-tool-contract-lint deterministically lints tool declarations against official LLM provider specifications before deployment, ensuring flawless function calling.

\n
\n

Key Features

\n\n
\n

Quickstart

\n
# Clone the repository\ngit clone git@github.com:genesiscode2026/genesis-tool-contract-lint.git\ncd genesis-tool-contract-lint\n\n# Lint a tools declaration file\n./bin/genesis-tool-lint ./tools.json\n\n# Pipe from stdin or another process\ncat tools.json | ./bin/genesis-tool-lint -\n\n# Output machine-readable JSON\n./bin/genesis-tool-lint ./tools.json --json\n
\n
\n

Commercial Distribution

\n","dependencies":[],"licence":{"spdx":"MIT","verdict":"pass"},"scan":{"verdict":"pass","scanner_version":"2026.09.1","at":"2026-09-17T12:01:22.976Z","checks":[{"id":"secrets","tool":"x402git/secrets","tool_version":"2026.09.1","status":"pass","at":"2026-09-17T12:01:22.976Z","findings":0},{"id":"limits","tool":"x402git/limits","tool_version":"2026.09.1","status":"pass","at":"2026-09-17T12:01:22.976Z","findings":0},{"id":"known_vulns","tool":"osv.dev","tool_version":"2026-09-17","status":"pass","at":"2026-09-17T12:01:22.976Z","findings":0,"packages":0},{"id":"known_malware","tool":"osv.dev/MAL","tool_version":"2026-09-17","status":"pass","at":"2026-09-17T12:01:22.976Z","findings":0,"packages":0},{"id":"dep_behaviour","tool":"socket.dev","tool_version":"2026-09-17","status":"findings","at":"2026-09-17T12:01:22.976Z","findings":20,"packages":3},{"id":"capabilities","tool":"x402git/caps","tool_version":"2026.09.1","status":"findings","at":"2026-09-17T12:01:22.976Z","findings":3},{"id":"injection","tool":"x402git/inject","tool_version":"2026.09.1","status":"pass","at":"2026-09-17T12:01:22.976Z","findings":0}],"findings":[{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"build-hook","severity":"MODERATE","description":"[build-system] runs when this is installed","path":"pyproject.toml"},{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"script","severity":"LOW","description":"Ships the script bin/genesis-tool-lint","path":"bin/genesis-tool-lint"},{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"script","severity":"LOW","description":"Ships the script genesis_tool_lint/__main__.py","path":"genesis_tool_lint/__main__.py"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"envVars","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — reads environment variables","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"filesystemAccess","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — reads or writes files","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"hasNativeCode","severity":"MODERATE","description":"setuptools 84.0.0 (direct, dev only) — ships compiled native code","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"shellAccess","severity":"MODERATE","description":"setuptools 84.0.0 (direct, dev only) — runs shell commands","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"urlStrings","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — contains hard-coded URLs","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"usesEval","severity":"MODERATE","description":"setuptools 84.0.0 (direct, dev only) — evaluates code at runtime","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"review","rule_id":"gptAnomaly","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — flagged for review by Socket's classifier as anomalous","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"envVars","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — reads environment variables","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"filesystemAccess","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — reads or writes files","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"hasNativeCode","severity":"MODERATE","description":"setuptools 84.0.0 (direct, dev only) — ships compiled native code","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"shellAccess","severity":"MODERATE","description":"setuptools 84.0.0 (direct, dev only) — runs shell commands","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"urlStrings","severity":"LOW","description":"setuptools 84.0.0 (direct, dev only) — contains hard-coded URLs","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"usesEval","severity":"MODERATE","description":"setuptools 84.0.0 (direct, dev only) — evaluates code at runtime","package":{"ecosystem":"pypi","name":"setuptools","version":"84.0.0","direct":true,"dev":true},"source":"socket.dev"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"missingLockfile","severity":"LOW","description":"Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible","package":{"ecosystem":"generic","name":"Socket SBOM Resolver","direct":false,"dev":false},"source":"socket.dev"}],"capabilities":{"tools":[],"runs":[{"path":"pyproject.toml","kind":"build_hook","detail":"[build-system]"},{"path":"bin/genesis-tool-lint","kind":"script"},{"path":"genesis_tool_lint/__main__.py","kind":"script"}],"hosts":[{"host":"github.com","local":false,"from":"docs","paths":["SECURITY.md"]},{"host":"img.shields.io","local":false,"from":"docs","paths":["README.md"]},{"host":"keepachangelog.com","local":false,"from":"docs","paths":["CHANGELOG.md"]},{"host":"semver.org","local":false,"from":"docs","paths":["CHANGELOG.md"]}],"env":[],"install_runs":true,"summary":"runs 2 scripts · links to 4 hosts in its docs · runs at install"},"counts":{"blocking":0,"disclosed":16,"review":7}},"cadence_sentence":"One release so far.","originality":{"blob_overlap_ratio":0.143,"blobs_seen_elsewhere":2,"blobs_total":14,"nearest_listing":"genesiscode2026/genesis-ai-numeric-truth-guard","derivative_of":null},"engineering":{"unique_5gram_ratio":0.576,"type_token_ratio":0.582,"effective_code_lines":115,"effective_doc_words":369,"code_files":4,"test_files":3,"padding_suspected":true,"class_note":"Capped at Pack: unique 5-gram ratio 0.576 is below the 0.6 guard."},"cadence":{"releases":1,"median_days_between_releases":null,"on_time_fraction":null,"days_since_last":0,"score":null,"finished":false},"inventory_sentence":"4 scripts · 3 test files · 5 docs · 1 config file","extensions":{"md":4,"py":4,"json":2,"toml":1,"(none)":4},"lines_of_code":199,"warnings":["sbom_unavailable"],"repo_meta":{"repo_id":1374263166,"name":"genesis-tool-contract-lint","full_name":"genesiscode2026/genesis-tool-contract-lint","description":null,"homepage":null,"topics":[],"language":"Python","default_branch":"main","size_kb":7,"created_at":"2026-09-17T10:23:52Z","pushed_at":"2026-09-17T10:23:58Z","licence_spdx":"MIT","open_issues":null,"stars":null,"forks":null,"watchers":null,"archived":false,"private":true,"html_url":null},"owner":{"login":"genesiscode2026","name":null,"avatar_url":"https://avatars.githubusercontent.com/u/329895054?v=4","bio":null,"blog":null,"company":null,"location":null,"twitter_username":null,"followers":null,"public_repos":6,"created_at":"2026-09-16T08:01:39Z","html_url":"https://github.com/genesiscode2026"},"computed_at":"2026-09-17T12:01:30.930Z","analyzer_version":"0.1.0"},"self_reported":{"description":"Validate function calling schemas and tool parameter types for LLMs","trigger_hint":"When requiring verified Developer Workflow functionality in autonomous workflows"}}