@walruswebdev/daily-devhabit-cli 1.0.6 → 1.1.0

package/README.md

@@ -1,79 +1,235 @@
-# Daily Dev Habit CLI 🚀
+# Daily Dev Habit CLI (`ddh`) 🚀
 
-**Engineering Intelligence for the Busy Developer.**
+### *Your engineering history — searchable, structured, synced.*
 
-The **Daily Dev Habit CLI** (`ddh`) is a frictionless command-line tool designed to help software engineers capture decisions, blockers, and progress without leaving the terminal. It serves as the primary data entry point for the Daily Dev Habit ecosystem, syncing your logs to the cloud or saving them locally when offline.
+The **Daily Dev Habit CLI** is a frictionless command-line tool that helps developers quickly capture:
 
-## 📦 Installation
+* what they worked on
+* key decisions made
+* blockers and friction
+* progress and scope
+* useful tags for later search
+
+All **without leaving the terminal**.
+
+Use it to build a lightweight engineering journal, generate weekly status reports, or maintain a decision log across projects — with **cloud sync and offline support**.
+
+---
+
+## ✨ Why Daily Dev Habit exists
+
+Developers face real problems:
+
+* You forget what you worked on two days ago
+* Status reports take longer than they should
+* Decisions aren’t documented and must be re-explained
+* Context switching destroys memory
+* Performance reviews rely on “remembering everything you did”
+
+**Daily Dev Habit solves this by making logging effortless.**
+
+It prompts you from the terminal and records your work in structured form — to the cloud or locally — so your engineering history is **searchable, exportable, and actually usable**.
 
-Install the tool globally via NPM:
+---
+
+## ⭐ Key Features
+
+* 🧠 **Structured engineering journal** right in your terminal
+* ☁️ **Cloud sync** (with secure auth token)
+* ✈️ **Offline-first**: falls back to Markdown logs automatically
+* 🏷 **Tagging support** for fast categorization
+* 📝 **Markdown export** for reporting & backups
+* 🔌 **WordPress plugin integration available**
+* 🚀 Minimal setup – works across platforms
+
+---
+
+## 📦 Installation
 
 ```bash
 npm install -g @walruswebdev/daily-devhabit-cli
 ```
 
+Verify install:
+
+```bash
+ddh --version
+```
+
+---
+
 ## ⚡ Quick Start
-Register a new account:
+
+Register:
 
 ```bash
 ddh register
 ```
 
-Log in to sync with the cloud:
+Log in:
+
 ```bash
 ddh login
 ```
 
-Create your first log entry:
+Create your first log:
 
 ```bash
 ddh log
 ```
 
-(Or use the alias ddh l for speed)
+Alias for speed:
+
+```bash
+ddh l
+```
+
+---
 
 ## 🛠 Commands
-`ddh log` (alias: `l`)
-The core command. Launches an interactive survey to capture your current work state.
 
-- Scope: API, Database, Refactor, Feature, etc.
+### `ddh log` (alias: `l`)
+
+Launches an interactive survey to capture your current work snapshot:
 
-- Summary: What did you just do?
+* **Scope** – API, DB, Feature, Refactor, etc.
+* **Summary** – What did you do?
+* **Key Decisions** – what you chose & why
+* **Friction** – blockers / pain points
+* **Tags** – comma-separated keywords
+
+---
+
+### `ddh export`
+
+> New in **v1.1.0**
+
+Exports your entire engineering history as Markdown.
+
+* Fetches your logs from the cloud
+* Generates a timestamped file like:
+
+```
+ddh_export_2025-12-26_20-45.md
+```
 
-- Key Decisions: Did you choose a specific library or pattern? Why?
+* Great for:
 
-- Friction: What slowed you down?
+  * weekly reports
+  * retrospectives
+  * performance reviews
+  * backups
 
-- Tags: Comma-separated tags for categorization.
+---
 
 ### `ddh token`
-Displays your current Cloud API Token.
 
-- Use Case: Copy this token to connect your Daily Dev Habit WordPress Plugin to your cloud account.
+Displays your current **Cloud API token**.
+
+Used to connect integrations such as the WordPress plugin.
+
+---
 
 ### `ddh login`
-Authenticates your session and saves your credentials locally to `~/.config/daily-devhabit-cli-nodejs/`.
+
+Authenticates and stores your credentials securely on your machine.
+
+---
 
 ### `ddh register`
-Creates a new user account on the Daily Dev Habit platform.
 
