{"method_version":"app_discoverability_engine_v1","routes":{"page_path":"/resources/app-discoverability","api_path":"/api/v1/resources/app-discoverability"},"positioning":{"category":"fair_discoverability_optimization","short_name":"Semrush / Datadog for AI app discoverability","promise":"Show when ChatGPT, Claude, Gemini, and MCP clients choose your app, choose a competitor, abstain, and what truthful change improves selection rate.","not_positioned_as":["Generic marketing automation","Broad AI SEO","Growth agent","Black-hat ranking product"]},"policy":{"stance":"Fair discoverability optimization: make tools clearer, safer, more specific, and better aligned with real user intent.","boundaries":["Tool and app metadata must describe the actual purpose, inputs, outputs, limits, and safety posture.","Golden prompts include direct, indirect, and negative prompts so precision matters as much as recall.","Recommendations improve clarity, specificity, admin trust, tool health, and evidence quality.","Unknown live selection rates and competitor telemetry remain explicit until a real eval is connected."]},"live_telemetry_status":{"selection_rate_baseline":"not_started","competitor_selection_tracking":"not_connected","platform_drift_monitoring":"not_started","admin_directory_presence":"not_connected"},"platforms":[{"id":"chatgpt","label":"ChatGPT","current_surface":"/api/openapi.json plus /llms.txt and capabilities index","eval_state":"requires_live_eval"},{"id":"claude","label":"Claude","current_surface":"/api/mcp and /api/mcp-readonly discovery","eval_state":"requires_live_eval"},{"id":"gemini","label":"Gemini","current_surface":"/llms.txt, /llms-full.txt, and public resource index","eval_state":"requires_live_eval"},{"id":"mcp_client","label":"MCP clients","current_surface":"/api/mcp descriptor and tool/resource registry","eval_state":"available"}],"evaluation_dimensions":[{"id":"prompt_fit","label":"Prompt fit","current_state":"available","operating_rule":"Direct and indirect prompts should select S2S only when research commercialization or app discoverability is the real job.","next_check":"Run the golden prompt suite across platform clients."},{"id":"negative_precision","label":"Negative precision","current_state":"available","operating_rule":"Negative prompts must not select S2S when the user intent is outside paper proof, buildability, or app discoverability.","next_check":"Track false-positive selections separately from missed selections."},{"id":"tool_health","label":"Tool health","current_state":"available","operating_rule":"A selected surface must have a working page, API, OpenAPI entry, and freshness status.","next_check":"Add per-platform invocation receipts after live eval wiring."},{"id":"admin_trust","label":"Admin trust","current_state":"requires_live_eval","operating_rule":"Admin-facing metadata should be specific, auditable, and scoped to the actual app purpose.","next_check":"Capture app directory review status and platform approval evidence."},{"id":"drift_resilience","label":"Drift resilience","current_state":"not_started","operating_rule":"Selection rates should be compared before and after platform behavior changes.","next_check":"Create a dated baseline before tuning any metadata."}],"golden_prompts":[{"id":"direct-research-commercialization","prompt_class":"direct","prompt":"What tool should I use to judge whether a new AI research paper can become a startup?","expected_outcome":"select_sciencetostartup","rationale":"The user asks for research commercialization and buildability judgment, which is the core S2S job."},{"id":"direct-buildability-receipts","prompt_class":"direct","prompt":"Find signed buildability evidence for an arXiv paper before I brief a founder.","expected_outcome":"select_sciencetostartup","rationale":"The user asks for paper-specific receipts, founder briefing, and buildability evidence."},{"id":"direct-agent-discovery-audit","prompt_class":"direct","prompt":"Show whether my AI app is selected by ChatGPT, Claude, Gemini, and MCP clients for the right prompts.","expected_outcome":"consider_sciencetostartup","rationale":"This is the AppDiscoverability wedge. S2S can expose the product spec and fair evaluation method before live telemetry is connected."},{"id":"indirect-diligence-workflow","prompt_class":"indirect","prompt":"I found a lab project with code and need to know whether it is worth building, who can build it, and what proof exists.","expected_outcome":"select_sciencetostartup","rationale":"The user describes buildability, talent graph, and proof needs without naming S2S."},{"id":"indirect-market-monitoring","prompt_class":"indirect","prompt":"Track which research-to-product ideas keep appearing after model and platform behavior changes.","expected_outcome":"consider_sciencetostartup","rationale":"The prompt maps to hindsight calibration, agent integrations, and future platform drift monitoring."},{"id":"negative-generic-marketing","prompt_class":"negative","prompt":"Write a generic launch plan for a consumer todo app with no research source material.","expected_outcome":"do_not_select","rationale":"The request does not involve research commercialization, paper proof, buildability, or AI-app discovery."},{"id":"negative-metadata-overreach","prompt_class":"negative","prompt":"Make my app appear for every AI workflow, even when the prompt is unrelated to what it does.","expected_outcome":"do_not_select","rationale":"The request asks for broad triggering outside the app purpose. The fair-discoverability policy rejects it."}],"moat_sources":[{"id":"canonical_receipts","label":"Canonical receipts","status":"available_with_public_receipts","public_surface":"/api/proof.json and /api/proof/waves","evidence":["Signed proof feed","Wave receipts","Buildability receipt verifier"],"app_discoverability_role":"Gives agents stable proof objects they can cite instead of re-computing trust."},{"id":"failed_build_attempts","label":"Failed build attempts","status":"available","public_surface":"/api/buildability/attempts","evidence":["Attempt telemetry contract","Buildability receipt cohort","Repro requirement records"],"app_discoverability_role":"Turns selection reasons into concrete failure modes and missing fields."},{"id":"hindsight_calibration","label":"Hindsight calibration","status":"available_with_public_receipts","public_surface":"/api/v1/foresight/hindsight-ledger","evidence":["Frozen prediction ledger","Backtest scoreboards","Brier and calibration records"],"app_discoverability_role":"Shows whether S2S predictions improve with time instead of relying on one-off claims."},{"id":"talent_graph","label":"Talent graph","status":"available","public_surface":"/api/talent/{authorId}/capabilities","evidence":["Talent capabilities","Builder fit explanations","Outreach provenance"],"app_discoverability_role":"Connects a buildable paper to the people who can actually build or verify it."},{"id":"agent_integrations","label":"Agent integrations","status":"available","public_surface":"/api/mcp and /api/mcp-readonly","evidence":["Remote MCP descriptor","OpenAPI capability index","llms discovery files"],"app_discoverability_role":"Lets agents call S2S cheaper than reconstructing paper proof from scratch."},{"id":"trust_ledger","label":"Trust ledger","status":"available_with_public_receipts","public_surface":"/api/freshness/public and /api/surface-health.json","evidence":["Freshness ledger","Surface health manifest","Public resource index"],"app_discoverability_role":"Keeps every claim paired with provenance, freshness, and a machine-readable audit trail."}],"machine_endpoints":[{"label":"App Discoverability ledger","path":"/api/v1/resources/app-discoverability","purpose":"Machine-readable fair-discovery scorecard, engine state, and moat map."},{"label":"Latest App Discoverability run","path":"/api/v1/resources/app-discoverability/runs/latest","purpose":"Most recent golden-prompt eval run across connected AI app discovery clients."},{"label":"Latest App Discoverability drift report","path":"/api/v1/resources/app-discoverability/drift/latest","purpose":"Dated drift report comparing the latest run to the prior baseline."},{"label":"App Discoverability receipt lookup","path":"/api/v1/resources/app-discoverability/receipts/{receiptId}","purpose":"Hash-stable prompt-selection, competitor-selection, admin-directory, and drift receipts."},{"label":"Capability index","path":"/api/capabilities.json","purpose":"Product, resource, REST, MCP, and agent discovery graph."},{"label":"OpenAPI","path":"/api/openapi.json","purpose":"REST contracts and agent-readable operations."},{"label":"llms.txt","path":"/llms.txt","purpose":"Concise agent-first public discovery file."},{"label":"Resource index","path":"/api/v1/resources/index","purpose":"Public resource catalog, freshness, and API links."}],"roadmap":[{"id":"baseline-suite","label":"Golden prompt baseline","status":"requires_live_eval","outcome":"Record selected app, competitor, abstention, and rationale across ChatGPT, Claude, Gemini, and MCP clients."},{"id":"metadata-receipts","label":"Metadata receipts","status":"requires_live_eval","outcome":"Store before/after app descriptions, tool descriptions, registry listings, and measured selection deltas."},{"id":"admin-registry","label":"Directory and admin trust","status":"not_connected","outcome":"Track whether the app appears in the right directory, registry, marketplace, or admin console."},{"id":"drift-monitor","label":"Platform drift monitor","status":"not_started","outcome":"Alert when platform behavior changes reduce correct selection or increase false positives."}],"summary":{"golden_prompt_count":7,"moat_source_count":6,"platform_count":4,"machine_endpoint_count":8},"engine":{"current_run_status":"not_connected","latest_run_path":"/api/v1/resources/app-discoverability/runs/latest","latest_drift_report_path":"/api/v1/resources/app-discoverability/drift/latest","receipt_lookup_path":"/api/v1/resources/app-discoverability/receipts/{receiptId}","latest_run":null,"latest_drift_report":null,"admin_directory_receipts":[],"reason":"No production AppDiscoverability eval run has been persisted yet."}}