@topline-build/harness-mcp 0.9.6 → 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,17 @@
|
|
|
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
|
+
|
|
9
|
+
## 0.9.7 - 2026-11-02
|
|
10
|
+
|
|
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.
|
|
12
|
+
- `build_input_target_exists` says the `targetDir` already exists and to pass a new directory path.
|
|
13
|
+
- `idempotency_conflict` says the key was already used with different input, that Topline keeps the first call (which may still be pending), and to send a different change with a new `idempotencyKey`. It gave domain address advice for build-session calls before.
|
|
14
|
+
- `manual_result_requires_reviewer_skip` and `manual_result_requires_llm_review_check` keep their codes and say what `platform_record_acceptance_review` needs. `platform_record_acceptance_review`'s description now says a passed result needs a check that `platform_run_acceptance_checks` marked skipped, with `evidence.reviewerCheck` true.
|
|
15
|
+
|
|
5
16
|
## 0.9.6 - 2026-11-01
|
|
6
17
|
|
|
7
18
|
- `platform_prepare_artifact_validation` accepts the optional `idempotencyKey` that Topline's own tool list advertises. The package refused it before ("must NOT have additional properties") when it checked the call against its own schema.
|
|
@@ -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 acceptance
|
|
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([
|
|
@@ -2342,6 +2342,12 @@ const BUILD_MCP_RECOVERY_ERROR_VALUES = {
|
|
|
2342
2342
|
...Object.fromEntries([...DOMAIN_ERROR_CODES].map(code => [code, { retryable: false,
|
|
2343
2343
|
recoveryAction: "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect." }])),
|
|
2344
2344
|
domain_result_unknown: { retryable: false, recoveryAction: "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." },
|
|
2345
|
+
// Round 5 J3: also raised by build session tools, so the text can't assume a domain change.
|
|
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
|
+
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
|
+
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 a passed review only for a check whose latest result the runner recorded as a skipped reviewer check." },
|
|
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." },
|
|
2345
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." },
|
|
2346
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." },
|
|
2347
2353
|
build_session_tool_unavailable: { retryable: false, recoveryAction: "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." },
|
|
@@ -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": {
|
|
@@ -303,7 +303,7 @@
|
|
|
303
303
|
{
|
|
304
304
|
"code": "idempotency_conflict",
|
|
305
305
|
"retryable": false,
|
|
306
|
-
"recoveryAction": "Read current
|
|
306
|
+
"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."
|
|
307
307
|
},
|
|
308
308
|
{
|
|
309
309
|
"code": "domain_setup_limit",
|
|
@@ -340,6 +340,26 @@
|
|
|
340
340
|
"retryable": false,
|
|
341
341
|
"recoveryAction": "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."
|
|
342
342
|
},
|
|
343
|
+
{
|
|
344
|
+
"code": "artifact_source_unavailable",
|
|
345
|
+
"retryable": false,
|
|
346
|
+
"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."
|
|
347
|
+
},
|
|
348
|
+
{
|
|
349
|
+
"code": "build_input_target_exists",
|
|
350
|
+
"retryable": false,
|
|
351
|
+
"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."
|
|
352
|
+
},
|
|
353
|
+
{
|
|
354
|
+
"code": "manual_result_requires_reviewer_skip",
|
|
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 a passed review only for a check whose latest result the runner recorded as a skipped reviewer check."
|
|
357
|
+
},
|
|
358
|
+
{
|
|
359
|
+
"code": "manual_result_requires_llm_review_check",
|
|
360
|
+
"retryable": false,
|
|
361
|
+
"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."
|
|
362
|
+
},
|
|
343
363
|
{
|
|
344
364
|
"code": "build_session_not_active",
|
|
345
365
|
"retryable": false,
|
|
@@ -4330,7 +4350,7 @@
|
|
|
4330
4350
|
},
|
|
4331
4351
|
{
|
|
4332
4352
|
"name": "platform_record_acceptance_review",
|
|
4333
|
-
"description": "Record the builder's acceptance
|
|
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.",
|
|
4334
4354
|
"annotations": {
|
|
4335
4355
|
"title": "Platform Record Acceptance Review",
|
|
4336
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
|
|
@@ -57,7 +57,7 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
|
|
|
57
57
|
- `verification_pending` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
|
|
58
58
|
- `verification_rate_limited` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
|
|
59
59
|
- `waiting_for_dns` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
|
|
60
|
-
- `idempotency_conflict` (not automatically retryable): Read current
|
|
60
|
+
- `idempotency_conflict` (not automatically retryable): 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.
|
|
61
61
|
- `domain_setup_limit` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
|
|
62
62
|
- `domain_operation_failed` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
|
|
63
63
|
- `invalid_arguments` (not automatically retryable): 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.
|
|
@@ -65,6 +65,10 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
|
|
|
65
65
|
- `scope_required` (not automatically retryable): Reconnect the Build MCP and approve the requested scope.
|
|
66
66
|
- `domain_tools_require_build_oauth` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
|
|
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
|
+
- `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
|
+
- `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 a passed review only for a check whose latest result the runner recorded as a skipped reviewer check.
|
|
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.
|
|
68
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.
|
|
69
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.
|
|
70
74
|
- `manual_token_sign_in_unavailable` (not automatically retryable): This connection uses a manual bearer token, which only its owner can replace. Ask the person to replace the token in their MCP configuration.
|
|
@@ -4342,7 +4346,7 @@ Output schema:
|
|
|
4342
4346
|
|
|
4343
4347
|
### `platform_record_acceptance_review`
|
|
4344
4348
|
|
|
4345
|
-
Record the builder's acceptance
|
|
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.
|
|
4346
4350
|
|
|
4347
4351
|
Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
|
|
4348
4352
|
|