-## 🔌 WordPress Integration
-This CLI works hand-in-hand with the Daily Dev Habit WordPress Plugin.
+Creates a new Daily Dev Habit cloud account.
+
+---
+
+## 🔌 WordPress Integration (Optional)
+
+The CLI integrates with the [Daily Dev Habit WordPress Plugin](https://dailydevhabit.com/download/).
+
+1. Run:
+
+```bash
+ddh token
+```
+
+2. Copy your API token
+3. Paste it inside:
+
+> WordPress Admin → Daily Dev Habit → Settings
+
+Your WordPress site can now send engineering metrics from an Admin Dashboard form. 
+This is helpful for less technical users and/or capturing different aspects of the project development.
+
+---
+
+## 🛡 Offline Support
+
+No internet? No problem.
 
-1. Run `ddh token` in your terminal.
+* CLI detects connectivity loss automatically
+* Switches to **Local Mode**
+* Writes entries to:
 
-2. Copy the output string.
+```
+OFFLINE_LOGS.md
+```
+
+* Stored in the **current working directory**
+* Uses clean Markdown formatting
+
+
+---
+
+## 🏗 Tech Stack (for contributors and curious devs)
+
+* **Commander** – command routing & argument parsing
+* **Inquirer** – interactive CLI questions
+* **Axios** – HTTP networking to backend API
+* **Conf** – secure local token storage
+* **Path** – cross-platform path reliability
+* **fs** – file system writing for offline/export support
+
+---
+
+## 🎯 Who this tool is great for
 
-3. Paste it into your WordPress Admin > Daily Dev Habit > Settings.
+* solo developers and indie hackers
+* engineers who context-switch frequently
+* freelancers writing client status reports
+* teams wanting light-weight telemetry
+* devs building a **“brag document”**
+* people who hate filling out retro forms Friday afternoon
 
-4. Result: Your WordPress site will now pull in your engineering metrics and logs automatically.
+---
 
-## 🛡️ Offline Support
-Bad internet? No problem. If the CLI cannot connect to the server (or if you are not logged in), it automatically falls back to Local Mode.
+## 🧭 Roadmap
 
-- Logs are saved to a file named OFFLINE_LOGS.md in your current working directory.
+Planned features:
 
-- Markdown formatted for easy reading.
+* 🔍 search logs from the CLI
+* 📊 metrics dashboards
+* 🤝 team workspaces
+* 🧩 plugin integration ecosystem
+* ⏱ daily reminder option
+
+Contributions & ideas welcome!
+
+---
+
+## 🤝 Contributing
+
+Pull requests are very welcome — especially since this is an early project.
+
+Good first contributions:
+
+* docs improvements
+* CLI UX polish
+* validation of prompts
+* bug reports
+* ideas & feature proposals
+
+---
 
 ## 📝 License
+
 ISC © Lauren Bridges

package/dist/index.js

@@ -10,14 +10,14 @@ const axios_1 = __importDefault(require("axios"));
 const conf_1 = __importDefault(require("conf"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
-// 1. Initialize Configuration Store (Saves to user's computer)
+// 1. Initialize Configuration Store
 const config = new conf_1.default({ projectName: 'daily-devhabit-cli' });
 const program = new commander_1.Command();
 // 2. DEFINE THE CONNECTION
 const DEFAULT_API_URL = 'https://ddh-core-production.up.railway.app';
 const API_URL = process.env.API_URL || DEFAULT_API_URL;
 program
-    .version('1.1.0')
+    .version('1.1.1')
     .description('Daily Dev Habit: Engineering Intelligence CLI');
 // --- COMMAND: LOGIN ---
 program
@@ -32,7 +32,7 @@ program
     try {
         const response = await axios_1.default.post(`${API_URL}/auth/login`, credentials);
         const token = response.data.token;
-        // Save Token and User Info to global config
+        // Save Token
         config.set('auth.token', token);
         config.set('auth.email', credentials.email);
         console.log('✅ Login Successful! Token saved locally.');
@@ -59,19 +59,16 @@ program
         console.error('❌ Registration Failed:', error.response?.data?.message || error.message);
     }
 });
-// --- COMMAND: LOG (The Main Event) ---
+// --- COMMAND: LOG ---
 program
     .command('log')
     .alias('l')
     .description('Create a new engineering log entry')
     .action(async () => {
-    // 1. Get Token from Config (or Env as backup)
     const token = config.get('auth.token') || process.env.DEV_CLI_TOKEN;
     if (!token) {
         console.log('❌ You are not logged in. Please run: ddh login');
-        // We don't return here because you might want to log offline even if logged out
     }
-    // 2. Interactive Prompt
     const answers = await inquirer_1.default.prompt([
         {
             type: 'list',
@@ -113,23 +110,20 @@ program
         origin: 'cli'
     };
     try {
-        // 3. Try to Send to API
-        if (!token) {
-            throw new Error('No token available (Login required for Cloud Sync).');
-        }
+        if (!token)
+            throw new Error('No token available.');
         const response = await axios_1.default.post(`${API_URL}/entries`, payload, {
             headers: { Authorization: `Bearer ${token}` }
         });
         console.log(`\n✅ Log Saved! (ID: ${response.data.id})`);
-        console.log(`   Stored in: Cloud Database (${API_URL})`);
+        console.log(`   Stored in: Cloud Database`);
     }
     catch (error) {
-        // 4. FALLBACK: Handle Offline State
+        // OFFLINE FALLBACK
         const isOffline = error.code === 'ECONNREFUSED' || error.code === 'ENOTFOUND';
         const isAuthError = !token || (error.response && error.response.status === 401);
         if (isOffline || isAuthError) {
             console.log('\n⚠️  Could not sync to Cloud. Switching to Local Backup...');
-            // Format for Markdown
             const timestamp = new Date().toISOString();
             const backupEntry = `
 ## [OFFLINE] ${timestamp}
@@ -141,8 +135,6 @@ program
 - **Tags:** ${payload.tags.join(', ')}
 ---
 `;
-            // Append to OFFLINE_LOGS.md in project root
-            // We use process.cwd() to find the user's current project folder, not the CLI's folder
             const backupPath = path_1.default.join(process.cwd(), 'OFFLINE_LOGS.md');
             fs_1.default.appendFileSync(backupPath, backupEntry);
             console.log(`✅ Log saved locally to: ${backupPath}`);
@@ -152,12 +144,11 @@ program
                 console.log('👉 Reason: Server is unreachable.');
         }
         else {
-            // Real Error (e.g. 500 Server Error)
             console.error('❌ Error:', error.response?.data?.message || error.message);
         }
     }
 });
-// --- COMMAND: TOKEN (New!) ---
+// --- COMMAND: TOKEN ---
 program
     .command('token')
     .description('Show your current API token')
@@ -175,4 +166,72 @@ program
         console.log('Run "ddh login" first to generate a token.');
     }
 });
