@descix/cli 1.0.7 → 1.0.9

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 (43) hide show
  1. package/README.md +1 -1
  2. package/agent-assets/guides/README.md +1 -1
  3. package/agent-assets/guides/dynamic-site-pattern.md +7 -16
  4. package/agent-assets/instructions/app-asset-validation.md +1 -1
  5. package/agent-assets/reference/architecture.md +20 -25
  6. package/agent-assets/reference/local-dev.md +1 -6
  7. package/agent-assets/reference/mcp-integration.md +15 -9
  8. package/agent-assets/reference/platform-api-consumer.md +11 -5
  9. package/agent-assets/reference/workspace-config.md +2 -2
  10. package/bin/descix.js +211 -688
  11. package/lib/command-visibility.js +213 -0
  12. package/lib/commands/corpus.js +2 -5
  13. package/lib/commands/kb.js +2 -2
  14. package/lib/commands/media-upload.js +176 -0
  15. package/lib/commands/retired-kb-sync.js +5 -27
  16. package/lib/commands/status.js +0 -9
  17. package/lib/output.js +31 -0
  18. package/lib/sdk-assets.js +28 -0
  19. package/lib/verb-invokes.generated.json +233 -0
  20. package/lib/workspace-config.js +9 -44
  21. package/package.json +6 -2
  22. package/templates/agent-claude.md +1 -3
  23. package/templates/agent-cline.md +1 -2
  24. package/templates/agent-copilot.md +1 -2
  25. package/templates/agent-cursor.md +1 -2
  26. package/templates/scaffolds/microservice/SERVICE_README_sdk.md +1 -1
  27. package/templates/scaffolds/microservice/templates/SERVICE_README_TEMPLATE.md +2 -3
  28. package/agent-assets/rules/descix_mcp.template.mdc +0 -243
  29. package/lib/commands/briefer/errors.js +0 -88
  30. package/lib/commands/briefer/index.js +0 -322
  31. package/lib/commands/briefer/sources/canonical-sources.js +0 -129
  32. package/lib/commands/briefer/sources/entitlements.js +0 -220
  33. package/lib/commands/briefer/sources/environments.js +0 -205
  34. package/lib/commands/briefer/sources/identifiers.js +0 -214
  35. package/lib/commands/briefer/sources/microservice-deploy.js +0 -267
  36. package/lib/commands/briefer/sources/routing.js +0 -275
  37. package/lib/commands/briefer/sources/what-is-not.js +0 -223
  38. package/lib/commands/briefer/stitcher.js +0 -134
  39. package/lib/commands/briefer/util/source-reader.js +0 -502
  40. package/lib/commands/mcp.js +0 -273
  41. package/lib/commands/update.js +0 -581
  42. package/lib/wizard/setup.js +0 -585
  43. package/templates/descix_mcp.mdc +0 -122
@@ -1,122 +0,0 @@
1
- ---
2
- alwaysApply: true
3
- ---
4
-
5
- ### DeSciX Intelligent Tool Discovery
6
-
7
- **IMPORTANT: Use `tell_me_how` before attempting any DeSciX platform operation.**
8
-
9
- The DeSciX platform uses semantic tool discovery. Instead of memorizing commands:
10
- 1. Ask `tell_me_how` what you want to accomplish
11
- 2. The platform finds relevant tools based on your access level
12
- 3. Execute the recommended tools via `execute_remote_command`
13
-
14
- ### Tool Discovery with Scope Control
15
-
16
- Use `tell_me_how` with appropriate scope:
17
-
18
- - **Project scope** (`--scope project`): When working within a specific project context
19
- ```
20
- tell_me_how({ question: "How do I sync my KB?", scope: "project" })
21
- ```
22
- Uses communities/apps from `.descix/workspace.json`
23
-
24
- - **Entitlements scope** (DEFAULT): When you need actionable tools you can use now
25
- ```
26
- tell_me_how({ question: "How do I deploy a token?" })
27
- ```
28
- Only returns tools from communities you're a member of and apps you own/purchased
29
-
30
- - **Discovery scope** (`--scope discovery`): When exploring platform capabilities
31
- ```
32
- tell_me_how({ question: "What AI training tools exist?", scope: "discovery" })
33
- ```
34
- Returns all tools; indicates which require purchase
35
-
36
- ### Execution Pattern
37
-
38
- After `tell_me_how` returns recommended tools:
39
-
40
- ```javascript
41
- // 1. Ask how to do something
42
- const plan = await tell_me_how({
43
- question: "Create a bonding curve for my community",
44
- scope: "entitlements"
45
- });
46
-
47
- // 2. Execute the recommended command
48
- await execute_remote_command({
49
- command: plan.recommended_tools[0].name,
50
- params: { /* parameters from plan */ }
51
- });
52
- ```
53
-
54
- ### Local Operations
55
-
56
- These tools run locally (no `tell_me_how` needed):
57
-
58
- - `descix_init` - Initialize project with `.descix/workspace.json`
59
- - `descix_wizard_step` - Multi-step wizards (app creation, etc.)
60
- - `git_sync_ops` - Git operations with auto-generated commit messages
61
-
62
- ### Knowledge Base Queries
63
-
64
- For documentation and RAG queries, use `tell_me_how` to discover the right KB:
65
-
66
- ```
67
- tell_me_how({ question: "Where is the SDK authentication documented?" })
68
- ```
69
-
70
- Or query directly if you know the KB:
71
-
72
- - `search_knowledge_base` with `communityId`, `appId`, `kbId`
73
- - `chat_with_kb` for conversational queries
74
-
75
- ### Knowledge Base References
76
-
77
- The DeSciX platform documentation is organized in the `descix/docs` app:
78
-
79
- - **sdk** - SDK documentation, CLI commands, MCP integration
80
- - **architecture** - Platform architecture, design patterns
81
- - **cloud** - Backend services, API, deployment
82
- - **pwa** - Frontend React components, state management
83
- - **contracts** - Smart contracts, token economics
84
-
85
- ### Service Registration
86
-
87
- When registering a new microservice:
88
-
89
- 1. **Create SERVICE_README_{app_id}.md** in the app's Drive folder
90
- 2. Follow the template provided by `descix service register --help`
91
- 3. The README is vectorized for `tell_me_how` discovery
92
-
93
- If the README is missing, the CLI provides AI-friendly instructions you can use directly.
94
-
95
- ### Error Recovery
96
-
97
- If a command fails:
98
-
99
- 1. Use `tell_me_how` to find alternative approaches
100
- 2. Check `search_knowledge_base` for error-specific documentation
101
- 3. Verify scope - you may need `discovery` scope to find the right tool
102
-
103
- ### CLI Quick Reference
104
-
105
- ```bash
106
- # Discover tools (primary command)
107
- descix tell-me-how "What you want to accomplish"
108
- descix tell-me-how --scope project "sync my knowledge base"
109
- descix tell-me-how --scope discovery "what tokenomics tools exist"
110
-
111
- # Local operations
112
- descix init # Initialize project
113
- descix setup # One-time setup
114
-
115
- # Authentication
116
- descix login # Authenticate
117
- descix mcp quickstart # Full MCP setup
118
- ```
119
-
120
- ---
121
-
122
- *This rules file is deployed by `descix mcp init`. Regenerate with `descix mcp quickstart`.*