@topline-build/harness-mcp 0.9.12 → 0.9.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,16 @@
2
2
 
3
3
  All notable customer-visible Build MCP changes are recorded here. A source change is not a published package or customer release.
4
4
 
5
+ ## 0.9.14 - 2026-11-11
6
+
7
+ - `platform_wait_artifact_deploy` names the build's failure code (`artifact_deploy_failed:<code>`) instead of only `failed`, and its recovery says to read `platform_deploy_operation` for the build's own error instead of retrying the wait.
8
+ - `platform_inspect_artifact_app` runs the manifest and data-binding checks Topline's build would fail: every `datasets[]` entry needs a `name` and `route`, every `routes[]` entry a `path`, and each `./_artifact/data/<name>` the source fetches needs a matching dataset. `packageReady` is false and `problems` names each field or file until they are fixed.
9
+ - Descriptions match the server: with company tables on, workspace SQL without a scope runs against company tables; an approved review completes the build session (asking again returns `validation_already_completed`); `needs_fix` keeps it active; rendered smoke can report `passed_with_warnings`; and omitted `buildOk` / `typecheckOk` are read as not reported.
10
+
11
+ ## 0.9.13 - 2026-11-10
12
+
13
+ - New `platform_read_logs`, for Topline staff only: bounded, redacted reads of the platform API and worker logs and of one-off task logs (connector syncs, one-off scripts, route optimization, link migrations, a coding task's runtime lines). It forwards to the hosted Build MCP, which checks operator access and audits every read.
14
+
5
15
  ## 0.9.12 - 2026-11-10
6
16
 
7
17
  - `platform_storybook_access` says it opens your company's design system Storybook (the components artifacts use), not Topline's own app screens, and points to the new hosted tool `platform_storybook`, which lists components, reads their docs (several at once) and links story previews on this connection with no second MCP server.
@@ -19,7 +19,7 @@ export function externalBuildHelperTools(annotate) {
19
19
  }, ["idempotencyKey", "budgetCents", "brief"]),
20
20
  tool("platform_read_build_session", "Read the owned build session and original pending operations. Does not start another coder or deployment.", session, ["sessionId"], true),
21
21
  tool("platform_close_build_session", "Stop new authoring and request pending-operation cancellation. Unknown effects retain their reservation; cancellation does not undo committed writes.", session, ["sessionId"]),