+// --- COMMAND: EXPORT ---
+program
+    .command('export')
+    .description('Download all cloud logs to a timestamped Markdown file')
+    .action(async () => {
+    // 1. Get Token
+    const token = config.get('auth.token') || process.env.DEV_CLI_TOKEN;
+    if (!token) {
+        console.error('❌ Authentication required. Please run "ddh login" first.');
+        return;
+    }
+    try {
+        console.log('⏳ Fetching logs from Daily Dev Habit Cloud...');
+        const response = await axios_1.default.get(`${API_URL}/entries`, {
+            headers: { Authorization: `Bearer ${token}` }
+        });
+        const rows = response.data;
+        if (!rows || rows.length === 0) {
+            console.log('⚠️ No logs found to export.');
+            return;
+        }
+        // 2. Generate Timestamped Filename
+        const now = new Date();
+        // Format: YYYY-MM-DD_HH-mm-ss
+        const timeString = now.toISOString().replace(/T/, '_').replace(/\..+/, '').replace(/:/g, '-');
+        const filename = `ddh_export_${timeString}.md`;
+        // 3. Format Markdown
+        let markdownContent = '# Daily Dev Habit Export\n\n';
+        markdownContent += `> Exported on ${now.toLocaleString()}\n\n`;
+        rows.forEach((row) => {
+            const date = new Date(row.created_at).toISOString().split('T')[0];
+            const scopeBadge = row.scope ? `**[${row.scope.toUpperCase()}]**` : '';
+            markdownContent += `## ${date} ${scopeBadge}\n`;
+            if (row.decision || row.rationale) {
+                // Engineering Log
+                if (row.content)
+                    markdownContent += `* **Note:** ${row.content}\n`;
+                if (row.decision)
+                    markdownContent += `* **Decision:** ${row.decision}\n`;
+                if (row.rationale)
+                    markdownContent += `* **Rationale:** ${row.rationale}\n`;
+                if (row.friction)
+                    markdownContent += `* **Friction:** ⚠️ ${row.friction}\n`;
+                if (row.tags && row.tags.length > 0)
+                    markdownContent += `* *Tags:* \`${row.tags}\`\n`;
+            }
+            else {
+                // Journal/Simple Log
+                const text = row.content || row.content_html || 'No content';
+                markdownContent += `* ${text}\n`;
+            }
+            markdownContent += '\n---\n\n';
+        });
+        // 4. Save File
+        const outputPath = path_1.default.join(process.cwd(), filename);
+        fs_1.default.writeFileSync(outputPath, markdownContent);
+        console.log(`✅ Successfully exported ${rows.length} entries.`);
+        console.log(`📂 File saved to: ${outputPath}`);
+    }
+    catch (error) {
+        if (error.response && error.response.status === 401) {
+            console.error('❌ Unauthorized: Token invalid. Try "ddh login" again.');
+        }
+        else {
+            console.error('❌ Export failed:', error.message);
+        }
+    }
+});
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walruswebdev/daily-devhabit-cli",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "Package for Daily Dev Habit CLI Tool",
   "main": "dist/index.js",
   "bin": {