@topline-build/harness-mcp 0.5.1 → 0.5.3

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.
Files changed (8) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +4 -0
  3. package/dist/index.d.ts +2 -1
  4. package/dist/index.js +224 -11
  5. package/docs/generated/build-mcp-manifest.json +532 -2
  6. package/docs/generated/build-mcp-reference.md +587 -1
  7. package/package.json +1 -1
  8. package/scripts/certify-live.mjs +15 -3
package/docs/generated/build-mcp-manifest.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.5.1",
5
+ "version": "0.5.3",
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.5.1"
15
+ "version": "0.5.3"
16
16
  }
17
17
  },
18
18
  "generatedFrom": {
@@ -171,6 +171,11 @@
171
171
  "recoveryAction": "Inspect the code and message, correct the input if needed, then retry the same tool."
172
172
  },
173
173
  "catalog": [
174
+ {
175
+ "code": "authorization_required",
176
+ "retryable": false,
177
+ "recoveryAction": "Clear only this connection's cached OAuth credentials, then reconnect the Build MCP through browser sign-in. If using a manual bearer token, replace the expired or revoked token. Recover existing artifact/deployment progress before retrying a write."
178
+ },
174
179
  {
175
180
  "code": "platform_harness_timeout",
176
181
  "retryable": true,
@@ -1643,6 +1648,531 @@
1643
1648
  }
1644
1649
  ]
1645
1650
  },
