@topline-build/harness-mcp 0.9.7 → 0.9.8
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,10 @@
|
|
|
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.8 - 2026-11-02
|
|
6
|
+
|
|
7
|
+
- `platform_record_acceptance_review`'s description and the `manual_result_requires_reviewer_skip` recovery no longer mention `evidence.reviewerCheck`, which the tool doesn't take. A passed review needs a check whose latest result the runner recorded as a skipped reviewer check.
|
|
8
|
+
|
|
5
9
|
## 0.9.7 - 2026-11-02
|
|
6
10
|
|
|
7
11
|
- A first checkout of a new app (`artifact_source_unavailable`) says to deploy your local source with `platform_deploy_artifact_app` first and wait for the deploy operation, instead of offering a plain retry.
|
|
@@ -38,7 +38,7 @@ export function externalBuildHelperTools(annotate) {
|
|
|
38
38
|
...mutation, description: { type: "string", minLength: 3, maxLength: 1000 }
|
|
39
39
|
}, [...Object.keys(mutation), "description"]),
|
|
40
40
|
tool("platform_run_acceptance_checks", "Run required acceptance checks for the exact current draft revision through the shared service.", mutation, Object.keys(mutation)),
|
|
41
|
-
tool("platform_record_acceptance_review", "Record the builder's review of a reviewer-only acceptance check. A passed result
|
|
41
|
+
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.", {
|
|
42
42
|
...mutation, checkId: id, status: { type: "string", enum: ["passed", "failed"] }, summary: { type: "string", minLength: 3, maxLength: 2000 }
|
|
43
43
|
}, [...Object.keys(mutation), "checkId", "status", "summary"]),
|
|
44
44
|
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),
|
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.
|
|
45
|
+
export declare const HARNESS_MCP_VERSION = "0.9.8";
|
|
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[];
|
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.
|
|
22
|
+
export const HARNESS_MCP_VERSION = "0.9.8";
|
|
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([
|
|
@@ -2346,7 +2346,7 @@ const BUILD_MCP_RECOVERY_ERROR_VALUES = {
|
|
|
2346
2346
|
idempotency_conflict: { retryable: false, recoveryAction: "This idempotencyKey was already used with different input, and Topline keeps the first call. Read the current state before acting (platform_read_build_session for a build session; the original receipt for a domain or address change); the first call may still be pending. To recover the first call, repeat its exact input. To make a different change, send it with a new idempotencyKey." },
|
|
2347
2347
|
artifact_source_unavailable: { retryable: false, recoveryAction: "Topline can't export saved source for this version. For a new app, deploy your local source with platform_deploy_artifact_app first, wait until platform_deploy_operation says it is terminal, then check out. Retrying the checkout unchanged won't create source." },
|
|
2348
2348
|
build_input_target_exists: { retryable: false, recoveryAction: "targetDir already exists, and checkout never writes into an existing directory, so your local edits there are safe. Pass a new directory path that doesn't exist yet." },
|
|
2349
|
-
manual_result_requires_reviewer_skip: { retryable: false, recoveryAction: "A passing builder review needs a reviewer-only check that platform_run_acceptance_checks marked skipped for this version. Run the acceptance checks first, then record
|
|
2349
|
+
manual_result_requires_reviewer_skip: { retryable: false, recoveryAction: "A passing builder review needs a reviewer-only check that platform_run_acceptance_checks marked skipped for this version. Run the acceptance checks first, then record a passed review only for a check whose latest result the runner recorded as a skipped reviewer check." },
|
|
2350
2350
|
manual_result_requires_llm_review_check: { retryable: false, recoveryAction: "This check is run by platform_run_acceptance_checks, so it can't take a builder review. Record reviews only for reviewer-only checks." },
|
|
2351
2351
|
invalid_arguments: { retryable: false, recoveryAction: "The package refused these arguments before calling Topline. The message names the argument that doesn't fit this tool's input schema; fix or drop it and call again." },
|
|
2352
2352
|
build_session_not_active: { retryable: false, recoveryAction: "This build session is closed or expired, so it takes no more changes. Keep your local edits, call platform_start_build_session for the same artifactId with its current artifactVersionId (platform_artifact_status shows it), then repeat the refused call with the new sessionId." },
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"package": {
|
|
4
4
|
"name": "@topline-build/harness-mcp",
|
|
5
|
-
"version": "0.9.
|
|
5
|
+
"version": "0.9.8",
|
|
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.
|
|
15
|
+
"version": "0.9.8"
|
|
16
16
|
}
|
|
17
17
|
},
|
|
18
18
|
"generatedFrom": {
|
|
@@ -353,7 +353,7 @@
|
|
|
353
353
|
{
|
|
354
354
|
"code": "manual_result_requires_reviewer_skip",
|
|
355
355
|
"retryable": false,
|
|
356
|
-
"recoveryAction": "A passing builder review needs a reviewer-only check that platform_run_acceptance_checks marked skipped for this version. Run the acceptance checks first, then record
|
|
356
|
+
"recoveryAction": "A passing builder review needs a reviewer-only check that platform_run_acceptance_checks marked skipped for this version. Run the acceptance checks first, then record a passed review only for a check whose latest result the runner recorded as a skipped reviewer check."
|
|
357
357
|
},
|
|
358
358
|
{
|
|
359
359
|
"code": "manual_result_requires_llm_review_check",
|
|
@@ -4350,7 +4350,7 @@
|
|
|
4350
4350
|
},
|
|
4351
4351
|
{
|
|
4352
4352
|
"name": "platform_record_acceptance_review",
|
|
4353
|
-
"description": "Record the builder's review of a reviewer-only acceptance check. A passed result
|
|
4353
|
+
"description": "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.",
|
|
4354
4354
|
"annotations": {
|
|
4355
4355
|
"title": "Platform Record Acceptance Review",
|
|
4356
4356
|
"readOnlyHint": false,
|
|
@@ -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.
|
|
5
|
+
Package: `@topline-build/harness-mcp@0.9.8`
|
|
6
6
|
Transport: `stdio`
|
|
7
7
|
Default protocol: `2025-11-25`
|
|
8
8
|
Canonical guide: https://topline.build/docs/build-mcp-guide
|
|
@@ -67,7 +67,7 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
|
|
|
67
67
|
- `domain_result_unknown` (not automatically retryable): The response did not establish an outcome. Recover the original receipt through platform_get_artifact_address (saved artifactId and apply key) or platform_read_artifact_domains (request/verify kind and key). Preserve the original plan/domain/input/key; an absent, pending or expired receipt does not authorize a fresh key. No mutation is replayed automatically.
|
|
68
68
|
- `artifact_source_unavailable` (not automatically retryable): Topline can't export saved source for this version. For a new app, deploy your local source with platform_deploy_artifact_app first, wait until platform_deploy_operation says it is terminal, then check out. Retrying the checkout unchanged won't create source.
|
|
69
69
|
- `build_input_target_exists` (not automatically retryable): targetDir already exists, and checkout never writes into an existing directory, so your local edits there are safe. Pass a new directory path that doesn't exist yet.
|
|
70
|
-
- `manual_result_requires_reviewer_skip` (not automatically retryable): A passing builder review needs a reviewer-only check that platform_run_acceptance_checks marked skipped for this version. Run the acceptance checks first, then record
|
|
70
|
+
- `manual_result_requires_reviewer_skip` (not automatically retryable): A passing builder review needs a reviewer-only check that platform_run_acceptance_checks marked skipped for this version. Run the acceptance checks first, then record a passed review only for a check whose latest result the runner recorded as a skipped reviewer check.
|
|
71
71
|
- `manual_result_requires_llm_review_check` (not automatically retryable): This check is run by platform_run_acceptance_checks, so it can't take a builder review. Record reviews only for reviewer-only checks.
|
|
72
72
|
- `build_session_not_active` (not automatically retryable): This build session is closed or expired, so it takes no more changes. Keep your local edits, call platform_start_build_session for the same artifactId with its current artifactVersionId (platform_artifact_status shows it), then repeat the refused call with the new sessionId.
|
|
73
73
|
- `build_session_tool_unavailable` (not automatically retryable): The connection's hosted Build tool list does not offer this build session tool, so the package does not list or run it. Call platform_capability_status to see what is missing, such as a scope or capability, and reconnect through browser sign-in with any missing scope. The package asks the host to list tools again, so the tool comes back once Topline offers it.
|
|
@@ -4346,7 +4346,7 @@ Output schema:
|
|
|
4346
4346
|
|
|
4347
4347
|
### `platform_record_acceptance_review`
|
|
4348
4348
|
|
|
4349
|
-
Record the builder's review of a reviewer-only acceptance check. A passed result
|
|
4349
|
+
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.
|
|
4350
4350
|
|
|
4351
4351
|
Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
|
|
4352
4352
|
|