@sanjay5114/cdx 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,67 @@
+# CDX
+
+CDX — a fast, focused command-line tool that helps developers and teams manage projects, tasks, and settings from the terminal.
+
+Why CDX exists
+- Problem: Developers waste time switching tools and writing repetitive setup scripts.
+- Solution: CDX centralizes common project operations (create, configure, run tasks) with simple commands so you can spend time building, not managing.
+
+Key benefits
+- Save time: Quick project scaffolding and repeatable commands.
+- Consistency: Standardize workflows across machines and teams.
+- Lightweight: Focused feature set that integrates with your existing stack.
+
+Core features
+- Create new projects from templates: `cdx create <name>`
+- Configure project and user settings: `cdx config set <key> <value>`
+- Authentication helpers for secure workflows: `cdx auth login / logout`
+- Task runner for common routines: `cdx run <task>`
+- Scriptable and CI-friendly: works in scripts and automation pipelines
+
+Install
+- From npm: `npm install -g cdx`
+- From local folder: `npm install -g .`
+
+Quick start
+1. Create a project
+   - `cdx create my-app`
+2. Set configuration
+   - `cdx config set editor vim`
+3. Run a task
+   - `cdx run build`
+4. Authenticate (uses secure storage or environment-driven flow)
+   - `cdx auth login`
+
+Examples
+- Create and bootstrap:
+  - `cdx create blog && cd blog && cdx run init`
+- Save a setting:
+  - `cdx config set project.timeout 30`
+
+Configuration
+- Use `cdx config get/set` to manage settings.
+- Configured values can be sourced from environment variables or secure stores; avoid storing sensitive secrets in plaintext files.
+
+Security & privacy
+- Do not commit passwords, API keys, or private tokens to version control.
+- Prefer environment variables, system keychains, or dedicated secret managers for credentials.
+- CDX is designed to avoid embedding sensitive provider-specific implementation details in the README or default configs.
+
+Best practices
+- Add CDX commands to project README or contributor docs for consistent onboarding.
+- Use CI environment variables for automation rather than local secrets.
+- Create lightweight templates for teams to standardize projects.
+
+Contribution
+- Found a bug or have a feature idea? Open an issue or submit a pull request.
+- Keep changes small and well-documented. Add tests for new behavior where possible.
+
+License
+- See `package.json` for the license. Ensure you follow the license when redistributing.
+
+Support & contact
+- Open an issue in the repository for help or feature requests.
+- Include command output and steps to reproduce when reporting bugs.
+
+Thank you for using CDX — built to reduce repetitive work and help teams move faster.
+

package/index.js

@@ -26,7 +26,7 @@ const sleep = ms => new Promise(r => setTimeout(r, ms));
 //  AUTH GATE — runs before any command action
 //  Returns the logged-in user, or null if login was cancelled/failed
 // ─────────────────────────────────────────────────────────────────────────────
-async function requireAuth(inquirer) {
+async function requireAuth(inquirer, opts = {}) {
   // 1. Try to restore existing session silently
   const spin = spinner("Checking session…").start();
   await sleep(300);
@@ -38,13 +38,16 @@ async function requireAuth(inquirer) {
     return user;
   }
 
-  spin.warn("No active session — authentication required");
-  console.log();
+  spin.warn("No active session");
+
+  // 2. If silent mode, return null without prompting
+  if (opts.silent) {
+    return null;
+  }
 
-  // 2. Show Dex prompting login
-  dex("Hey there! I'm Dex, your documentation assistant. You'll need to sign in before we can get started.", "idle");
+  // 3. Prompt user for action
+  dex("Hey there! I'm Dex, your documentation assistant. You can sign in for full features, or continue without login.", "idle");
 
-  // 3. Login / signup choice
   const { authChoice } = await inquirer.prompt([{
     type   : "list",
     name   : "authChoice",
@@ -52,15 +55,14 @@ async function requireAuth(inquirer) {
     choices: [
       { name: `  ${T.brand("◉")}  ${T.whiteBold("Sign In")}    ${T.dim("I already have an account")}`, value: "login" },
       { name: `  ${T.success("◉")}  ${T.whiteBold("Sign Up")}    ${T.dim("Create a new CDX account")}`,  value: "signup" },
-      { name: `  ${T.dim("◉")}  ${T.dim("Exit")}`,                                                       value: "exit" },
+      { name: `  ${T.dim("◉")}  ${T.dim("Continue without login")}`, value: "continue" },
     ],
     prefix: `   ${T.accent(ICONS.arrow)}`,
   }]);
 
-  if (authChoice === "exit") {
-    await typewrite(`\n   ${T.dim("Goodbye! Come back when you're ready.")}`, 18);
-    footer();
-    process.exit(0);
+  if (authChoice === "continue") {
+    note("Continuing without authentication. Some features may be unavailable.");
+    return null;
   }
 
   const apiKey = store.get("firebaseApiKey");  // always returns bundled key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanjay5114/cdx",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Lightning-fast extensible CLI for developer productivity with modular commands, AI integrations, and automation.",
   "keywords": [
     "cli",
@@ -25,6 +25,7 @@
     "access": "public"
   },
   "dependencies": {
+    "cdx": "^0.0.1",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "inquirer": "^8.2.6",