1651
+ {
1652
+ "name": "platform_get_design_system_state",
1653
+ "description": "Get the tenant Storyboard's published and draft commits, run status, and preview URL before editing or publishing. May reconcile a completed managed draft.",
1654
+ "annotations": {
1655
+ "title": "Platform Get Design System State",
1656
+ "readOnlyHint": false,
1657
+ "destructiveHint": false,
1658
+ "openWorldHint": false
1659
+ },
1660
+ "inputSchema": {
1661
+ "type": "object",
1662
+ "properties": {},
1663
+ "additionalProperties": false
1664
+ },
1665
+ "outputSchema": {
1666
+ "type": "object",
1667
+ "oneOf": [
1668
+ {
1669
+ "type": "object"
1670
+ },
1671
+ {
1672
+ "type": "object",
1673
+ "properties": {
1674
+ "ok": {
1675
+ "const": false
1676
+ },
1677
+ "error": {
1678
+ "type": "object",
1679
+ "properties": {
1680
+ "code": {
1681
+ "type": "string"
1682
+ },
1683
+ "message": {
1684
+ "type": "string"
1685
+ },
1686
+ "retryable": {
1687
+ "type": "boolean"
1688
+ },
1689
+ "recoveryAction": {
1690
+ "type": "string"
1691
+ }
1692
+ },
1693
+ "required": [
1694
+ "code",
1695
+ "message",
1696
+ "retryable",
1697
+ "recoveryAction"
1698
+ ],
1699
+ "additionalProperties": false
1700
+ }
1701
+ },
1702
+ "required": [
1703
+ "ok",
1704
+ "error"
1705
+ ],
1706
+ "additionalProperties": false
1707
+ }
1708
+ ]
1709
+ },
1710
+ "examples": [
1711
+ {
1712
+ "request": {},
1713
+ "success": {}
1714
+ }
1715
+ ]
1716
+ },
1717
+ {
1718
+ "name": "platform_checkout_design_system",
1719
+ "description": "Download the exact published tenant Storyboard source into a new local directory for Codex or Claude Code to edit and run with npm ci and npm run storybook. Never overwrites an existing directory.",
1720
+ "annotations": {
1721
+ "title": "Platform Checkout Design System",
1722
+ "readOnlyHint": false,
1723
+ "destructiveHint": false,
1724
+ "openWorldHint": true
1725
+ },
1726
+ "inputSchema": {
1727
+ "type": "object",
1728
+ "properties": {
1729
+ "targetDir": {
1730
+ "type": "string",
1731
+ "minLength": 1
1732
+ }
1733
+ },
1734
+ "required": [
1735
+ "targetDir"
1736
+ ],
1737
+ "additionalProperties": false
1738
+ },
1739
+ "outputSchema": {
1740
+ "type": "object",
1741
+ "oneOf": [
1742
+ {
1743
+ "type": "object",
1744
+ "properties": {
1745
+ "ok": {
1746
+ "type": "boolean"
1747
+ },
1748
+ "directory": {
1749
+ "type": "string"
1750
+ },
1751
+ "currentCommit": {
1752
+ "type": "string"
1753
+ },
1754
+ "localCommands": {
1755
+ "type": "array",
1756
+ "items": {
1757
+ "type": "string"
1758
+ }
1759
+ }
1760
+ },
1761
+ "required": [
1762
+ "ok",
1763
+ "directory",
1764
+ "currentCommit",
1765
+ "localCommands"
1766
+ ]
1767
+ },
1768
+ {
1769
+ "type": "object",
1770
+ "properties": {
1771
+ "ok": {
1772
+ "const": false
1773
+ },
1774
+ "error": {
1775
+ "type": "object",
1776
+ "properties": {
1777
+ "code": {
1778
+ "type": "string"
1779
+ },
1780
+ "message": {
1781
+ "type": "string"
1782
+ },
1783
+ "retryable": {
1784
+ "type": "boolean"
1785
+ },
1786
+ "recoveryAction": {
1787
+ "type": "string"
1788
+ }
1789
+ },
1790
+ "required": [
1791
+ "code",
1792
+ "message",
1793
+ "retryable",
1794
+ "recoveryAction"
1795
+ ],
1796
+ "additionalProperties": false
1797
+ }
1798
+ },
1799
+ "required": [
1800
+ "ok",
1801
+ "error"
1802
+ ],
1803
+ "additionalProperties": false
1804
+ }
1805
+ ]
1806
+ },
1807
+ "examples": [
1808
+ {
1809
+ "request": {
1810
+ "targetDir": "<targetDir>"
1811
+ },
1812
+ "success": {
1813
+ "ok": true,
1814
+ "directory": "<directory>",
1815
+ "currentCommit": "<currentCommit>",
1816
+ "localCommands": []
1817
+ }
1818
+ }
1819
+ ]
1820
+ },
1821
+ {
1822
+ "name": "platform_submit_design_system_draft",
1823
+ "description": "Package a locally edited Storyboard source directory and submit it as a private draft against exact published and draft revisions. The server validates and builds it before it can be published.",
1824
+ "annotations": {
1825
+ "title": "Platform Submit Design System Draft",
1826
+ "readOnlyHint": false,
1827
+ "destructiveHint": false,
1828
+ "openWorldHint": true
1829
+ },
1830
+ "inputSchema": {
1831
+ "type": "object",
1832
+ "properties": {
1833
+ "localDir": {
1834
+ "type": "string",
1835
+ "minLength": 1
1836
+ },
1837
+ "expectedCurrentCommit": {
1838
+ "type": "string",
1839
+ "pattern": "^[a-f0-9]{40}$"
1840
+ },
1841
+ "expectedDraftRunId": {
1842
+ "anyOf": [
1843
+ {
1844
+ "type": "string",
1845
+ "format": "uuid"
1846
+ },
1847
+ {
1848
+ "type": "null"
1849
+ }
1850
+ ]
1851
+ }
1852
+ },
1853
+ "required": [
1854
+ "localDir",
1855
+ "expectedCurrentCommit",
1856
+ "expectedDraftRunId"
1857
+ ],
1858
+ "additionalProperties": false
1859
+ },
1860
+ "outputSchema": {
1861
+ "type": "object",
1862
+ "oneOf": [
1863
+ {
1864
+ "type": "object",
1865
+ "properties": {
1866
+ "ok": {
1867
+ "type": "boolean"
1868
+ },
1869
+ "runId": {
1870
+ "type": "string"
1871
+ },
1872
+ "draftCommit": {
1873
+ "type": "string"
1874
+ },
1875
+ "draftState": {
1876
+ "type": "string"
1877
+ },
1878
+ "previewUrl": {
1879
+ "type": "string"
1880
+ },
1881
+ "requestId": {
1882
+ "type": "string"
1883
+ },
1884
+ "bundleSha256": {
1885
+ "type": "string"
1886
+ }
1887
+ },
1888
+ "required": [
1889
+ "ok",
1890
+ "runId",
1891
+ "draftCommit",
1892
+ "draftState",
1893
+ "previewUrl",
1894
+ "requestId",
1895
+ "bundleSha256"
1896
+ ]
1897
+ },
1898
+ {
1899
+ "type": "object",
1900
+ "properties": {
1901
+ "ok": {
1902
+ "const": false
1903
+ },
1904
+ "error": {
1905
+ "type": "object",
1906
+ "properties": {
1907
+ "code": {
1908
+ "type": "string"
1909
+ },
1910
+ "message": {
1911
+ "type": "string"
1912
+ },
1913
+ "retryable": {
1914
+ "type": "boolean"
1915
+ },
1916
+ "recoveryAction": {
1917
+ "type": "string"
1918
+ }
1919
+ },
1920
+ "required": [
1921
+ "code",
1922
+ "message",
1923
+ "retryable",
1924
+ "recoveryAction"
1925
+ ],
1926
+ "additionalProperties": false
1927
+ }
1928
+ },
1929
+ "required": [
1930
+ "ok",
1931
+ "error"
1932
+ ],
1933
+ "additionalProperties": false
1934
+ }
1935
+ ]
1936
+ },
1937
+ "examples": [
1938
+ {
1939
+ "request": {
1940
+ "localDir": "<localDir>",
1941
+ "expectedCurrentCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
1942
+ "expectedDraftRunId": "00000000-0000-4000-8000-000000000001"
1943
+ },
1944
+ "success": {
1945
+ "ok": true,
1946
+ "runId": "<runId>",
1947
+ "draftCommit": "<draftCommit>",
1948
+ "draftState": "<draftState>",
1949
+ "previewUrl": "<previewUrl>",
1950
+ "requestId": "<requestId>",
1951
+ "bundleSha256": "<bundleSha256>"
1952
+ }
1953
+ }
1954
+ ]
1955
+ },
1956
+ {
1957
+ "name": "platform_edit_design_system",
1958
+ "description": "Start an asynchronous Storyboard draft edit in an existing writable Topline Storyboard conversation. Pass expectedDraftRunId from the last state read (null for no draft); stale or concurrent retries are rejected.",
1959
+ "annotations": {
1960
+ "title": "Platform Edit Design System",
1961
+ "readOnlyHint": false,
1962
+ "destructiveHint": false,
1963
+ "openWorldHint": true
1964
+ },
1965
+ "inputSchema": {
1966
+ "type": "object",
1967
+ "properties": {
1968
+ "conversationId": {
1969
+ "type": "string",
1970
+ "format": "uuid"
1971
+ },
1972
+ "instruction": {
1973
+ "type": "string",
1974
+ "minLength": 1,
1975
+ "maxLength": 10000
1976
+ },
1977
+ "expectedDraftRunId": {
1978
+ "anyOf": [
1979
+ {
1980
+ "type": "string",
1981
+ "format": "uuid"
1982
+ },
1983
+ {
1984
+ "type": "null"
1985
+ }
1986
+ ]
1987
+ }
1988
+ },
1989
+ "required": [
1990
+ "conversationId",
1991
+ "instruction",
1992
+ "expectedDraftRunId"
1993
+ ],
1994
+ "additionalProperties": false
1995
+ },
1996
+ "outputSchema": {
1997
+ "type": "object",
1998
+ "oneOf": [
1999
+ {
2000
+ "type": "object",
2001
+ "properties": {
2002
+ "runId": {
2003
+ "type": "string"
2004
+ },
2005
+ "previewUrl": {
2006
+ "type": "string"
2007
+ }
2008
+ },
2009
+ "required": [
2010
+ "runId",
2011
+ "previewUrl"
2012
+ ]
2013
+ },
2014
+ {
2015
+ "type": "object",
2016
+ "properties": {
2017
+ "ok": {
2018
+ "const": false
2019
+ },
2020
+ "error": {
2021
+ "type": "object",
2022
+ "properties": {
2023
+ "code": {
2024
+ "type": "string"
2025
+ },
2026
+ "message": {
2027
+ "type": "string"
2028
+ },
2029
+ "retryable": {
2030
+ "type": "boolean"
2031
+ },
2032
+ "recoveryAction": {
2033
+ "type": "string"
2034
+ }
2035
+ },
2036
+ "required": [
2037
+ "code",
2038
+ "message",
2039
+ "retryable",
2040
+ "recoveryAction"
2041
+ ],
2042
+ "additionalProperties": false
2043
+ }
2044
+ },
2045
+ "required": [
2046
+ "ok",
2047
+ "error"
2048
+ ],
2049
+ "additionalProperties": false
2050
+ }
2051
+ ]
2052
+ },
2053
+ "examples": [
2054
+ {
2055
+ "request": {
2056
+ "conversationId": "00000000-0000-4000-8000-000000000001",
2057
+ "instruction": "<instruction>",
2058
+ "expectedDraftRunId": "00000000-0000-4000-8000-000000000001"
2059
+ },
2060
+ "success": {
2061
+ "runId": "<runId>",
2062
+ "previewUrl": "<previewUrl>"
2063
+ }
2064
+ }
2065
+ ]
2066
+ },
2067
+ {
2068
+ "name": "platform_publish_design_system",
2069
+ "description": "Publish the exact reviewed Storyboard draft after its build passes. Managed edits require their writable Storyboard conversation; local submissions require the submitting actor. Always pass state-bound run, draft, and current commits.",
2070
+ "annotations": {
2071
+ "title": "Platform Publish Design System",
2072
+ "readOnlyHint": false,
2073
+ "destructiveHint": true,
2074
+ "openWorldHint": true
2075
+ },
2076
+ "inputSchema": {
2077
+ "type": "object",
2078
+ "properties": {
2079
+ "conversationId": {
2080
+ "type": "string",
2081
+ "format": "uuid"
2082
+ },
2083
+ "expectedDraftRunId": {
2084
+ "type": "string",
2085
+ "format": "uuid"
2086
+ },
2087
+ "expectedDraftCommit": {
2088
+ "type": "string",
2089
+ "pattern": "^[a-f0-9]{40}$"
2090
+ },
2091
+ "expectedCurrentCommit": {
2092
+ "anyOf": [
2093
+ {
2094
+ "type": "string",
2095
+ "pattern": "^[a-f0-9]{40}$"
2096
+ },
2097
+ {
2098
+ "type": "null"
2099
+ }
2100
+ ]
2101
+ }
2102
+ },
2103
+ "required": [
2104
+ "expectedDraftRunId",
2105
+ "expectedDraftCommit",
2106
+ "expectedCurrentCommit"
2107
+ ],
2108
+ "additionalProperties": false
2109
+ },
2110
+ "outputSchema": {
2111
+ "type": "object",
2112
+ "oneOf": [
2113
+ {
2114
+ "type": "object",
2115
+ "properties": {
2116
+ "publishedCommit": {
2117
+ "type": "string"
2118
+ }
2119
+ },
2120
+ "required": [
2121
+ "publishedCommit"
2122
+ ]
2123
+ },
2124
+ {
2125
+ "type": "object",
2126
+ "properties": {
2127
+ "ok": {
2128
+ "const": false
2129
+ },
2130
+ "error": {
2131
+ "type": "object",
2132
+ "properties": {
2133
+ "code": {
2134
+ "type": "string"
2135
+ },
2136
+ "message": {
2137
+ "type": "string"
2138
+ },
2139
+ "retryable": {
2140
+ "type": "boolean"
2141
+ },
2142
+ "recoveryAction": {
2143
+ "type": "string"
2144
+ }
2145
+ },
2146
+ "required": [
2147
+ "code",
2148
+ "message",
2149
+ "retryable",
2150
+ "recoveryAction"
2151
+ ],
2152
+ "additionalProperties": false
2153
+ }
2154
+ },
2155
+ "required": [
2156
+ "ok",
2157
+ "error"
2158
+ ],
2159
+ "additionalProperties": false
2160
+ }
2161
+ ]
2162
+ },
2163
+ "examples": [
2164
+ {
2165
+ "request": {
2166
+ "expectedDraftRunId": "00000000-0000-4000-8000-000000000001",
2167
+ "expectedDraftCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
2168
+ "expectedCurrentCommit": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
2169
+ },
2170
+ "success": {
2171
+ "publishedCommit": "<publishedCommit>"
2172
+ }
2173
+ }
2174
+ ]
2175
+ },
1646
2176
  {
1647
2177
  "name": "platform_validate_artifact",
1648
2178
  "description": "Read trusted smoke and health evidence for a private artifact draft without requiring a browser session.",