@descix/cli 1.0.7 → 1.0.9

package/lib/verb-invokes.generated.json

@@ -0,0 +1,233 @@
+{
+  "admin-login": [
+    "admin_bootstrap_login"
+  ],
+  "airdrop execute-queue": [
+    "airdrop_execute_queue"
+  ],
+  "app delete": [
+    "delete_app"
+  ],
+  "app init": [
+    "create_app_for_community",
+    "get_product_context",
+    "init_git_mode_kb"
+  ],
+  "app invite": [
+    "create_app_invite"
+  ],
+  "app list": [
+    "fetch_my_purchases"
+  ],
+  "app media-upload": [
+    "get_asset_upload_token"
+  ],
+  "app open": [],
+  "app set-api-url": [
+    "update_app_metadata"
+  ],
+  "app set-default-model": [
+    "clear_app_default_model",
+    "set_app_default_model"
+  ],
+  "app set-listed": [
+    "update_app"
+  ],
+  "app set-localpath": [],
+  "app set-name": [
+    "update_app"
+  ],
+  "app set-port": [],
+  "app set-price": [
+    "update_app_metadata"
+  ],
+  "app set-repo": [
+    "set_app_repo"
+  ],
+  "app set-site": [],
+  "app sync-assets": [
+    "sync_app_assets"
+  ],
+  "app unmap": [],
+  "buy chains": [],
+  "buy poll": [
+    "get_quote_status"
+  ],
+  "buy quote": [
+    "create_crypto_quote"
+  ],
+  "buy status": [
+    "get_quote_status"
+  ],
+  "chat": [
+    "ask_multiple_apps",
+    "ask_question_to_app"
+  ],
+  "clone": [
+    "get_repo_credentials"
+  ],
+  "community check-token": [
+    "check_token_symbol_available"
+  ],
+  "community contract": [
+    "get_contract_details"
+  ],
+  "community create": [
+    "create_community_skeleton"
+  ],
+  "community delete": [
+    "delete_community"
+  ],
+  "community deploy-token": [
+    "deploy_contract"
+  ],
+  "community info": [
+    "get_community"
+  ],
+  "community link-token": [
+    "link_contract_to_community"
+  ],
+  "community list": [
+    "find_communities"
+  ],
+  "community rename": [
+    "rename_community"
+  ],
+  "config init": [],
+  "config set-dev-certs": [],
+  "config set-env": [],
+  "config set-gateway-port": [],
+  "config set-powch-url": [],
+  "config set-site-url": [],
+  "config set-url": [],
+  "config show": [],
+  "credits balance": [
+    "get_credit_balance"
+  ],
+  "credits buy": [
+    "create_stripe_checkout_session"
+  ],
+  "credits grant": [
+    "grant_credits"
+  ],
+  "credits history": [
+    "get_credit_history"
+  ],
+  "credits refund": [
+    "refund_credits"
+  ],
+  "doctor": [],
+  "drive pull": [],
+  "drive push": [],
+  "health": [],
+  "init": [
+    "find_communities",
+    "resolve_invite"
+  ],
+  "kb clear-override-model": [
+    "clear_kb_model_override"
+  ],
+  "kb corpus status": [],
+  "kb corpus sync": [
+    "get_kb_rag_status",
+    "get_product_context",
+    "kb_delete_chunks",
+    "kb_list_file_ids",
+    "kb_sync_chunks",
+    "list_knowledge_bases"
+  ],
+  "kb delete": [
+    "delete_knowledge_base"
+  ],
+  "kb doctor": [
+    "get_kb_rag_status"
+  ],
+  "kb list": [
+    "list_knowledge_bases"
+  ],
+  "kb set-override-model": [
+    "set_kb_model_override"
+  ],
+  "login": [
+    "device_check_status",
+    "device_request_login",
+    "sync_auto_purchases"
+  ],
+  "logout": [],
+  "mcp execute": [],
+  "mcp-serve": [],
+  "microservice health": [
+    "service_health_check"
+  ],
+  "microservice init": [],
+  "microservice list": [
+    "list_services"
+  ],
+  "microservice register": [
+    "register_service"
+  ],
+  "microservice register-delegate": [
+    "fetch_my_purchases",
+    "register_delegate"
+  ],
+  "microservice reload": [
+    "reload_service_manifests"
+  ],
+  "microservice restart": [],
+  "microservice vectorize": [
+    "vectorize_service_readme"
+  ],
+  "new-chat": [],
+  "purchases": [
+    "fetch_my_purchases"
+  ],
+  "quickstart": [
+    "device_check_status",
+    "device_request_login",
+    "find_communities",
+    "resolve_invite",
+    "sync_auto_purchases"
+  ],
+  "reconnect": [
+    "reconnect_by_wallet"
+  ],
+  "referral create": [
+    "generate_referral_code"
+  ],
+  "role create": [
+    "create_role"
+  ],
+  "serve": [],
+  "site delete": [
+    "delete_site_files"
+  ],
+  "site init": [],
+  "site list": [
+    "list_site_files"
+  ],
+  "site status": [
+    "get_site_manifest"
+  ],
+  "site upload": [
+    "confirm_site_deploy",
+    "get_site_build_config",
+    "get_site_deploy_token"
+  ],
+  "stats": [
+    "get_user_community_stats"
+  ],
+  "status": [],
+  "store generate-summary": [
+    "generate_entity_summary"
+  ],
+  "store search": [
+    "search_store"
+  ],
+  "tell-me-how": [
+    "tell_me_how"
+  ],
+  "whoami": [
+    "fetch_my_purchases",
+    "validate_session"
+  ]
+}

