@detergent-software/atk 8.2.1-dev.1 → 8.3.0-dev.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.3.0-dev.1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv8.2.1&targetVersion=GTv8.3.0-dev.1) (2026-10-06)
+
+### Features
+
+* **cli:** link to the new web app ([1d4f3c6](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/1d4f3c61fc39fb81cc1ad403946b35f66fb08719))
+
+## [8.2.1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv8.2.0&targetVersion=GTv8.2.1) (2026-10-06)
+
+### Bug Fixes
+
+* **cli:** print the JSON error envelope when doctor diagnostics throw (ATK-175) ([09aca7a](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/commit/09aca7ad0be0affd1555816e4a0e2422e7cfb8a0))
+
 ## [8.2.1-dev.1](https://emergentcode.visualstudio.com/Emergent%20Software/_git/Emergent.AgenticToolkit/branchCompare?baseVersion=GTv8.2.0&targetVersion=GTv8.2.1-dev.1) (2026-10-06)
 
 ### Bug Fixes

package/build/lib/web-app.d.ts

@@ -2,14 +2,20 @@
  * Links into the ATK web app, which the CLI shows next to assets and bundles
  * (`info`, `browse`, `list`, `search`).
  *
- * The web app uses hash routing, so every page lives under `#/`:
- * - assets:  `#/assets/{type}/{name}/{version}` plus `?org={org}` when org-scoped
- * - bundles: `#/bundles/{name}` (global) or `#/bundles/{org}/{name}` (org-scoped)
+ * The URL scheme is the web app's own: `webRoutes` from the shared API client,
+ * so every link the CLI prints is one the web can parse. Entity identity is in
+ * the query string:
+ * - assets:  `asset/?type={type}&name={name}[&org={org}]&version={version}`
+ * - bundles: `bundle/?name={name}[&org={org}]` (the page shows the latest version)
  *
- * Orgs are bare in these URLs; the `@` is display syntax only.
+ * Orgs are bare in these URLs; the `@` is display syntax only. Old `#/assets/...`
+ * and `#/bundles/...` links from CLI 8.x are left to the old site's redirect (ATK-39).
+ *
+ * Building a link never throws: a ref the web could not parse (an odd org in a
+ * hand-edited lockfile) links to the web app's home instead.
  */
-/** Production ATK web app. Used when `ATK_WEB_URL` is not set. */
-export declare const DEFAULT_WEB_URL = "https://emergentsoftware.github.io/agentic-toolkit-web/";
+/** Production ATK web app (the prod Static Web App). Used when `ATK_WEB_URL` is not set. */
+export declare const DEFAULT_WEB_URL = "https://ashy-wave-0d3ec6210.3.azurestaticapps.net/";
 /** Environment variable that overrides the web app base URL (e.g. to point at dev). */
 export declare const WEB_URL_ENV_VAR = "ATK_WEB_URL";
 /**
@@ -28,7 +34,7 @@ export declare function buildBundleWebUrl(name: string, org?: string): string;
 /**
  * Resolve the web app base URL, always ending in `/`.
  *
- * Precedence: `ATK_WEB_URL` env var > production.
+ * Precedence: `ATK_WEB_URL` env var (when it is an http(s) URL) > production.
  */
 export declare function getWebUrl(): string;
 //# sourceMappingURL=web-app.d.ts.map

