Repository navigation
Expand file tree
/
Copy pathdocs.html
More file actions
177 lines (160 loc) · 11.7 KB
/
Copy pathdocs.html
File metadata and controls
177 lines (160 loc) · 11.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Developer Docs — Upsilon API & MCP</title>
<meta name="description" content="Upsilon developer resources: OpenAPI, MCP, CLI, content-free telemetry, and MO§ES™ governance constraints.">
<link rel="canonical" href="https://mos2es.org/docs">
<link rel="icon" type="image/svg+xml" href="favicon.svg">
<meta property="og:type" content="website">
<meta property="og:url" content="https://mos2es.org/docs">
<meta property="og:title" content="Upsilon Developer Docs">
<meta property="og:description" content="OpenAPI spec, MCP server, 27 tools, CLI, TUI for AI agent integration.">
<meta property="og:image" content="https://mos2es.org/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:image" content="https://mos2es.org/og-image.png">
<meta property="og:site_name" content="MO§ES™">
<link rel="stylesheet" href="style.css">
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "TechArticle",
"headline": "Upsilon Developer Documentation",
"url": "https://mos2es.org/docs",
"author": {"@id": "https://mos2es.org/#org"},
"publisher": {"@id": "https://mos2es.org/#org"},
"about": {"@id": "https://mos2es.org/#software"}
}
</script>
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebSite","@id":"https://mos2es.org/#website","name":"MO§ES™","url":"https://mos2es.org","publisher":{"@id":"https://mos2es.org/#org"}}
</script>
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://mos2es.org/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https://mos2es.org/docs"}]}
</script>
<script>!function(t,e){var o,n,p,r;e.__SV||(window.posthog&&window.posthog.__loaded)||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}p||((p=t.createElement("script")).type="text/javascript",p.crossOrigin="anonymous",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",p.onerror=function(){p=null},(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r));var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="init capture register register_once register_for_session unregister unregister_for_session getFeatureFlag getFeatureFlagResult isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty createPersonProfile opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing clear_opt_in_out_capturing debug".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);posthog.init("phc_DosVqZCDFVNghfXCfLQBHG5ZpntSRmzrJZRzhKLMqTkh",{api_host:"https://us.i.posthog.com",capture_pageview:true,capture_pageleave:true});</script>
</head>
<body>
<div class="wrap">
<nav>
<b>Upsilon</b>
<div class="links">
<a href="index.html">Home</a>
<a href="product.html">Product</a>
<a href="pilot.html">Pilot</a>
<a href="methodology.html">Methodology</a>
<a href="research.html">Research</a>
<a href="contact.html">Contact</a>
</div>
</nav>
<main>
<h1>Developer Documentation</h1>
<p>Developer documentation for Upsilon, the commercial AI processing measurement engine. Upsilon exposes MCP, OpenAPI, and CLI integration surfaces; MO§ES™ governs interpretation and permitted use; SigRank is the separate public leaderboard and proof surface.</p>
<h2>OpenAPI Specification</h2>
<p>The full API specification is available at <a href="openapi.json"><code>/openapi.json</code></a>. It describes 8 read endpoints and 5 write endpoints across the pilot evaluation surface.</p>
<ul>
<li><strong>Read endpoints (8):</strong> pilot status, operator profile, cohort distribution, composite score, composite score summary, diagnostics, data quality, executive dashboard</li>
<li><strong>Write endpoints (5):</strong> assign intervention, close intervention, create experiment, record workflow observation, attach outcome dataset — all require authorization</li>
</ul>
<h2>MCP Server</h2>
<p>Upsilon ships a Model Context Protocol server with 27 tools (22 read, 5 write), 6 resources, and 5 prompts. The MCP server allows Claude, ChatGPT, Cursor, and other AI agents to call the governed measurement platform natively.</p>
<ul>
<li><strong>Read tools (22):</strong> pilot status, operator profile, cohort distribution, composite score, composite score summary, diagnostics, data quality, usage-operation divergence, workflow fit, intervention status, pilot options, configuration validation, operator comparison, executive dashboard, verify change, create pilot configuration, operator system decomposition, lineage chain, lineage summary, outcome correlation, org topology, operator similarity</li>
<li><strong>Write tools (5):</strong> assign intervention, close intervention, create experiment, record workflow observation, attach outcome dataset — all require authorization</li>
</ul>
<p><strong>Live endpoint:</strong> <code>https://mcp.mos2es.org/mcp</code> (Streamable HTTP)</p>
<p><strong>Server info:</strong> <a href="https://mcp.mos2es.org/">https://mcp.mos2es.org/</a></p>
<p><strong>Transport:</strong> Streamable HTTP (remote) or stdio (local via Python SDK)</p>
<p><strong>SDK:</strong> Python MCP SDK (FastMCP) for local, Cloudflare Worker for remote</p>
<h3>Quick start</h3>
<pre><code># Initialize
curl -X POST https://mcp.mos2es.org/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'
# List tools
curl -X POST https://mcp.mos2es.org/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'
# Call a tool
curl -X POST https://mcp.mos2es.org/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_pilot_status","arguments":{}},"id":3}'</code></pre>
<h3>Tool list</h3>
<table>
<tr><th>Tool</th><th>Type</th><th>Description</th></tr>
<tr><td>get_pilot_status</td><td>read</td><td>Cohort size, observation count, date range, data quality</td></tr>
<tr><td>get_operator_profile</td><td>read</td><td>Operator metrics, percentiles, benchmarks, divergence flags</td></tr>
<tr><td>get_cohort_distribution</td><td>read</td><td>Percentile bands for a metric across the cohort</td></tr>
<tr><td>get_composite_score</td><td>read</td><td>0-100 developmental score (DEVELOPMENTAL, not PERSONNEL)</td></tr>
<tr><td>get_composite_score_summary</td><td>read</td><td>Aggregate score distribution (no individual rankings)</td></tr>
<tr><td>get_diagnostics</td><td>read</td><td>Pattern detections and diagnoses (HYPOTHESIS, never fact)</td></tr>
<tr><td>get_data_quality</td><td>read</td><td>Completeness, coverage, validity metrics</td></tr>
<tr><td>find_usage_operation_divergence</td><td>read</td><td>Usage vs operation divergence flags</td></tr>
<tr><td>get_workflow_fit</td><td>read</td><td>Operator-workflow fit analysis</td></tr>
<tr><td>get_intervention_status</td><td>read</td><td>Active and closed interventions</td></tr>
<tr><td>list_pilot_options</td><td>read</td><td>Available metrics, eval families, benchmark classes</td></tr>
<tr><td>validate_pilot_configuration</td><td>read</td><td>Validate a pilot config before deployment</td></tr>
<tr><td>compare_operator_to_reference</td><td>read</td><td>Compare operator to reference population</td></tr>
<tr><td>get_executive_dashboard</td><td>read</td><td>Self-contained HTML dashboard</td></tr>
<tr><td>verify_change</td><td>read</td><td>Verify a measured change after intervention</td></tr>
<tr><td>create_pilot_configuration</td><td>read</td><td>Generate a pilot configuration from parameters</td></tr>
<tr><td>assign_intervention</td><td>write</td><td>Assign intervention to operator (requires auth)</td></tr>
<tr><td>close_intervention</td><td>write</td><td>Close an intervention with outcome notes (requires auth)</td></tr>
<tr><td>create_experiment</td><td>write</td><td>Create an experiment configuration (requires auth)</td></tr>
<tr><td>record_workflow_observation</td><td>write</td><td>Record a workflow fit observation (requires auth)</td></tr>
<tr><td>attach_outcome_dataset</td><td>write</td><td>Attach external outcome dataset (ASSOCIATION, never CAUSATION) (requires auth)</td></tr>
</table>
<h2>CLI</h2>
<p>The <code>enterprise</code> CLI provides 14 command groups for direct access to all platform functionality:</p>
<pre><code>enterprise status
enterprise operator <id>
enterprise cohort --metric leverage
enterprise score composite <operator_id>
enterprise score composite-summary
enterprise benchmark operator <id> --metric leverage
enterprise benchmark cohort --metric leverage
enterprise diagnose <operator_id>
enterprise intervene assign <operator_id> --type <type>
enterprise export dashboard --output dashboard.html
enterprise ingest claude --file <path>
enterprise ingest api-groq --operator op_001 --days 30</code></pre>
<h2>Canonical Telemetry</h2>
<p>The platform operates on content-free token counts — no prompt text required:</p>
<ul>
<li><strong>INPUT (I):</strong> tokens sent to the AI system</li>
<li><strong>OUTPUT (O):</strong> tokens received from the AI system</li>
<li><strong>CACHE READ (R):</strong> tokens reused from context cache</li>
<li><strong>CACHE WRITE (W):</strong> tokens written to context cache</li>
</ul>
<h2>Metrics</h2>
<ul>
<li><strong>Leverage:</strong> (R + W) / I — context reuse and building relative to new input</li>
<li><strong>Yield:</strong> O / (I + O + R + W) — productive output share of total token flow</li>
<li><strong>Token SNR:</strong> signal-to-noise ratio in token flow</li>
<li><strong>Log Leverage:</strong> log-scaled leverage variant</li>
<li><strong>Construction:</strong> W / R — ratio of new context built to context reused</li>
</ul>
<h2>Governance Constraints</h2>
<ul>
<li>All composite scores labeled DEVELOPMENTAL, not PERSONNEL</li>
<li>All diagnoses labeled HYPOTHESIS, never fact</li>
<li>All outcome joins labeled ASSOCIATION, never CAUSATION</li>
<li>No bottom-employee leaderboard</li>
<li>No automatic adverse employment actions</li>
<li>No punitive labels</li>
<li>Write operations require authorization</li>
</ul>
<h2>Repository</h2>
<p>Public site repo: <a href="https://github.com/SunrisesIllNeverSee/moses">github.com/SunrisesIllNeverSee/moses</a> (public)</p>
<h2>Contact</h2>
<p>Email: burnmydays@proton.me</p>
</main>
<footer>
<p>Upsilon — Enterprise AI Processing Diagnostics · Governed by MO§ES™ · <a href="index.html">Home</a> · <a href="product.html">Product</a> · <a href="pilot.html">Pilot</a> · <a href="methodology.html">Methodology</a> · <a href="research.html">Research</a> · <a href="contact.html">Contact</a> · <a href="about.html">About</a> · <a href="privacy.html">Privacy</a> · <a href="docs.html">Docs</a></p>
</footer>
</div>
</body>
</html>