@topline-build/harness-mcp 0.9.10 → 0.9.11
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.11 - 2026-11-09
|
|
6
|
+
|
|
7
|
+
- Tool descriptions match the server's: `platform_artifact_validation_status` explains its version check and that an operation from another build session is refused; `platform_request_artifact_validation` gives the `waitMs` range (0 to 1000) and says an approved review leaves the draft ready for an operator to publish; `platform_run_acceptance_checks` says its pass counts cover acceptance checks only and that `renderedSmoke` reports rendered smoke.
|
|
8
|
+
|
|
5
9
|
## 0.9.10 - 2026-11-08
|
|
6
10
|
|
|
7
11
|
- `platform_run_artifact_workspace_sql` takes `scope: "company"` to create and change company tables, matching the server. The Topline sign-in now asks for `harness:company:tables:write`, so your next launch asks you to approve it once.
|
|
@@ -38,17 +38,17 @@ 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.", 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, 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.", {
|
|
47
|
-
...deployed, summary: { type: "string", minLength: 3, maxLength: 4000 }, waitMs: { type: "integer", minimum: 0, maximum: 1000 },
|
|
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.", {
|
|
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
48
|
buildOk: { type: "boolean" }, typecheckOk: { type: "boolean" }, 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
|
-
tool("platform_artifact_validation_status", "Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.", {
|
|
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.", {
|
|
52
52
|
...session, operationId: id, artifactVersionId: id, idempotencyKey: requestKey
|
|
53
53
|
}, ["sessionId", "operationId"], true),
|
|
54
54
|
tool("platform_answer_operator_prompt", "Answer the exact saved operator prompt on the original review operation. Appends guidance and reopens the same eligible session; cannot approve validation or widen the saved grant.", {
|
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.11";
|
|
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.11";
|
|
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([
|
|
@@ -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.11",
|
|
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.11"
|
|
16
16
|
}
|
|
17
17
|
},
|
|
18
18
|
"generatedFrom": {
|
|
@@ -4263,7 +4263,7 @@
|
|
|
4263
4263
|
},
|
|
4264
4264
|
{
|
|
4265
4265
|
"name": "platform_run_acceptance_checks",
|
|
4266
|
-
"description": "Run required acceptance checks for the exact current draft revision through the shared service.",
|
|
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.",
|
|
4267
4267
|
"annotations": {
|
|
4268
4268
|
"title": "Platform Run Acceptance Checks",
|
|
4269
4269
|
"readOnlyHint": false,
|
|
@@ -4586,7 +4586,7 @@
|
|
|
4586
4586
|
},
|
|
4587
4587
|
{
|
|
4588
4588
|
"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.",
|
|
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.",
|
|
4590
4590
|
"annotations": {
|
|
4591
4591
|
"title": "Platform Request Artifact Validation",
|
|
4592
4592
|
"readOnlyHint": false,
|
|
@@ -4624,7 +4624,8 @@
|
|
|
4624
4624
|
"waitMs": {
|
|
4625
4625
|
"type": "integer",
|
|
4626
4626
|
"minimum": 0,
|
|
4627
|
-
"maximum": 1000
|
|
4627
|
+
"maximum": 1000,
|
|
4628
|
+
"description": "Milliseconds to wait for the review before returning, 0 to 1000."
|
|
4628
4629
|
},
|
|
4629
4630
|
"buildOk": {
|
|
4630
4631
|
"type": "boolean"
|
|
@@ -4735,7 +4736,7 @@
|
|
|
4735
4736
|
},
|
|
4736
4737
|
{
|
|
4737
4738
|
"name": "platform_artifact_validation_status",
|
|
4738
|
-
"description": "Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.",
|
|
4739
|
+
"description": "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.",
|
|
4739
4740
|
"annotations": {
|
|
4740
4741
|
"title": "Platform Artifact Validation Status",
|
|
4741
4742
|
"readOnlyHint": true,
|
|
@@ -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.11`
|
|
6
6
|
Transport: `stdio`
|
|
7
7
|
Default protocol: `2025-11-25`
|
|
8
8
|
Canonical guide: https://topline.build/docs/build-mcp-guide
|
|
@@ -4244,7 +4244,7 @@ Output schema:
|
|
|
4244
4244
|
|
|
4245
4245
|
### `platform_run_acceptance_checks`
|
|
4246
4246
|
|
|
4247
|
-
Run required acceptance checks for the exact current draft revision through the shared service.
|
|
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.
|
|
4248
4248
|
|
|
4249
4249
|
Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
|
|
4250
4250
|
|
|
@@ -4600,7 +4600,7 @@ Output schema:
|
|
|
4600
4600
|
|
|
4601
4601
|
### `platform_request_artifact_validation`
|
|
4602
4602
|
|
|
4603
|
-
Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval.
|
|
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.
|
|
4604
4604
|
|
|
4605
4605
|
Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
|
|
4606
4606
|
|
|
@@ -4658,7 +4658,8 @@ Input schema:
|
|
|
4658
4658
|
"waitMs": {
|
|
4659
4659
|
"type": "integer",
|
|
4660
4660
|
"minimum": 0,
|
|
4661
|
-
"maximum": 1000
|
|
4661
|
+
"maximum": 1000,
|
|
4662
|
+
"description": "Milliseconds to wait for the review before returning, 0 to 1000."
|
|
4662
4663
|
},
|
|
4663
4664
|
"buildOk": {
|
|
4664
4665
|
"type": "boolean"
|
|
@@ -4760,7 +4761,7 @@ Output schema:
|
|
|
4760
4761
|
|
|
4761
4762
|
### `platform_artifact_validation_status`
|
|
4762
4763
|
|
|
4763
|
-
Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.
|
|
4764
|
+
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.
|
|
4764
4765
|
|
|
4765
4766
|
Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
|
|
4766
4767
|
|