@descix/cli 1.0.5 → 1.0.7

package/agent-assets/reference/architecture.md

@@ -41,7 +41,7 @@ All core SDK logic resides in `DeSciX_Core/descix-cli/lib/core/`.
 
 | Function | Description |
 |----------|-------------|
-| `hydrateWorkspace(root, config, driveConfig, options)` | Full workspace setup with folder creation and Drive sync |
+| `copyScaffold(type, appPath, options)` | Copy the `site` or `microservice` scaffold into an app (`descix site init` / `descix microservice init`) |
 | `hydrateApp(config, options)` | Pull entire app from Drive |
 | `hydrateKb(config, options)` | Pull and convert KB files from Drive |
 | `pushStaging(config, options)` | Upload files from `kb/staging/` to Drive |
@@ -146,33 +146,30 @@ All core SDK logic resides in `DeSciX_Core/descix-cli/lib/core/`.
 
 ```json
 {
-  "version": "2.0",
-  "communities": {
-    "descix": {
-      "apps": {
-        "agent": {
-          "localPath": "descix/agent",
-          "kbId": "General",
-          "absolutePath": "/path/to/workspace/descix/agent",
-          "site": {
-            "port": 3000,
-            "devCommand": "npm run docs:dev"
-          },
-          "service": {
-            "port": 4001,
-            "devCommand": "npm run start"
-          }
-        }
+  "version": "2.1",
+  "type": "workspace",
+  "workspaceRoot": "/path/to/workspace",
+  "env": {
+    "environment": "DEV",
+    "apiUrl": "https://dev.descix.net",
+    "gateway": { "port": 5599 },
+    "products": [
+      {
+        "appId": "daita-agent",
+        "communityId": "daita",
+        "localPath": "daita/agent",
+        "kbId": "General",
+        "site": { "port": 3000 },
+        "microservice": { "port": 4001 }
       }
-    }
+    ]
   },
-  "driveConfig": {
-    "base_folder_id": "1ABC...",
-    "base_folder_name": "DeSciX"
-  }
+  "driveConfig": { "base_folder_id": "1ABC..." }
 }
 ```
 
+Every key is written by a CLI verb (`descix config init --env …`, `descix app init`, `descix app set-site`, `descix app set-port`, …) — see `workspace-config.md` for the key → verb table. A `communities` block without `env` (the v1 shape) is refused on load.
+
 **Note:** `.descix.app/context.json` files are no longer used. All app configuration is stored in `workspace.json`. The CLI auto-detects app context from the current working directory by matching against registered app paths.
 
 ---
@@ -191,7 +188,7 @@ These commands auto-detect app context from `workspace.json` based on the curren
 | `descix app sync-assets` | Sync app assets (icon, description, instructions) to Drive |
 | `descix kb corpus sync` | Full three-stage sync (Local → Drive → GCS → Pinecone) |
 | `descix site upload` | Deploy CodeSite to GCS |
-| ~~`descix update all`~~ | **Deleted.** There is no single all-resources verb. Run the three canonical commands: `descix app sync-assets`, `descix kb corpus sync`, `descix site upload`. |
+| `descix update all` | App assets + site in sequence. It does **not** touch the knowledge base (`update kb` is removed): run `descix kb corpus sync` for that. |
 
 ### 4.2 KB Processing Commands (`descix kb`)
 
@@ -256,15 +253,15 @@ Flow:
 
 ```json
 {
-  "community_id": "descix",
+  "community_id": "daita",
   "app_id": "agent",
   "kb_id": "General",
   "chunks": [
     {
-      "id": "descix_agent_General_research_0",
+      "id": "daita_agent_General_research_0",
       "text": "...",
       "entity_type": "CHUNK",
-      "community_id": "descix",
+      "community_id": "daita",
       "app_id": "agent",
       "knowledgebase_name": "General",
       "file_id": "research.md",

package/agent-assets/reference/local-dev.md

@@ -143,10 +143,6 @@ KB querying will surface. If you fix something there, the fix reaches readers of
 nobody asking the KB — so do not assume KB coverage for a surface that has none. This is a known
 boundary, not a defect.
 
-`descix kb chunk`, `descix kb sync` and `descix update kb` still run but are **superseded
-duplicates** — each names `kb corpus sync` as its replacement in its own `--help` and is slated
-for removal. Do not put them in new instructions.
-
 #### What you put in a KB changes what comes out of it
 
 Retrieval is **vocabulary-dominated**, and when it goes wrong it does so silently. Measured against

package/agent-assets/reference/mcp-integration.md

@@ -71,7 +71,7 @@ All MCP calls include a `_descix` context object for identity propagation:
     expires_at: "..."
   },
   workspace: {
-    community_id: "descix",
+    community_id: "daita",
     app_id: "agent"
   }
 }
@@ -224,7 +224,7 @@ const plan = await tell_me_how({
 const result = await execute_remote_command({
   command: plan.recommended_tools[0].name,
   params: {
-    community_id: "descix",
+    community_id: "daita",
     app_id: "agent",
     kb_id: "General"
   }
@@ -241,19 +241,13 @@ const result = await execute_remote_command({
 descix mcp quickstart
        │
        ▼
-   Prerequisites Check (gcloud, ADC)
+   Requires a prior `descix login` (refuses and names it otherwise)
        │
        ▼
-   Device Login (browser)
+   Setup wizard (lib/wizard/setup.js)
        │
        ▼
-   Workspace Builder (PWA)
-       │
-       ▼
-   Hydration (Hydrator module)
-       │
-       ▼
-   Credentials Saved (.descix/wallet.json)
+   .cursor/rules/descix_mcp.mdc deployed
        │
        ▼
    ✓ Ready for agent interaction
@@ -290,18 +284,17 @@ When `--scope project` is used:
 4. Returns focused recommendations
 
 ```javascript
-// workspace.json
+// workspace.json (v2.1)
 {
-  "communities": {
-    "descix": {
-      "apps": {
-        "agent": { "localPath": ".", "sync_mode": "git" }
-      }
-    }
+  "env": {
+    "apiUrl": "https://dev.descix.net",
+    "products": [
+      { "appId": "daita-agent", "communityId": "daita", "localPath": ".", "kbId": "General" }
+    ]
   }
 }
 
-// tell_me_how with project scope only searches within descix/agent
+// tell_me_how with project scope only searches within daita-agent
 ```
 
 ---
@@ -319,12 +312,11 @@ descix tell-me-how "How do I sync my knowledge base?"
 
 ### 6.2 workspace.json from Hydration
 
-The `Hydrator` module creates `workspace.json` during setup:
+`descix config init --env …` creates `workspace.json`; `descix app init` adds the app's `env.products[]` entry; `descix mcp quickstart` fills `driveConfig.base_folder_id`:
 
 ```javascript
-// Created by Hydrator.hydrateWorkspace()
 {
-  "communities": { ... },
+  "env": { "apiUrl": "https://dev.descix.net", "products": [ /* one entry per app */ ] },
   "driveConfig": {
     "base_folder_id": "..."  // For tell_me_how project scope
   }