@topline-build/harness-mcp 0.9.10 → 0.9.12
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,15 @@
|
|
|
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.12 - 2026-11-10
|
|
6
|
+
|
|
7
|
+
- `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.
|
|
8
|
+
- Its `auth.resourceMetadataUrl` names the Storybook MCP's own sign-in metadata. The Build MCP's metadata it named before made Claude Code and Cursor refuse to sign in to that server.
|
|
9
|
+
|
|
10
|
+
## 0.9.11 - 2026-11-09
|
|
11
|
+
|
|
12
|
+
- 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.
|
|
13
|
+
|
|
5
14
|
## 0.9.10 - 2026-11-08
|
|
6
15
|
|
|
7
16
|
- `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.12";
|
|
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[];
|
|
@@ -224,6 +224,7 @@ export declare function storybookAccess(opts: HarnessMcpStdioOptions): {
|
|
|
224
224
|
scope: string;
|
|
225
225
|
manualBearerEnv: string;
|
|
226
226
|
};
|
|
227
|
+
tools: string[];
|
|
227
228
|
operatorAction: string;
|
|
228
229
|
};
|
|
229
230
|
export declare function packArtifactAppDirectory(appDir: string, archivePrefix?: string): Promise<PackedArtifactAppBundle>;
|
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.12";
|
|
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([
|
|
@@ -1547,11 +1547,13 @@ export function storybookAccess(opts) {
|
|
|
1547
1547
|
auth: {
|
|
1548
1548
|
mcp: "topline_harness_bearer_with_harness_artifact_read",
|
|
1549
1549
|
preview: "topline_browser_session",
|
|
1550
|
-
|
|
1550
|
+
// The Storybook MCP's own protected resource: OAuth clients refuse metadata for another address.
|
|
1551
|
+
resourceMetadataUrl: `${baseUrl}/.well-known/oauth-protected-resource/api/design-systems/storybook/mcp`,
|
|
1551
1552
|
scope: "harness:artifact:read",
|
|
1552
1553
|
manualBearerEnv: "TOPLINE_MCP_TOKEN"
|
|
1553
1554
|
},
|
|
1554
|
-
|
|
1555
|
+
tools: ["platform_storybook"],
|
|
1556
|
+
operatorAction: "This is the company's design system Storybook (the components artifacts use), not Topline's own app UI. Read its components with platform_storybook on this connection; no second MCP server is needed. To add the Storybook MCP separately anyway, use cursorMcpJson for MCP clients with HTTP OAuth support, or manualBearerMcpJson with a read-scoped TOPLINE_MCP_TOKEN. Open the preview URL in a browser signed in to Topline."
|
|
1555
1557
|
};
|
|
1556
1558
|
}
|
|
1557
1559
|
export async function packArtifactAppDirectory(appDir, archivePrefix = "") {
|
|
@@ -2083,7 +2085,7 @@ const BUILD_MCP_TOOLS = [
|
|
|
2083
2085
|
},
|
|
2084
2086
|
{
|
|
2085
2087
|
name: "platform_storybook_access",
|
|
2086
|
-
description: "Return the
|
|
2088
|
+
description: "Return the preview URL and optional separate HTTP MCP config for this company's design system Storybook (the components artifacts use, not Topline's own app UI). To read component docs or preview stories, call platform_storybook on this connection instead; no second server is needed.",
|
|
2087
2089
|
annotations: mcpToolAnnotations("platform_storybook_access", { readOnly: true }),
|
|
2088
2090
|
inputSchema: {
|
|
2089
2091
|
type: "object",
|
|
@@ -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.12",
|
|
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.12"
|
|
16
16
|
}
|
|
17
17
|
},
|
|
18
18
|
"generatedFrom": {
|
|
@@ -2054,7 +2054,7 @@
|
|
|
2054
2054
|
},
|
|
2055
2055
|
{
|
|
2056
2056
|
"name": "platform_storybook_access",
|
|
2057
|
-
"description": "Return the
|
|
2057
|
+
"description": "Return the preview URL and optional separate HTTP MCP config for this company's design system Storybook (the components artifacts use, not Topline's own app UI). To read component docs or preview stories, call platform_storybook on this connection instead; no second server is needed.",
|
|
2058
2058
|
"annotations": {
|
|
2059
2059
|
"title": "Platform Storybook Access",
|
|
2060
2060
|
"readOnlyHint": true,
|
|
@@ -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.12`
|
|
6
6
|
Transport: `stdio`
|
|
7
7
|
Default protocol: `2025-11-25`
|
|
8
8
|
Canonical guide: https://topline.build/docs/build-mcp-guide
|
|
@@ -1794,7 +1794,7 @@ Output schema:
|
|
|
1794
1794
|
|
|
1795
1795
|
### `platform_storybook_access`
|
|
1796
1796
|
|
|
1797
|
-
Return the
|
|
1797
|
+
Return the preview URL and optional separate HTTP MCP config for this company's design system Storybook (the components artifacts use, not Topline's own app UI). To read component docs or preview stories, call platform_storybook on this connection instead; no second server is needed.
|
|
1798
1798
|
|
|
1799
1799
|
Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
|
|
1800
1800
|
|
|
@@ -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
|
|