@contextium/cli 1.0.1 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextium/cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Command-line tool for managing Contextium documentation, agents, skills, and workflows — pipe context to AI coding assistants",
   "keywords": [
     "contextium",

package/skills/ium/new-project.md

@@ -1,26 +1,204 @@
 ---
 name: ium:new-project
-description: Set up a new Contextium project — authenticate, pick a workspace, create libraries, agents, skills, and a workflow
+description: Set up a new Contextium project — authenticate, pick a workspace, describe project, intelligently suggest and create libraries, agents, skills, tags, and a workflow
 allowed-tools:
   - Bash
+  - mcp__contextium__list_workspaces
+  - mcp__contextium__create_context_library
+  - mcp__contextium__list_context_libraries
+  - mcp__contextium__create_agent
+  - mcp__contextium__list_agents
+  - mcp__contextium__create_skill
+  - mcp__contextium__list_skills
+  - mcp__contextium__create_workflow
+  - mcp__contextium__list_workflows
+  - mcp__contextium__list_tags
+  - mcp__contextium__list_tag_types
+  - mcp__contextium__create_tag
+  - mcp__contextium__create_tag_type
+  - AskUserQuestion
 ---
 
 <objective>
-Guide the user through setting up a brand new Contextium project from scratch. This is the first-time onboarding flow — authentication, workspace selection, project structure, and workflow creation.
+Set up a new Contextium project intelligently — understand what the user is trying to do, quietly analyse the workspace for existing resources, then recommend exactly what to create (libraries, agents, skills, tags, workflow) with clear reasoning. Get confirmation before creating anything.
 </objective>
 
+<mode-detection>
+Run this once at the start, silently, to determine which mode to use for the entire session:
+
+```bash
+command -v contextium &>/dev/null && echo "cli" || echo "no-cli"
+```
+
+- If `cli`: use CLI commands throughout. Do not attempt MCP tools.
+- If `no-cli`: check if mcp__contextium__list_workspaces is available. If yes, use MCP tools throughout.
+- If neither: tell the user "Contextium doesn't appear to be installed. Install the CLI with `npm install -g @contextium/cli` or connect the MCP server, then re-run this." Stop here.
+
+Do not mention the mode to the user. Pick one path and stick with it.
+</mode-detection>
+
 <process>
-Run the following command and let the wizard guide the user interactively:
 
+<step name="check_auth">
+**CLI only.** Run silently:
 ```bash
-contextium setup
+contextium whoami 2>/dev/null | grep -E "Token:|Name:" || echo "unauthenticated"
 ```
+If token is expired or unauthenticated, tell the user: "Your Contextium session has expired — run `contextium login` in your terminal, then come back and re-run this." Stop here.
+
+MCP users are already authenticated via the server connection — skip this step.
+</step>
+
+<step name="select_workspace">
+**CLI:** run `contextium workspace list 2>/dev/null` silently, parse workspace names.
+**MCP:** call mcp__contextium__list_workspaces silently.
 
-If the user wants to reconfigure from scratch, run:
+Ask: "Which workspace is this project for?"
+
+Present names only — no IDs, no raw output.
+</step>
+
+<step name="project_description">
+Ask the user this question exactly:
+
+"Tell me about your project — what are you trying to do, what topics are involved, and what kind of work will you be doing with this? The more detail you give me, the better I can set things up for you."
+
+Wait for their response. Store it as the project description. Do not proceed until you have a meaningful answer.
+</step>
+
+<step name="quiet_analysis">
+Silently fetch all existing workspace resources. Do not show raw output or errors. Show only these progress lines as you go:
+
+```
+Searching libraries...
+Searching agents...
+Searching skills...
+Searching tags...
+```
 
+**CLI:**
 ```bash
-contextium setup --force
+contextium library list --workspace <slug> 2>/dev/null
+contextium agent list --workspace <slug> 2>/dev/null
+contextium skill list --workspace <slug> 2>/dev/null
+contextium tag list --workspace <slug> 2>/dev/null
+```
+
+**MCP:** call list_context_libraries, list_agents, list_skills, list_tags — all for the selected workspace. Suppress any errors silently.
+
+After all four searches complete, output this line:
 ```
+Creating Contextium setup plan...
+```
+
+Then analyse the results against the project description:
+- Which existing libraries (if any) are relevant to what the user described?
+- Which existing agents (if any) could serve this project?
+- Which existing skills (if any) are applicable?
+- Which existing tags/tag types (if any) relate to the topics mentioned?
+
+Internally categorise everything as: **reuse** (relevant, already exists) or **create** (needed, does not exist).
+</step>
+
+<step name="intelligent_plan">
+Based on the project description and the analysis, build a setup plan. Think through:
+
+**Libraries:** What distinct knowledge areas did the user mention? Each major topic or type of content that needs to be stored separately should be its own library. If an existing library already covers one of these, mark it for reuse.
+
+**Agents:** What kind of AI assistant roles would serve this project? Think about what tasks the user will perform — research, writing, analysis, Q&A, etc. If an existing agent fits, mark it for reuse.
+
+**Skills:** What reusable knowledge blocks would help agents working on this project? Think about domain-specific guidelines, reference material, or persistent context the agent needs. If an existing skill fits, mark it for reuse.
+
+**Tags:** What topic or category labels would make sense for organising content in this project? Look for existing tag types that match. If none exist, suggest new ones. Think in terms of tag categories (e.g. `topic`, `source`, `status`) and the specific tag values within them (e.g. `topic:space-travel`, `topic:rocket-engineering`).
+
+**Workflow:** Propose one workflow name that bundles everything together for quick loading.
+
+Present the plan in this format (omit any section that has nothing in it):
+
+---
+
+Here's what I'll set up for you:
+
+**New libraries to create**
+- "Library Name" — reason why this is needed
+
+**Existing libraries to reuse**
+- "Library Name" — why it's relevant
+
+**New agents to create**
+- "Agent Name" — what it will do for this project
+
+**Existing agents to reuse**
+- "Agent Name" — why it fits
+
+**New skills to create**
+- "Skill Name" — what knowledge it will hold
+
+**Existing skills to reuse**
+- "Skill Name" — why it fits
+
+**Tags to create**
+- `category:value` — why this label is useful
+
+**Workflow**
+- "Workflow Name" — bundles everything above for quick loading
+
+Shall I go ahead and create all of this?
+
+---
+
+Wait for the user to confirm, adjust, or say skip on any item before proceeding.
+</step>
+
+<step name="create_resources">
+Only create what the user confirmed. Create in this order: tag types → tags → libraries → skills → agents → workflow.
+
+Show `✓ Created "Name"` for each item as it is created. Show `↗ Reusing "Name"` for each existing resource being included.
+
+Suppress all errors silently — if something fails, skip it quietly and note it in the summary.
+
+**CLI commands:**
+```bash
+contextium library create "<name>" --workspace <slug>
+contextium agent create "<name>" --workspace <slug>
+contextium skill create "<name>" --workspace <slug>
+contextium workflow create "<name>" --workspace <slug>
+contextium tag create "<value>" --type <type-slug> --workspace <slug>
+contextium tag-type create "<name>" --workspace <slug>
+```
+
+**MCP:** use the corresponding create_* tools for each resource type.
+</step>
+
+<step name="summary">
+Show a clean final summary:
+
+```
+✓ Project ready
+
+Workspace:   <name>
+Libraries:   <list — new + reused>
+Agents:      <list — new + reused, or none>
+Skills:      <list — new + reused, or none>
+Tags:        <list, or none>
+Workflow:    <name>
+
+Load it anytime with /ium:workflow.
+```
+
+If anything failed to create, add a single line at the end:
+`⚠ Could not create: <list of names> — you can add these manually.`
+</step>
 
-Do not interrupt or wrap the wizard output — let it run fully interactively.
 </process>
+
+<rules>
+- Never say "the wizard", "Contextium would like to know", or "the next step is"
+- Never show raw bash output, API responses, or IDs to the user
+- Run all checks and fetches silently — only surface progress labels and the final plan
+- Only ask questions when genuinely needed — the description step and the confirmation step
+- Do not ask the user what to create — figure it out from the description, then ask them to confirm
+- If a resource already exists and is relevant, always prefer reuse over creating a duplicate
+- The plan report must explain the reasoning for each item — not just list names
+- Never create anything before the user confirms the plan
+</rules>