Code Synapse — Fit Repo Finder

{'type': 'object', 'required': ['need'], 'properties': {'need': {'type': 'string', 'maxLength': 200, 'description': 'Capability need, e.g. "job queue with retry for node.js". No project names, paths, or secrets.'}, 'strict': {'type': 'boolean', 'default': False, 'description': 'also exclude candidates whose required constraint fields are unknown'}, 'telemetry': {'enum': ['none', 'aggregate', 'debug'], 'default': 'aggregate', 'description': 'aggregate stores zero user text (outcome counters only); debug also stores the need for 30 days'}, 'exclusions': {'type': 'array', 'items': {'type': 'string'}}, 'constraints': {'type': 'object', 'properties': {'auth': {'type': 'object', 'required': ['allow'], 'properties': {'allow': {'type': 'array', 'items': {'type': 'string'}, 'description': 'accepted auth models: none, local-credential, api-key, cloud-account, oauth2'}, 'required': {'type': 'boolean', 'default': False}}}, 'license': {'type': 'object', 'required': ['allow_spdx'], 'properties': {'required': {'type': 'boolean', 'default': False}, 'allow_spdx': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'SPDX allow-list, e.g. ["MIT","Apache-2.0","GPL-3.0"]. Judged against the GitHub-observed spdx_id; matching ignores case and treats the GNU "-only"/"-or-later" suffixes as equivalent (GitHub cannot distinguish them). Verdict is "unknown" in three cases: GitHub could not identify the license (NOASSERTION), GitHub found no license file at the repo root (NONE — see the candidate\'s license field; GitHub only detects root-level license files), or it is not collected yet'}, 'runtime': {'type': 'object', 'required': ['value'], 'properties': {'value': {'type': 'string', 'description': 'e.g. binary-cli, docker-server, browser, python-lib'}, 'required': {'type': 'boolean', 'default': True}}}, 'protocols': {'type': 'object', 'required': ['any_of'], 'properties': {'any_of': {'type': 'array', 'items': {'type': 'string'}}, 'required': {'type': 'boolean', 'default': True}}}, 'pushed_within_days': {'type': 'integer', 'minimum': 1, 'description': 'hard filter on last push (observed)'}}, 'description': 'Minimal project constraints. Each verdict comes back as pass|fail|unknown per candidate.', 'additionalProperties': False}, 'max_candidates': {'type': 'integer', 'default': 12, 'maximum': 20, 'minimum': 1}, 'existing_components': {'type': 'array', 'items': {'type': 'string'}, 'description': 'owner/repo you already use — excluded and counted as already_have'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['contract_version', 'outcome', 'corpus', 'candidates', 'rejected_summary'], 'properties': {'corpus': {'type': 'object', 'properties': {'revision': {'type': ['string', 'null']}, 'min_stars': {'type': 'integer'}, 'served_nodes': {'type': 'integer'}, 'coverage_note': {'type': 'string'}}}, 'outcome': {'enum': ['candidates', 'constrained_out', 'no_hit']}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'flags': {'type': 'array', 'items': {'type': 'string'}}, 'roles': {'type': 'array', 'items': {'type': 'string'}}, 'stars': {'type': 'integer'}, 'world': {'type': ['string', 'null']}, 'license': {'type': ['string', 'null'], 'description': 'GitHub-observed SPDX id (GitHub emits the deprecated GNU short ids, e.g. "GPL-3.0" not "GPL-3.0-only"). "NOASSERTION" = a LICENSE file exists but GitHub could not identify it; "NONE" = GitHub found no license file at the repo *root* — it does not look in subdirectories or the README, so this is not proof the project is unlicensed (judged "unknown", not "fail"; if genuinely absent, default copyright applies — confirm in the repo); null = not collected yet. All three yield an "unknown" verdict'}, 'summary': {'type': 'string'}, 'followups': {'type': 'array', 'items': {'type': 'string'}}, 'protocols': {'type': 'array', 'items': {'type': 'string'}}, 'pushed_at': {'type': ['string', 'null']}, 'rank_reasons': {'type': 'array', 'items': {'type': 'string'}}, 'evidence_basis': {'type': 'object', 'description': 'observed = GitHub API fact; inferred = model-extracted from README (verify before adopting)', 'additionalProperties': {'enum': ['observed', 'inferred']}}, 'constraint_results': {'type': 'object', 'additionalProperties': {'enum': ['pass', 'fail', 'unknown']}}}}}, 'relaxation': {'type': 'array', 'items': {'type': 'object', 'properties': {'drop': {'type': 'string'}, 'recovers': {'type': 'integer'}}}, 'description': 'present on constrained_out: real recount when dropping one constraint'}, 'no_hit_guidance': {'type': 'string'}, 'contract_version': {'type': 'string'}, 'rejected_summary': {'type': 'object', 'properties': {'already_have': {'type': 'integer'}, 'by_constraint': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'unknown_flagged': {'type': 'integer'}}}}}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Short keyword phrase, e.g. "music server", "vector db", "scraping". No project names, paths, or secrets.'}}}