package/build/lib/web-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-app.d.ts","sourceRoot":"","sources":["../../src/lib/web-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kEAAkE;AAClE,eAAO,MAAM,eAAe,4DAA4D,CAAC;AAEzF,uFAAuF;AACvF,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7G;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAGlC"}
+{"version":3,"file":"web-app.d.ts","sourceRoot":"","sources":["../../src/lib/web-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,4FAA4F;AAC5F,eAAO,MAAM,eAAe,uDAAuD,CAAC;AAEpF,uFAAuF;AACvF,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7G;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAIlC"}

package/build/lib/web-app.js

@@ -2,38 +2,64 @@
  * Links into the ATK web app, which the CLI shows next to assets and bundles
  * (`info`, `browse`, `list`, `search`).
  *
- * The web app uses hash routing, so every page lives under `#/`:
- * - assets:  `#/assets/{type}/{name}/{version}` plus `?org={org}` when org-scoped
- * - bundles: `#/bundles/{name}` (global) or `#/bundles/{org}/{name}` (org-scoped)
+ * The URL scheme is the web app's own: `webRoutes` from the shared API client,
+ * so every link the CLI prints is one the web can parse. Entity identity is in
+ * the query string:
+ * - assets:  `asset/?type={type}&name={name}[&org={org}]&version={version}`
+ * - bundles: `bundle/?name={name}[&org={org}]` (the page shows the latest version)
  *
- * Orgs are bare in these URLs; the `@` is display syntax only.
+ * Orgs are bare in these URLs; the `@` is display syntax only. Old `#/assets/...`
+ * and `#/bundles/...` links from CLI 8.x are left to the old site's redirect (ATK-39).
+ *
+ * Building a link never throws: a ref the web could not parse (an odd org in a
+ * hand-edited lockfile) links to the web app's home instead.
  */
-/** Production ATK web app. Used when `ATK_WEB_URL` is not set. */
-export const DEFAULT_WEB_URL = 'https://emergentsoftware.github.io/agentic-toolkit-web/';
+import { assetRef, bundleRef, isAtkError, webRoutes } from './atk-api/index.js';
+/** Production ATK web app (the prod Static Web App). Used when `ATK_WEB_URL` is not set. */
+export const DEFAULT_WEB_URL = 'https://ashy-wave-0d3ec6210.3.azurestaticapps.net/';
 /** Environment variable that overrides the web app base URL (e.g. to point at dev). */
 export const WEB_URL_ENV_VAR = 'ATK_WEB_URL';
 /**
  * Build a web app URL for an asset version's detail page.
  */
 export function buildAssetWebUrl(asset, version) {
-    const query = asset.org ? `?org=${encodeURIComponent(asset.org)}` : '';
-    return `${getWebUrl()}#/assets/${asset.type}/${encodeURIComponent(asset.name)}/${encodeURIComponent(version)}${query}`;
+    return toWebUrl(() => webRoutes.asset(assetRef(asset), { version }));
 }
 /**
  * Build a web app URL for a bundle's detail page. The page always shows the
  * bundle's latest version, so no version is taken.
  */
 export function buildBundleWebUrl(name, org) {
-    const path = org ? `${encodeURIComponent(org)}/${encodeURIComponent(name)}` : encodeURIComponent(name);
-    return `${getWebUrl()}#/bundles/${path}`;
+    return toWebUrl(() => webRoutes.bundle(bundleRef({ name, org })));
 }
 /**
  * Resolve the web app base URL, always ending in `/`.
  *
- * Precedence: `ATK_WEB_URL` env var > production.
+ * Precedence: `ATK_WEB_URL` env var (when it is an http(s) URL) > production.
  */
 export function getWebUrl() {
-    const raw = process.env[WEB_URL_ENV_VAR]?.trim() || DEFAULT_WEB_URL;
+    const override = process.env[WEB_URL_ENV_VAR]?.trim();
+    const raw = override && isHttpUrl(override) ? override : DEFAULT_WEB_URL;
     return raw.endsWith('/') ? raw : `${raw}/`;
 }
+function isHttpUrl(raw) {
+    const url = URL.parse(raw);
+    return url?.protocol === 'http:' || url?.protocol === 'https:';
+}
+/**
+ * Resolve a root-relative `webRoutes` href against the web app base URL.
+ * The leading `/` is dropped so a base with a path (`https://host/app/`) keeps it.
+ */
+function toWebUrl(buildHref) {
+    const root = getWebUrl();
+    try {
+        return new URL(buildHref().slice(1), root).toString();
+    }
+    catch (err) {
+        if (isAtkError(err, 'invalid_input')) {
+            return root;
+        }
+        throw err;
+    }
+}
 //# sourceMappingURL=web-app.js.map

package/build/lib/web-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-app.js","sourceRoot":"","sources":["../../src/lib/web-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,yDAAyD,CAAC;AAEzF,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAmD,EAAE,OAAe;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,GAAG,SAAS,EAAE,YAAY,KAAK,CAAC,IAAI,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC;AACzH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAY;IAC1D,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACvG,OAAO,GAAG,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;IACpE,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"web-app.js","sourceRoot":"","sources":["../../src/lib/web-app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEhF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,eAAe,GAAG,oDAAoD,CAAC;AAEpF,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAmD,EAAE,OAAe;IACnG,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,GAAY;IAC1D,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,GAAG,EAAE,QAAQ,KAAK,OAAO,IAAI,GAAG,EAAE,QAAQ,KAAK,QAAQ,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,SAAuB;IACvC,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,UAAU,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@detergent-software/atk",
-	"version": "8.2.1-dev.1",
+	"version": "8.3.0-dev.1",
 	"description": "Agentic Tool Kit — CLI for managing AI coding tool assets.",
 	"type": "module",
 	"bin": {