package/lib/workspace-config.js

@@ -263,11 +263,9 @@ export class WorkspaceConfig {
    * Live means the actual object inside this.env — mutate it and save() persists the mutation.
    * getAppByAppId() and getAppEntry() both return copies and are useless for writing.
    *
-   * This existed as three byte-identical copies (setSitePort, setMicroservicePort,
-   * setStaticSite) and `set-localpath` hand-rolled a FOURTH variant in bin/descix.js that
-   * walked env.products ONLY. That omission is the whole reason the platform app silently
-   * failed: the loop found nothing, wrote nothing, and the command still printed success.
-   * A fourth copy here would have reproduced the same class of bug, so there is now one.
+   * The one lookup every entry setter (setMicroservicePort, setStaticSite, setLocalPath) uses. A
+   * private walk of env.products ONLY misses the platform app, finds nothing, writes nothing and
+   * still reports success.
    *
    * @param {string} appId - App identifier
    * @returns {Object} the live env.platform or env.products[] entry
@@ -289,8 +287,7 @@ export class WorkspaceConfig {
   /**
    * Update an app's localPath in env.platform or env.products[].
    *
-   * The canonical write path for localPath, and the sibling that was missing while
-   * setSitePort/setMicroservicePort/setStaticSite all existed. Backs `descix app set-localpath`.
+   * The canonical write path for localPath. Backs `descix app set-localpath`.
    *
    * localPath MUST be workspace-root-relative. It is validated here through
    * resolveWorkspacePath — the LOADER'S OWN resolver, not a second copy of its rules — so a
@@ -807,48 +804,16 @@ export class WorkspaceConfig {
     return this.save();
   }
 
-  /**
-   * Update an app's site.port in env.products[] (or env.platform if it is the platform app).
-   *
-   * Pass `null` to remove site.port; if site.{} becomes empty, site.{} is also deleted.
-   * Persists via save() at the end — same auto-save pattern as setEnvironment().
-   * Hard-fails if appId is not mapped in env.platform or env.products.
-   *
-   * @param {string} appId - App identifier (must exist in env.platform or env.products)
-   * @param {number|string|null} port - Port number to set, or null to remove site.port
-   * @returns {Promise<string>} Path to saved config (from save())
-   */
-  async setSitePort(appId, port) {
-    if (!appId) throw new Error('appId is required');
-
-    const entry = this._liveEnvEntry(appId);
-
-    if (port === null || port === undefined) {
-      // Remove site.port; clean up empty site.{}
-      if (entry.site) {
-        delete entry.site.port;
-        if (Object.keys(entry.site).length === 0) {
-          delete entry.site;
-        }
-      }
-    } else {
-      if (!entry.site) entry.site = {};
-      entry.site.port = port;
-    }
-
-    return this.save();
-  }
-
   /**
    * Update an app's microservice.port in env.products[] (or env.platform if it is the platform app).
    *
-   * Parallel to setSitePort(), but operates on the entry's microservice.{} slot.
+   * Operates on the entry's microservice.{} slot.
    * This is the canonical write path for the microservice port that `descix microservice init`
    * reads (and hard-fails on if missing). Backs the `descix app set-port` command, closing
    * WS-CLI-MESH-ROUTING-GAP without hand-editing workspace.json.
    *
    * Pass `null` to remove microservice.port; if microservice.{} becomes empty, it is also deleted.
-   * Persists via save() at the end — same auto-save pattern as setSitePort()/setEnvironment().
+   * Persists via save() at the end — same auto-save pattern as setEnvironment().
    * Hard-fails if appId is not mapped in env.platform or env.products.
    *
    * @param {string} appId - App identifier (must exist in env.platform or env.products)
@@ -879,7 +844,7 @@ export class WorkspaceConfig {
   /**
    * Update an app's site config in env.products[] (or env.platform if it is the platform app).
    *
-   * Parallel to setSitePort()/setMicroservicePort(), but operates on the entry's site.{} slot's
+   * Parallel to setMicroservicePort(), but operates on the entry's site.{} slot's
    * static-site fields. This is the canonical write path for site.static — the relative path the
    * dev gateway's staticSitePlugin serves at /p/{appId}/ (see createViteProxyConfig:
    * site.static is resolved against the app's localPath; "." means the localPath itself).
@@ -888,7 +853,7 @@ export class WorkspaceConfig {
    *
    * Mutates site.static and/or site.port. Pass static === null to remove site.static; pass
    * port === null to remove site.port. If site.{} becomes empty after removals it is deleted.
-   * Persists via save() at the end — same auto-save pattern as setSitePort()/setMicroservicePort().
+   * Persists via save() at the end — same auto-save pattern as setMicroservicePort().
    * Hard-fails if appId is not mapped in env.platform or env.products.
    *
    * @param {string} appId - App identifier (must exist in env.platform or env.products)
@@ -914,7 +879,7 @@ export class WorkspaceConfig {
       }
     }
 
-    // site.port — set or remove (parallel to setSitePort, for static+devCommand sites)
+    // site.port — set or remove (for static+devCommand sites)
     if ('port' in fields) {
       if (fields.port === null || fields.port === undefined) {
         delete entry.site.port;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descix/cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "DeSciX CLI and MCP Server - Unified command-line interface for DeSciX platform",
   "repository": {
     "type": "git",
@@ -16,7 +16,8 @@
   "scripts": {
     "test": "node --test \"tests/*.test.js\"",
     "pack": "npm pack",
-    "check:doc-paths": "node scripts/check-doc-paths.js"
+    "check:doc-paths": "node scripts/check-doc-paths.js",
+    "briefer": "node scripts/briefer/run.mjs"
   },
   "keywords": [
     "descix",
@@ -41,6 +42,9 @@
     "ora": "^9.0.0",
     "@descix/platform-api": "^2.0.0"
   },
+  "devDependencies": {
+    "acorn": "^8.18.0"
+  },
   "files": [
     "bin",
     "lib",

package/templates/agent-claude.md

@@ -159,7 +159,7 @@ To see your app in a browser:
 | Goal | Command |
 |------|---------|
 | Serve `site/` locally | `npx serve site/` or `python3 -m http.server -d site/` on any port |
-| Register port with DeSciX | `descix site servelocal <port> -c <community> -a <app>` |
+| Register a framework dev-server port with DeSciX | `descix app set-site -a <app> --port <port>` (writes `env.products[].site.port`) |
 | Run your app on the DeSciX gateway | `cd <app dir> && descix serve` — one HTTPS origin, the shell opens ON your app (**standalone** = initial view, not a reduced mode — platform views stay reachable) |
 
 A plain static server is enough to look at your HTML. `descix serve` is what you
@@ -257,8 +257,6 @@ Every app has three parts:
 
 - `descix status` may report "No workspace found" even when `.descix/workspace.json`
   exists. This is a known bug — continue with explicit flags.
-- `descix status` may suggest `descix setup` — that command doesn't exist. Use
-  `descix init -c <community> -a <app> -p .` instead.
 
 ## Cloud Brain Alignment
 

package/templates/agent-cline.md

@@ -121,7 +121,7 @@ descix kb corpus status -c <community> -a <app>
 | Goal | Command |
 |------|---------|
 | Serve `site/` locally | `npx serve site/` or `python3 -m http.server -d site/` on any port |
-| Register port with DeSciX | `descix site servelocal <port> -c <community> -a <app>` |
+| Register a framework dev-server port with DeSciX | `descix app set-site -a <app> --port <port>` (writes `env.products[].site.port`) |
 | Run your app on the DeSciX gateway | `cd <app dir> && descix serve` — one HTTPS origin, the shell opens ON your app (**standalone** = initial view, not a reduced mode — platform views stay reachable) |
 
 A plain static server is enough to look at your HTML. `descix serve` is what you
@@ -171,7 +171,6 @@ gateway does not rewrite paths.
 ## Known CLI Quirks
 
 - `descix status` may show "No workspace found" even when config exists — use explicit flags
-- `descix status` may suggest `descix setup` — use `descix init` instead
 
 ## Cloud Brain Alignment
 

package/templates/agent-copilot.md

@@ -121,7 +121,7 @@ descix kb corpus status -c <community> -a <app>
 | Goal | Command |
 |------|---------|
 | Serve `site/` locally | `npx serve site/` or `python3 -m http.server -d site/` on any port |
-| Register port with DeSciX | `descix site servelocal <port> -c <community> -a <app>` |
+| Register a framework dev-server port with DeSciX | `descix app set-site -a <app> --port <port>` (writes `env.products[].site.port`) |
 | Run your app on the DeSciX gateway | `cd <app dir> && descix serve` — one HTTPS origin, the shell opens ON your app (**standalone** = initial view, not a reduced mode — platform views stay reachable) |
 
 A plain static server is enough to look at your HTML. `descix serve` is what you
@@ -171,7 +171,6 @@ gateway does not rewrite paths.
 ## Known CLI Quirks
 
 - `descix status` may show "No workspace found" even when config exists — use explicit flags
-- `descix status` may suggest `descix setup` — use `descix init` instead
 
 ## Cloud Brain Alignment
 

package/templates/agent-cursor.md

@@ -121,7 +121,7 @@ descix kb corpus status -c <community> -a <app>
 | Goal | Command |
 |------|---------|
 | Serve `site/` locally | `npx serve site/` or `python3 -m http.server -d site/` on any port |
-| Register port with DeSciX | `descix site servelocal <port> -c <community> -a <app>` |
+| Register a framework dev-server port with DeSciX | `descix app set-site -a <app> --port <port>` (writes `env.products[].site.port`) |
 | Run your app on the DeSciX gateway | `cd <app dir> && descix serve` — one HTTPS origin, the shell opens ON your app (**standalone** = initial view, not a reduced mode — platform views stay reachable) |
 
 A plain static server is enough to look at your HTML. `descix serve` is what you
@@ -171,7 +171,6 @@ gateway does not rewrite paths.
 ## Known CLI Quirks
 
 - `descix status` may show "No workspace found" even when config exists — use explicit flags
-- `descix status` may suggest `descix setup` — use `descix init` instead
 
 ## Cloud Brain Alignment
 

package/templates/scaffolds/microservice/SERVICE_README_sdk.md

@@ -112,7 +112,7 @@ descix tell-me-how --scope discovery "What AI training tools exist?"
 ### descix app init
 
 **Description:** Create (if needed) and initialize an app: platform record + default KB + local workspace registration and scaffold. Idempotent.
-**Use when:** Starting a new project or hydrating an existing app. This is the single canonical path — the old two-step `app create` then `app init` is deleted; `descix app create` now hard-fails naming this replacement.
+**Use when:** Starting a new project or hydrating an existing app. This is the one command that creates an app.
 **Options:**
 - `-a, --app <app_id>` (required): App ID. With `-c` this is the app NAME to create.
 - `-c, --community <id>`: Community ID — required to create an app that does not exist yet

package/templates/scaffolds/microservice/templates/SERVICE_README_TEMPLATE.md

@@ -13,8 +13,7 @@ Run this sequence ONCE to stand up a microservice that can call the mesh
 `/apifront` broker:
 
 ```bash
-descix app create   -c {community} -a {app}     # create the app (or hydrate an existing one)
-descix app init      -a {community}-{app}        # scaffold site/ kb/ microservice/
+descix app init      -c {community} -a {app}     # create the app (or hydrate an existing one) and scaffold it
 descix app set-port  -a {community}-{app} -p {port}   # assign the microservice's loopback port in workspace.json
 descix microservice register                     # register the service manifest with the Core gateway
 # then: cp dev-overrides.example.json dev-overrides.json  and fill in the developer credential
@@ -117,7 +116,7 @@ descix microservice register                     # register the service manifest
 **Example:**
 ```bash
 # Using the CLI
-descix service call {command_name} --param1 value
+descix mcp execute --tool {command_name} --params '{"param1": "value"}'
 
 # Or via tell_me_how
 tell_me_how("I want to {describe the workflow goal}")