22
- tool("platform_run_artifact_workspace_sql", "Run guarded SQL using the exact session, version and retry key. Without scope, or scope \"artifact\", it reads and writes this app's own build-checkpoint and cache tables. With scope \"company\", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.", {
22
+ tool("platform_run_artifact_workspace_sql", "Run guarded SQL using the exact session, version and retry key. Without scope, or scope \"artifact\", it reads and writes this app's own build-checkpoint and cache tables; when the build session's workspace.routing is company_tables there are no private tables and every statement runs against company tables, as with scope \"company\". A statement the database rejects returns sql_statement_failed:<SQLSTATE> (company tables: company_table_sql_failed:<SQLSTATE>) with a fixed hint. With scope \"company\", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.", {
23
23
  ...mutation, scope: { type: "string", enum: ["artifact", "company"] },
24
24
  sql: { type: "string", minLength: 1, maxLength: 20000 }, purpose: { type: "string", minLength: 3, maxLength: 500 },
25
25
  params: { type: "object", additionalProperties: true }, maxRows: { type: "integer", minimum: 1, maximum: 5000 }, documentation: { type: "object" }, columnDocumentation: { type: "object" }
@@ -38,14 +38,14 @@ export function externalBuildHelperTools(annotate) {
38
38
  tool("platform_add_acceptance_check", "Add a required acceptance check bound to this build session and deployed revision. A semantic control query requires separate Build data-verification consent.", {
39
39
  ...mutation, description: { type: "string", minLength: 3, maxLength: 1000 }
40
40
  }, [...Object.keys(mutation), "description"]),
41
- tool("platform_run_acceptance_checks", "Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version, which also gates validation.", mutation, Object.keys(mutation)),
41
+ tool("platform_run_acceptance_checks", "Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version (passed, passed_with_warnings with qualityWarnings codes, failed with failingChecks, or not_run), which also gates validation.", mutation, Object.keys(mutation)),
42
42
  tool("platform_record_acceptance_review", "Record the builder's review of a reviewer-only acceptance check. A passed result is accepted only for a check whose latest result platform_run_acceptance_checks recorded as a skipped reviewer check for this version, so run the checks first. Does not impersonate the independent validator or remove required checks.", {
43
43
  ...mutation, checkId: id, status: { type: "string", enum: ["passed", "failed"] }, summary: { type: "string", minLength: 3, maxLength: 2000 }
44
44
  }, [...Object.keys(mutation), "checkId", "status", "summary"]),
45
45
  tool("platform_prepare_artifact_validation", "Prepare validation evidence for the exact private draft revision; missing required checks block readiness.", { ...session, artifactVersionId: id, deploymentRecordId: id, idempotencyKey: requestKey }, ["sessionId", "artifactVersionId", "deploymentRecordId"], true),
46
- tool("platform_request_artifact_validation", "Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish.", {
46
+ tool("platform_request_artifact_validation", "Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish and completes this build session; asking again returns validation_already_completed. A needs_fix review keeps the session active: fix, deploy a new version, smoke, then request a review of that version. If the draft isn't ready, the refusal names the blocker platform_prepare_artifact_validation reports.", {
47
47
  ...deployed, summary: { type: "string", minLength: 3, maxLength: 4000 }, waitMs: { type: "integer", minimum: 0, maximum: 1000, description: "Milliseconds to wait for the review before returning, 0 to 1000." },
48
- buildOk: { type: "boolean" }, typecheckOk: { type: "boolean" }, docImpact: { type: "string", enum: ["material", "none"] },
48
+ buildOk: { type: "boolean", description: "Your own local build result. Omit if you did not run one; the reviewer is told separately that Topline's trusted build deployed this version." }, typecheckOk: { type: "boolean", description: "Your own local typecheck result. Omit if you did not run one." }, docImpact: { type: "string", enum: ["material", "none"] },
49
49
  docImpactNotes: { type: "string", minLength: 12, maxLength: 2000 }, visualReview: { type: "object", additionalProperties: true }, dataValidation: { type: "object", additionalProperties: true }
50
50
  }, [...Object.keys(deployed), "summary", "docImpact", "docImpactNotes", "visualReview"]),
51
51
  tool("platform_artifact_validation_status", "Read the original validation result and pending prompts without starting another reviewer or deploy. operationId selects the review; the result names the artifactVersionId it reviewed, and a supplied artifactVersionId that differs is refused (validation_operation_version_mismatch). Use the operationId this build session's request returned; another session's operation is refused (validation_operation_not_found). Current authorization is rechecked before evidence delivery.", {
package/dist/index.d.ts CHANGED
@@ -42,7 +42,7 @@ type ToolProgressReporter = (progress: number, message: string) => void | Promis
42
42
  export type McpSurface = "build" | "topline" | "harness";
43
43
  export declare const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
44
44
  export declare const BUILD_MCP_SERVER_NAME = "topline-build-stdio";
45
- export declare const HARNESS_MCP_VERSION = "0.9.12";
45
+ export declare const HARNESS_MCP_VERSION = "0.9.14";
46
46
  export declare const DEFAULT_OAUTH_SCOPES: readonly string[];
47
47
  /** The Topline server's scopes: Build and Workspace. Consent shows what the seat allows. */
48
48
  export declare const TOPLINE_OAUTH_SCOPES: readonly string[];
@@ -131,6 +131,11 @@ export declare function materializeBuildAssets(opts: HarnessMcpStdioOptions, inp
131
131
  export declare function inspectArtifactApp(opts: HarnessMcpStdioOptions, input: Record<string, unknown>): Promise<{
132
132
  ok: boolean;
133
133
  packageReady: boolean;
134
+ problems: {
135
+ code: string;
136
+ path: string;
137
+ detail: string;
138
+ }[];
134
139
  serverManifestValidationRequired: boolean;
135
140
  appDir: string;
136
141
  platformAppDir: string;
@@ -153,6 +158,16 @@ export declare function inspectArtifactApp(opts: HarnessMcpStdioOptions, input:
153
158
  };
154
159
  nextAction: string;
155
160
  }>;
161
+ /**
162
+ * Round 11 P4: the checks Topline's server and trusted build run that a local inspect can repeat
163
+ * cheaply, so packageReady isn't true for a package the deploy will refuse: dataset and route
164
+ * fields the manifest needs, and ./_artifact/data/<name> references with no matching dataset.
165
+ */
166
+ export declare function localPreflightProblems(appDir: string, manifest: Record<string, unknown>): Promise<Array<{
167
+ code: string;
168
+ path: string;
169
+ detail: string;
170
+ }>>;
156
171
  export declare function waitForArtifactDeploy(opts: HarnessMcpStdioOptions, input: Record<string, unknown>, onProgress?: ToolProgressReporter): Promise<Record<string, unknown>>;
157
172
  export declare function initArtifactApp(opts: HarnessMcpStdioOptions, input: Record<string, unknown>): Promise<{
158
173
  ok: boolean;
package/dist/index.js CHANGED
@@ -19,7 +19,7 @@ const MCP_SURFACES = ["build", "topline", "harness"];
19
19
  export const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
20
20
  const DEFAULT_TIMEOUT_MS = 120_000;
21
21
  export const BUILD_MCP_SERVER_NAME = "topline-build-stdio";
22
- export const HARNESS_MCP_VERSION = "0.9.12";
22
+ export const HARNESS_MCP_VERSION = "0.9.14";
23
23
  export const DEFAULT_OAUTH_SCOPES = Object.freeze(["harness:artifact:read", "harness:artifact:write", "harness:artifact:deploy", "harness:artifact:delete"]);
24
24
  /** The Topline server's scopes: Build and Workspace. Consent shows what the seat allows. */
25
25
  export const TOPLINE_OAUTH_SCOPES = Object.freeze([
@@ -833,6 +833,7 @@ export async function callHarnessTool(opts, name, args, hooks) {
833
833
  case "platform_validate_artifact":
834
834
  case "platform_plan_artifact_draft_delete":
835
835
  case "platform_delete_artifact_draft":
836
+ case "platform_read_logs":
836
837
  result = toolResult(await callHostedBuildTool(opts, name, input));
837
838
  break;
838
839
  case "platform_run_artifact_smoke":
@@ -1152,9 +1153,11 @@ export async function inspectArtifactApp(opts, input) {
1152
1153
  const suppliedPlatformAppDir = optionalString(input, "platformAppDir");
1153
1154
  const platformAppDir = suppliedPlatformAppDir ? (suppliedPlatformAppDir === "." ? "." : validateArchivePrefix(suppliedPlatformAppDir)) : logicalArtifactAppDir(workspaceAppDir, manifest);
1154
1155
  const bundle = await packArtifactAppDirectory(absoluteAppDir, platformAppDir === "." ? "" : platformAppDir);
1156
+ const problems = await localPreflightProblems(absoluteAppDir, manifest);
1155
1157
  return {
1156
1158
  ok: true,
1157
- packageReady: true,
1159
+ packageReady: problems.length === 0,
1160
+ problems,
1158
1161
  serverManifestValidationRequired: true,
1159
1162
  appDir: workspaceAppDir,
1160
1163
  platformAppDir,
@@ -1177,9 +1180,69 @@ export async function inspectArtifactApp(opts, input) {
1177
1180
  sha256: bundle.sha256,
1178
1181
  excluded: bundle.excluded
1179
1182
  },
1180
- nextAction: "Call platform_deploy_artifact_app with the same appDir and expectedBundleSha256 set to bundle.sha256 when this local package is ready to deploy."
1183
+ nextAction: problems.length
1184
+ ? `Fix the ${problems.length === 1 ? "problem" : "problems"} listed in problems (each names its field or file), then inspect again. Topline's build would refuse this package as it is.`
1185
+ : "Call platform_deploy_artifact_app with the same appDir and expectedBundleSha256 set to bundle.sha256 when this local package is ready to deploy."
1181
1186
  };
1182
1187
  }
1188
+ const PREFLIGHT_SCAN_EXTENSIONS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs", ".html", ".json", ".py", ".txt"]);
1189
+ const PREFLIGHT_SKIP_DIRS = new Set(["node_modules", ".git", ".next", ".vite", ".turbo", ".cache"]);
1190
+ /**
1191
+ * Round 11 P4: the checks Topline's server and trusted build run that a local inspect can repeat
1192
+ * cheaply, so packageReady isn't true for a package the deploy will refuse: dataset and route
1193
+ * fields the manifest needs, and ./_artifact/data/<name> references with no matching dataset.
1194
+ */
1195
+ export async function localPreflightProblems(appDir, manifest) {
1196
+ const problems = [];
1197
+ const nonEmpty = (value) => typeof value === "string" && value.trim() !== "";
1198
+ const datasets = Array.isArray(manifest.datasets) ? manifest.datasets : [];
1199
+ datasets.forEach((dataset, index) => {
1200
+ const record = isRecord(dataset) ? dataset : {};
1201
+ for (const key of ["name", "route"]) {
1202
+ if (!nonEmpty(record[key]))
1203
+ problems.push({ code: "invalid_artifact_app_manifest", path: `datasets[${index}].${key}`, detail: `datasets[${index}].${key} must be a non-empty string${key === "route" ? " (the page's path, for example /_artifact/data/<name>)" : ""}` });
1204
+ }
1205
+ });
1206
+ const routes = Array.isArray(manifest.routes) ? manifest.routes : [];
1207
+ routes.forEach((route, index) => {
1208
+ if (!isRecord(route) || !nonEmpty(route.path))
1209
+ problems.push({ code: "invalid_artifact_app_manifest", path: `routes[${index}].path`, detail: `routes[${index}].path must be a non-empty string` });
1210
+ });
1211
+ const declared = new Set([
1212
+ ...datasets.filter(isRecord).map((dataset) => dataset.name),
1213
+ ...(Array.isArray(manifest.sourceBindings) ? manifest.sourceBindings : []).filter(isRecord).map((binding) => binding.name)
1214
+ ].filter((name) => typeof name === "string"));
1215
+ const reported = new Set();
1216
+ let scanned = 0;
1217
+ const visit = async (dir) => {
1218
+ for (const entry of await readdir(dir, { withFileTypes: true })) {
1219
+ if (scanned > 5_000)
1220
+ return;
1221
+ const full = path.join(dir, entry.name);
1222
+ if (entry.isDirectory()) {
1223
+ if (!PREFLIGHT_SKIP_DIRS.has(entry.name))
1224
+ await visit(full);
1225
+ continue;
1226
+ }
1227
+ if (!entry.isFile() || !PREFLIGHT_SCAN_EXTENSIONS.has(path.extname(entry.name)))
1228
+ continue;
1229
+ scanned += 1;
1230
+ const content = await readFile(full, "utf8").catch(() => "");
1231
+ if (content.length > 2_000_000)
1232
+ continue;
1233
+ for (const match of content.matchAll(/\.\/_artifact\/data\/([A-Za-z0-9_-]+)/g)) {
1234
+ const rel = path.relative(appDir, full).replaceAll("\\", "/");
1235
+ const key = `${rel}:${match[1]}`;
1236
+ if (declared.has(match[1]) || reported.has(key))
1237
+ continue;
1238
+ reported.add(key);
1239
+ problems.push({ code: "undeclared_artifact_data_binding", path: rel, detail: `${rel} fetches ./_artifact/data/${match[1]}, but no datasets[] entry is named ${match[1]}. Declare it (with its route) or remove the reference.` });
1240
+ }
1241
+ }
1242
+ };
1243
+ await visit(appDir);
1244
+ return problems.slice(0, 25);
1245
+ }
1183
1246
  async function callHostedBuildTool(opts, name, input) {
1184
1247
  if (!servesBuild(opts))
1185
1248
  throw new Error(`${name}_requires_build_surface`);
@@ -1350,8 +1413,12 @@ export async function waitForArtifactDeploy(opts, input, onProgress) {
1350
1413
  if (typeof latest.nextSeq === "number")
1351
1414
  afterSeq = latest.nextSeq;
1352
1415
  if (latest.terminal === true) {
1353
- if (latest.successful !== true)
1354
- throw new Error(`artifact_deploy_failed:${String(latest.taskStatus ?? "failed")}`);
1416
+ if (latest.successful !== true) {
1417
+ // Round 11 P3: name the build's failure code, not just the task status.
1418
+ const failure = isRecord(latest.failure) ? latest.failure : {};
1419
+ const code = typeof failure.code === "string" && /^[a-z][a-z0-9_]{2,80}$/.test(failure.code) ? failure.code : String(latest.taskStatus ?? "failed");
1420
+ throw new Error(`artifact_deploy_failed:${code}`);
1421
+ }
1355
1422
  return latest;
1356
1423
  }
1357
1424
  const waitMs = typeof latest.nextPollAfterMs === "number" ? Math.min(Math.max(latest.nextPollAfterMs, 250), 10_000) : 2_000;
@@ -1958,7 +2025,7 @@ const BUILD_MCP_TOOLS = [
1958
2025
  },
1959
2026
  {
1960
2027
  name: "platform_inspect_artifact_app",
1961
- description: "Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft.",
2028
+ description: "Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft. Also runs the manifest and data-binding checks Topline's build would fail (datasets[].name and route, routes[].path, ./_artifact/data/<name> references with no matching dataset); packageReady is false and problems lists each one until they are fixed.",
1962
2029
  annotations: mcpToolAnnotations("platform_inspect_artifact_app", { readOnly: true }),
1963
2030
  inputSchema: {
1964
2031
  type: "object",
@@ -1971,6 +2038,7 @@ const BUILD_MCP_TOOLS = [
1971
2038
  properties: {
1972
2039
  ok: { type: "boolean" },
1973
2040
  packageReady: { type: "boolean" },
2041
+ problems: { type: "array", items: { type: "object" }, description: "Checks Topline's build would fail: each has code, path (manifest field or file) and detail. packageReady is false while any remain." },
1974
2042
  serverManifestValidationRequired: { type: "boolean" },
1975
2043
  appDir: { type: "string" },
1976
2044
  platformAppDir: { type: "string" },
@@ -2004,7 +2072,7 @@ const BUILD_MCP_TOOLS = [
2004
2072
  },
2005
2073
  {
2006
2074
  name: "platform_wait_artifact_deploy",
2007
- description: "Wait for a durable deployment operation and stream server-derived progress.",
2075
+ description: "Wait for a durable deployment operation and stream server-derived progress. A failed deploy returns artifact_deploy_failed:<failure code>; read platform_deploy_operation for the build's own error (failure.detail) and next step. A successful deploy returns the session's next sourceHash for the following deploy.",
2008
2076
  annotations: mcpToolAnnotations("platform_wait_artifact_deploy", { readOnly: true, openWorld: true }),
2009
2077
  inputSchema: { type: "object", properties: { artifactId: { type: "string", format: "uuid" }, operationId: { type: "string", format: "uuid" }, timeoutSeconds: { type: "integer", minimum: 1, maximum: 900 } }, required: ["artifactId", "operationId"], additionalProperties: false },
2010
2078
  outputSchema: { type: "object", properties: { ok: { type: "boolean" }, phase: { type: "string" }, artifactId: { type: "string" }, operationId: { type: "string" }, taskStatus: { type: "string" }, progress: { type: "number" }, terminal: { type: "boolean" }, successful: { type: "boolean" }, events: { type: "array", items: { type: "object" } } }, required: ["ok", "phase", "artifactId", "operationId", "taskStatus", "progress", "terminal", "successful", "events"] }
@@ -2064,6 +2132,41 @@ const BUILD_MCP_TOOLS = [
2064
2132
  required: ["ok", "phase", "artifactId"]
2065
2133
  }
2066
2134
  },
2135
+ {
2136
+ name: "platform_read_logs",
2137
+ description: "Topline staff only. Read bounded, redacted logs for this Topline account: target api or worker (the platform API and worker), all (both), or task (one-off ECS tasks: connector syncs, one-off scripts, route optimization, link migrations; kind coding_runtime reads a coding task's runtime lines in Topline's own workspace). For task, no taskId or runId lists recent tasks; taskId reads one task with its exit code; runId (a Sync history run) finds the sync task that ran it. Task logs need Task logs turned on for the account. Every read is audited.",
2138
+ annotations: mcpToolAnnotations("platform_read_logs", { readOnly: true }),
2139
+ inputSchema: {
2140
+ type: "object",
2141
+ properties: {
2142
+ target: { type: "string", enum: ["api", "worker", "all", "task"], description: "api, worker or all: the platform service logs. task: one-off ECS task logs." },
2143
+ kind: { type: "string", enum: ["any", "pipeline", "one_off", "route_optimization", "link_migration", "coding_runtime"], description: "task: which tasks. any (default) is every kind but coding_runtime." },
2144
+ taskId: { type: "string", maxLength: 64, description: "task: one ECS task id (32 hex characters), or the coding task id for kind coding_runtime." },
2145
+ runId: { type: "string", format: "uuid", description: "task: a task run id from Sync history." },
2146
+ query: { type: "string", maxLength: 200, description: "Case-insensitive substring filter on the redacted lines." },
2147
+ level: { type: "string", enum: ["error", "warning", "info", "debug"], description: "Minimum severity. Defaults to info." },
2148
+ since: { type: "string", description: "ISO timestamp. Defaults to windowMinutes back from now." },
2149
+ windowMinutes: { type: "number", minimum: 1, maximum: 1440, description: "Recent window when since is omitted. Defaults to 60." },
2150
+ limit: { type: "number", minimum: 1, maximum: 200, description: "Maximum lines returned. Defaults to 50." },
2151
+ purpose: { type: "string", maxLength: 300, description: "Short reason, kept in the audit row." }
2152
+ },
2153
+ required: ["target"],
2154
+ additionalProperties: false
2155
+ },
2156
+ outputSchema: {
2157
+ type: "object",
2158
+ properties: {
2159
+ status: { type: "string" },
2160
+ service: { type: ["string", "null"] },
2161
+ summary: { type: "string" },
2162
+ nextAction: { type: "string" },
2163
+ logCount: { type: "number" },
2164
+ logs: { type: "array", items: { type: "object" } },
2165
+ tasks: { type: "array", items: { type: "object" } }
2166
+ },
2167
+ required: ["status", "summary"]
2168
+ }
2169
+ },
2067
2170
  {
2068
2171
  name: "platform_open_artifact",
2069
2172
  description: "Return the operator URL and latest draft/live URLs for a hosted artifact app.",
@@ -2366,6 +2469,9 @@ const BUILD_MCP_RECOVERY_ERROR_VALUES = {
2366
2469
  build_session_id_required: { retryable: false, recoveryAction: "The fields named after the code only work inside a build session. Remove them for a plain deploy of an app you created over MCP, or start a session and pass its sessionId." },
2367
2470
  artifact_external_session_active: { retryable: false, recoveryAction: "An open build session holds this app. If it is yours, pass its sessionId; otherwise close it with platform_close_build_session or wait for it to end." },
2368
2471
  artifact_deploy_wait_timeout: { retryable: true, recoveryAction: "Call platform_wait_artifact_deploy again with the same artifactId and operationId." },
2472
+ // Round 11 P3: the wait names the failure code; the detail (the build's own error) is on the operation.
2473
+ artifact_deploy_failed: { retryable: false, recoveryAction: "The deploy finished and failed; the code after artifact_deploy_failed names why. Call platform_deploy_operation with the same artifactId and operationId for failure.detail (the build's own error) and failure.nextAction. Fix the source, run platform_inspect_artifact_app, then deploy again. Retrying the wait or redeploying the same source fails the same way." },
2474
+ validation_already_completed: { retryable: false, recoveryAction: "A review already approved this version and completed the build session. Don't request another review or start a new session to repeat it; read the verdict with platform_artifact_validation_status. Publishing is the person's step in Topline." },
2369
2475
  artifact_delete_plan_stale: { retryable: true, recoveryAction: "Call platform_plan_artifact_draft_delete again, review the new effects, and use its planToken." },
2370
2476
  artifact_app_bundle_changed_after_inspection: { retryable: true, recoveryAction: "Call platform_inspect_artifact_app again, review the new bundle hash, then retry deployment with that hash." },
2371
2477
  artifact_app_bundle_hardlink_forbidden: { retryable: false, recoveryAction: "Replace the hard link with a regular file copied into appDir, then inspect again." },
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.9.12",
5
+ "version": "0.9.14",
6
6
  "bin": {
7
7
  "topline-mcp": "dist/cli.js"
8
8
  }
@@ -12,7 +12,7 @@
12
12
  "defaultVersion": "2025-11-25",
13
13
  "server": {
14
14
  "name": "topline-build-stdio",
15
- "version": "0.9.12"
15
+ "version": "0.9.14"
16
16
  }
17
17
  },
18
18
  "generatedFrom": {
@@ -420,6 +420,16 @@
420
420
  "retryable": true,
421
421
  "recoveryAction": "Call platform_wait_artifact_deploy again with the same artifactId and operationId."
422
422
  },
423
+ {
424
+ "code": "artifact_deploy_failed",
425
+ "retryable": false,
426
+ "recoveryAction": "The deploy finished and failed; the code after artifact_deploy_failed names why. Call platform_deploy_operation with the same artifactId and operationId for failure.detail (the build's own error) and failure.nextAction. Fix the source, run platform_inspect_artifact_app, then deploy again. Retrying the wait or redeploying the same source fails the same way."
427
+ },
428
+ {
429
+ "code": "validation_already_completed",
430
+ "retryable": false,
431
+ "recoveryAction": "A review already approved this version and completed the build session. Don't request another review or start a new session to repeat it; read the verdict with platform_artifact_validation_status. Publishing is the person's step in Topline."
432
+ },
423
433
  {
424
434
  "code": "artifact_delete_plan_stale",
425
435
  "retryable": true,
@@ -1060,7 +1070,7 @@
1060
1070
  },
1061
1071
  {
1062
1072
  "name": "platform_inspect_artifact_app",
1063
- "description": "Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft.",
1073
+ "description": "Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft. Also runs the manifest and data-binding checks Topline's build would fail (datasets[].name and route, routes[].path, ./_artifact/data/<name> references with no matching dataset); packageReady is false and problems lists each one until they are fixed.",
1064
1074
  "annotations": {
1065
1075
  "title": "Platform Inspect Artifact App",
1066
1076
  "readOnlyHint": true,
@@ -1097,6 +1107,13 @@
1097
1107
  "packageReady": {
1098
1108
  "type": "boolean"
1099
1109
  },
1110
+ "problems": {
1111
+ "type": "array",
1112
+ "items": {
1113
+ "type": "object"
1114
+ },
1115
+ "description": "Checks Topline's build would fail: each has code, path (manifest field or file) and detail. packageReady is false while any remain."
1116
+ },
1100
1117
  "serverManifestValidationRequired": {
1101
1118
  "type": "boolean"
1102
1119
  },
@@ -1515,7 +1532,7 @@
1515
1532
  },
1516
1533
  {
1517
1534
  "name": "platform_wait_artifact_deploy",
1518
- "description": "Wait for a durable deployment operation and stream server-derived progress.",
1535
+ "description": "Wait for a durable deployment operation and stream server-derived progress. A failed deploy returns artifact_deploy_failed:<failure code>; read platform_deploy_operation for the build's own error (failure.detail) and next step. A successful deploy returns the session's next sourceHash for the following deploy.",
1519
1536
  "annotations": {
1520
1537
  "title": "Platform Wait Artifact Deploy",
1521
1538
  "readOnlyHint": true,
@@ -1929,6 +1946,188 @@
1929
1946
  }
1930
1947
  ]
1931
1948
  },
1949
+ {
1950
+ "name": "platform_read_logs",
1951
+ "description": "Topline staff only. Read bounded, redacted logs for this Topline account: target api or worker (the platform API and worker), all (both), or task (one-off ECS tasks: connector syncs, one-off scripts, route optimization, link migrations; kind coding_runtime reads a coding task's runtime lines in Topline's own workspace). For task, no taskId or runId lists recent tasks; taskId reads one task with its exit code; runId (a Sync history run) finds the sync task that ran it. Task logs need Task logs turned on for the account. Every read is audited.",
1952
+ "annotations": {
1953
+ "title": "Platform Read Logs",
1954
+ "readOnlyHint": true,
1955
+ "destructiveHint": false,
1956
+ "openWorldHint": false
1957
+ },
1958
+ "inputSchema": {
1959
+ "type": "object",
1960
+ "properties": {
1961
+ "target": {
1962
+ "type": "string",
1963
+ "enum": [
1964
+ "api",
1965
+ "worker",
1966
+ "all",
1967
+ "task"
1968
+ ],
1969
+ "description": "api, worker or all: the platform service logs. task: one-off ECS task logs."
1970
+ },
1971
+ "kind": {
1972
+ "type": "string",
1973
+ "enum": [
1974
+ "any",
1975
+ "pipeline",
1976
+ "one_off",
1977
+ "route_optimization",
1978
+ "link_migration",
1979
+ "coding_runtime"
1980
+ ],
1981
+ "description": "task: which tasks. any (default) is every kind but coding_runtime."
1982
+ },
1983
+ "taskId": {
1984
+ "type": "string",
1985
+ "maxLength": 64,
1986
+ "description": "task: one ECS task id (32 hex characters), or the coding task id for kind coding_runtime."
1987
+ },
1988
+ "runId": {
1989
+ "type": "string",
1990
+ "format": "uuid",
1991
+ "description": "task: a task run id from Sync history."
1992
+ },
1993
+ "query": {
1994
+ "type": "string",
1995
+ "maxLength": 200,
1996
+ "description": "Case-insensitive substring filter on the redacted lines."
1997
+ },
1998
+ "level": {
1999
+ "type": "string",
2000
+ "enum": [
2001
+ "error",
2002
+ "warning",
2003
+ "info",
2004
+ "debug"
2005
+ ],
2006
+ "description": "Minimum severity. Defaults to info."
2007
+ },
2008
+ "since": {
2009
+ "type": "string",
2010
+ "description": "ISO timestamp. Defaults to windowMinutes back from now."
2011
+ },
2012
+ "windowMinutes": {
2013
+ "type": "number",
2014
+ "minimum": 1,
2015
+ "maximum": 1440,
2016
+ "description": "Recent window when since is omitted. Defaults to 60."
2017
+ },
2018
+ "limit": {
2019
+ "type": "number",
2020
+ "minimum": 1,
2021
+ "maximum": 200,
2022
+ "description": "Maximum lines returned. Defaults to 50."
2023
+ },
2024
+ "purpose": {
2025
+ "type": "string",
2026
+ "maxLength": 300,
2027
+ "description": "Short reason, kept in the audit row."
2028
+ }
2029
+ },
2030
+ "required": [
2031
+ "target"
2032
+ ],
2033
+ "additionalProperties": false
2034
+ },
2035
+ "outputSchema": {
2036
+ "type": "object",
2037
+ "oneOf": [
2038
+ {
2039
+ "type": "object",
2040
+ "properties": {
2041
+ "status": {
2042
+ "type": "string"
2043
+ },
2044
+ "service": {
2045
+ "type": [
2046
+ "string",
2047
+ "null"
2048
+ ]
2049
+ },
2050
+ "summary": {
2051
+ "type": "string"
2052
+ },
2053
+ "nextAction": {
2054
+ "type": "string"
2055
+ },
2056
+ "logCount": {
2057
+ "type": "number"
2058
+ },
2059
+ "logs": {
2060
+ "type": "array",
2061
+ "items": {
2062
+ "type": "object"
2063
+ }
2064
+ },
2065
+ "tasks": {
2066
+ "type": "array",
2067
+ "items": {
2068
+ "type": "object"
2069
+ }
2070
+ }
2071
+ },
2072
+ "required": [
2073
+ "status",
2074
+ "summary"
2075
+ ]
2076
+ },
2077
+ {
2078
+ "type": "object",
2079
+ "properties": {
2080
+ "ok": {
2081
+ "const": false
2082
+ },
2083
+ "error": {
2084
+ "type": "object",
2085
+ "properties": {
2086
+ "code": {
2087
+ "type": "string"
2088
+ },
2089
+ "message": {
2090
+ "type": "string"
2091
+ },
2092
+ "retryable": {
2093
+ "type": "boolean"
2094
+ },
2095
+ "recoveryAction": {
2096
+ "type": "string"
2097
+ },
2098
+ "signInUrl": {
2099
+ "type": "string"
2100
+ }
2101
+ },
2102
+ "required": [
2103
+ "code",
2104
+ "message",
2105
+ "retryable",
2106
+ "recoveryAction"
2107
+ ],
2108
+ "additionalProperties": false
2109
+ }
2110
+ },
2111
+ "required": [
2112
+ "ok",
2113
+ "error"
2114
+ ],
2115
+ "additionalProperties": false
2116
+ }
2117
+ ]
2118
+ },
2119
+ "examples": [
2120
+ {
2121
+ "request": {
2122
+ "target": "api"
2123
+ },
2124
+ "success": {
2125
+ "status": "<status>",
2126
+ "summary": "<summary>"
2127
+ }
2128
+ }
2129
+ ]
2130
+ },
1932
2131
  {
1933
2132
  "name": "platform_open_artifact",
1934
2133
  "description": "Return the operator URL and latest draft/live URLs for a hosted artifact app.",
@@ -3554,7 +3753,7 @@
3554
3753
  },
3555
3754
  {
3556
3755
  "name": "platform_run_artifact_workspace_sql",
3557
- "description": "Run guarded SQL using the exact session, version and retry key. Without scope, or scope \"artifact\", it reads and writes this app's own build-checkpoint and cache tables. With scope \"company\", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.",
3756
+ "description": "Run guarded SQL using the exact session, version and retry key. Without scope, or scope \"artifact\", it reads and writes this app's own build-checkpoint and cache tables; when the build session's workspace.routing is company_tables there are no private tables and every statement runs against company tables, as with scope \"company\". A statement the database rejects returns sql_statement_failed:<SQLSTATE> (company tables: company_table_sql_failed:<SQLSTATE>) with a fixed hint. With scope \"company\", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.",
3558
3757
  "annotations": {
3559
3758
  "title": "Platform Run Artifact Workspace Sql",
3560
3759
  "readOnlyHint": false,
@@ -4263,7 +4462,7 @@
4263
4462
  },
4264
4463
  {
4265
4464
  "name": "platform_run_acceptance_checks",
4266
- "description": "Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version, which also gates validation.",
4465
+ "description": "Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version (passed, passed_with_warnings with qualityWarnings codes, failed with failingChecks, or not_run), which also gates validation.",
4267
4466
  "annotations": {
4268
4467
  "title": "Platform Run Acceptance Checks",
4269
4468
  "readOnlyHint": false,
@@ -4586,7 +4785,7 @@
4586
4785
  },
4587
4786
  {
4588
4787
  "name": "platform_request_artifact_validation",
4589
- "description": "Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish.",
4788
+ "description": "Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish and completes this build session; asking again returns validation_already_completed. A needs_fix review keeps the session active: fix, deploy a new version, smoke, then request a review of that version. If the draft isn't ready, the refusal names the blocker platform_prepare_artifact_validation reports.",
4590
4789
  "annotations": {
4591
4790
  "title": "Platform Request Artifact Validation",
4592
4791
  "readOnlyHint": false,
@@ -4628,10 +4827,12 @@
4628
4827
  "description": "Milliseconds to wait for the review before returning, 0 to 1000."
4629
4828
  },
4630
4829
  "buildOk": {
4631
- "type": "boolean"
4830
+ "type": "boolean",
4831
+ "description": "Your own local build result. Omit if you did not run one; the reviewer is told separately that Topline's trusted build deployed this version."
4632
4832
  },
4633
4833
  "typecheckOk": {
4634
- "type": "boolean"
4834
+ "type": "boolean",
4835
+ "description": "Your own local typecheck result. Omit if you did not run one."
4635
4836
  },
4636
4837
  "docImpact": {
4637
4838
  "type": "string",
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Generated from `src/index.ts#BUILD_MCP_TOOLS`. Do not edit this file by hand.
4
4
 
5
- Package: `@topline-build/harness-mcp@0.9.12`
5
+ Package: `@topline-build/harness-mcp@0.9.14`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -81,6 +81,8 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
81
81
  - `build_session_id_required` (not automatically retryable): The fields named after the code only work inside a build session. Remove them for a plain deploy of an app you created over MCP, or start a session and pass its sessionId.
82
82
  - `artifact_external_session_active` (not automatically retryable): An open build session holds this app. If it is yours, pass its sessionId; otherwise close it with platform_close_build_session or wait for it to end.
83
83
  - `artifact_deploy_wait_timeout` (retryable): Call platform_wait_artifact_deploy again with the same artifactId and operationId.
84
+ - `artifact_deploy_failed` (not automatically retryable): The deploy finished and failed; the code after artifact_deploy_failed names why. Call platform_deploy_operation with the same artifactId and operationId for failure.detail (the build's own error) and failure.nextAction. Fix the source, run platform_inspect_artifact_app, then deploy again. Retrying the wait or redeploying the same source fails the same way.
85
+ - `validation_already_completed` (not automatically retryable): A review already approved this version and completed the build session. Don't request another review or start a new session to repeat it; read the verdict with platform_artifact_validation_status. Publishing is the person's step in Topline.
84
86
  - `artifact_delete_plan_stale` (retryable): Call platform_plan_artifact_draft_delete again, review the new effects, and use its planToken.
85
87
  - `artifact_app_bundle_changed_after_inspection` (retryable): Call platform_inspect_artifact_app again, review the new bundle hash, then retry deployment with that hash.
86
88
  - `artifact_app_bundle_hardlink_forbidden` (not automatically retryable): Replace the hard link with a regular file copied into appDir, then inspect again.
@@ -704,7 +706,7 @@ Output schema:
704
706
 
705
707
  ### `platform_inspect_artifact_app`
706
708
 
707
- Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft.
709
+ Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft. Also runs the manifest and data-binding checks Topline's build would fail (datasets[].name and route, routes[].path, ./_artifact/data/<name> references with no matching dataset); packageReady is false and problems lists each one until they are fixed.
708
710
 
709
711
  Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
710
712
 
@@ -769,6 +771,13 @@ Output schema:
769
771
  "packageReady": {
770
772
  "type": "boolean"
771
773
  },
774
+ "problems": {
775
+ "type": "array",
776
+ "items": {
777
+ "type": "object"
778
+ },
779
+ "description": "Checks Topline's build would fail: each has code, path (manifest field or file) and detail. packageReady is false while any remain."
780
+ },
772
781
  "serverManifestValidationRequired": {
773
782
  "type": "boolean"
774
783
  },
@@ -1207,7 +1216,7 @@ Output schema:
1207
1216
 
1208
1217
  ### `platform_wait_artifact_deploy`
1209
1218
 
1210
- Wait for a durable deployment operation and stream server-derived progress.
1219
+ Wait for a durable deployment operation and stream server-derived progress. A failed deploy returns artifact_deploy_failed:<failure code>; read platform_deploy_operation for the build's own error (failure.detail) and next step. A successful deploy returns the session's next sourceHash for the following deploy.
1211
1220
 
1212
1221
  Safety: read-only=true, destructive=false, idempotent=false, open-world=true.
1213
1222
 
@@ -1657,6 +1666,200 @@ Output schema:
1657
1666
  }
1658
1667
  ```
1659
1668
 
1669
+ ### `platform_read_logs`
1670
+
1671
+ Topline staff only. Read bounded, redacted logs for this Topline account: target api or worker (the platform API and worker), all (both), or task (one-off ECS tasks: connector syncs, one-off scripts, route optimization, link migrations; kind coding_runtime reads a coding task's runtime lines in Topline's own workspace). For task, no taskId or runId lists recent tasks; taskId reads one task with its exit code; runId (a Sync history run) finds the sync task that ran it. Task logs need Task logs turned on for the account. Every read is audited.
1672
+
1673
+ Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
1674
+
1675
+ Example request:
1676
+
1677
+ ```json
1678
+ {
1679
+ "target": "api"
1680
+ }
1681
+ ```
1682
+
1683
+ Example success:
1684
+
1685
+ ```json
1686
+ {
1687
+ "status": "<status>",
1688
+ "summary": "<summary>"
1689
+ }
1690
+ ```
1691
+
1692
+ Input schema:
1693
+
1694
+ ```json
1695
+ {
1696
+ "type": "object",
1697
+ "properties": {
1698
+ "target": {
1699
+ "type": "string",
1700
+ "enum": [
1701
+ "api",
1702
+ "worker",
1703
+ "all",
1704
+ "task"
1705
+ ],
1706
+ "description": "api, worker or all: the platform service logs. task: one-off ECS task logs."
1707
+ },
1708
+ "kind": {
1709
+ "type": "string",
1710
+ "enum": [
1711
+ "any",
1712
+ "pipeline",
1713
+ "one_off",
1714
+ "route_optimization",
1715
+ "link_migration",
1716
+ "coding_runtime"
1717
+ ],
1718
+ "description": "task: which tasks. any (default) is every kind but coding_runtime."
1719
+ },
1720
+ "taskId": {
1721
+ "type": "string",
1722
+ "maxLength": 64,
1723
+ "description": "task: one ECS task id (32 hex characters), or the coding task id for kind coding_runtime."
1724
+ },
1725
+ "runId": {
1726
+ "type": "string",
1727
+ "format": "uuid",
1728
+ "description": "task: a task run id from Sync history."
1729
+ },
1730
+ "query": {
1731
+ "type": "string",
1732
+ "maxLength": 200,
1733
+ "description": "Case-insensitive substring filter on the redacted lines."
1734
+ },
1735
+ "level": {
1736
+ "type": "string",
1737
+ "enum": [
1738
+ "error",
1739
+ "warning",
1740
+ "info",
1741
+ "debug"
1742
+ ],
1743
+ "description": "Minimum severity. Defaults to info."
1744
+ },
1745
+ "since": {
1746
+ "type": "string",
1747
+ "description": "ISO timestamp. Defaults to windowMinutes back from now."
1748
+ },
1749
+ "windowMinutes": {
1750
+ "type": "number",
1751
+ "minimum": 1,
1752
+ "maximum": 1440,
1753
+ "description": "Recent window when since is omitted. Defaults to 60."
1754
+ },
1755
+ "limit": {
1756
+ "type": "number",
1757
+ "minimum": 1,
1758
+ "maximum": 200,
1759
+ "description": "Maximum lines returned. Defaults to 50."
1760
+ },
1761
+ "purpose": {
1762
+ "type": "string",
1763
+ "maxLength": 300,
1764
+ "description": "Short reason, kept in the audit row."
1765
+ }
1766
+ },
1767
+ "required": [
1768
+ "target"
1769
+ ],
1770
+ "additionalProperties": false
1771
+ }
1772
+ ```
1773
+
1774
+ Output schema:
1775
+
1776
+ ```json
1777
+ {
1778
+ "type": "object",
1779
+ "oneOf": [
1780
+ {
1781
+ "type": "object",
1782
+ "properties": {
1783
+ "status": {
1784
+ "type": "string"
1785
+ },
1786
+ "service": {
1787
+ "type": [
1788
+ "string",
1789
+ "null"
1790
+ ]
1791
+ },
1792
+ "summary": {
1793
+ "type": "string"
1794
+ },
1795
+ "nextAction": {
1796
+ "type": "string"
1797
+ },
1798
+ "logCount": {
1799
+ "type": "number"
1800
+ },
1801
+ "logs": {
1802
+ "type": "array",
1803
+ "items": {
1804
+ "type": "object"
1805
+ }
1806
+ },
1807
+ "tasks": {
1808
+ "type": "array",
1809
+ "items": {
1810
+ "type": "object"
1811
+ }
1812
+ }
1813
+ },
1814
+ "required": [
1815
+ "status",
1816
+ "summary"
1817
+ ]
1818
+ },
1819
+ {
1820
+ "type": "object",
1821
+ "properties": {
1822
+ "ok": {
1823
+ "const": false
1824
+ },
1825
+ "error": {
1826
+ "type": "object",
1827
+ "properties": {
1828
+ "code": {
1829
+ "type": "string"
1830
+ },
1831
+ "message": {
1832
+ "type": "string"
1833
+ },
1834
+ "retryable": {
1835
+ "type": "boolean"
1836
+ },
1837
+ "recoveryAction": {
1838
+ "type": "string"
1839
+ },
1840
+ "signInUrl": {
1841
+ "type": "string"
1842
+ }
1843
+ },
1844
+ "required": [
1845
+ "code",
1846
+ "message",
1847
+ "retryable",
1848
+ "recoveryAction"
1849
+ ],
1850
+ "additionalProperties": false
1851
+ }
1852
+ },
1853
+ "required": [
1854
+ "ok",
1855
+ "error"
1856
+ ],
1857
+ "additionalProperties": false
1858
+ }
1859
+ ]
1860
+ }
1861
+ ```
1862
+
1660
1863
  ### `platform_open_artifact`
1661
1864
 
1662
1865
  Return the operator URL and latest draft/live URLs for a hosted artifact app.
@@ -3458,7 +3661,7 @@ Output schema:
3458
3661
 
3459
3662
  ### `platform_run_artifact_workspace_sql`
3460
3663
 
3461
- Run guarded SQL using the exact session, version and retry key. Without scope, or scope "artifact", it reads and writes this app's own build-checkpoint and cache tables. With scope "company", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.
3664
+ Run guarded SQL using the exact session, version and retry key. Without scope, or scope "artifact", it reads and writes this app's own build-checkpoint and cache tables; when the build session's workspace.routing is company_tables there are no private tables and every statement runs against company tables, as with scope "company". A statement the database rejects returns sql_statement_failed:<SQLSTATE> (company tables: company_table_sql_failed:<SQLSTATE>) with a fixed hint. With scope "company", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.
3462
3665
 
3463
3666
  Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3464
3667
 
@@ -4244,7 +4447,7 @@ Output schema:
4244
4447
 
4245
4448
  ### `platform_run_acceptance_checks`
4246
4449
 
4247
- Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version, which also gates validation.
4450
+ Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version (passed, passed_with_warnings with qualityWarnings codes, failed with failingChecks, or not_run), which also gates validation.
4248
4451
 
4249
4452
  Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4250
4453
 
@@ -4600,7 +4803,7 @@ Output schema:
4600
4803
 
4601
4804
  ### `platform_request_artifact_validation`
4602
4805
 
4603
- Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish.
4806
+ Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish and completes this build session; asking again returns validation_already_completed. A needs_fix review keeps the session active: fix, deploy a new version, smoke, then request a review of that version. If the draft isn't ready, the refusal names the blocker platform_prepare_artifact_validation reports.
4604
4807
 
4605
4808
  Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4606
4809
 
@@ -4662,10 +4865,12 @@ Input schema:
4662
4865
  "description": "Milliseconds to wait for the review before returning, 0 to 1000."
4663
4866
  },
4664
4867
  "buildOk": {
4665
- "type": "boolean"
4868
+ "type": "boolean",
4869
+ "description": "Your own local build result. Omit if you did not run one; the reviewer is told separately that Topline's trusted build deployed this version."
4666
4870
  },
4667
4871
  "typecheckOk": {
4668
- "type": "boolean"
4872
+ "type": "boolean",
4873
+ "description": "Your own local typecheck result. Omit if you did not run one."
4669
4874
  },
4670
4875
  "docImpact": {
4671
4876
  "type": "string",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topline-build/harness-mcp",
3
- "version": "0.9.12",
3
+ "version": "0.9.14",
4
4
  "description": "Topline Build MCP for creating and deploying artifact app drafts.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",