@walruswebdev/daily-devhabit-cli 1.0.5 → 1.1.0

package/README.md

@@ -1,2 +1,235 @@
-# daily-devhabit-cli
-Package for Daily Dev Habit CLI Tool
+# Daily Dev Habit CLI (`ddh`) 🚀
+
+### *Your engineering history — searchable, structured, synced.*
+
+The **Daily Dev Habit CLI** is a frictionless command-line tool that helps developers quickly capture:
+
+* 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**.
+
+---
+
+## ⭐ 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:
+
+```bash
+ddh register
+```
+
+Log in:
+
+```bash
+ddh login
+```
+
+Create your first log:
+
+```bash
+ddh log
+```
+
+Alias for speed:
+
+```bash
+ddh l
+```
+
+---
+
+## 🛠 Commands
+
+### `ddh log` (alias: `l`)
+
+Launches an interactive survey to capture your current work snapshot:
+
+* **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
+```
+
+* Great for:
+
+  * weekly reports
+  * retrospectives
+  * performance reviews
+  * backups
+
+---
+
+### `ddh token`
+
+Displays your current **Cloud API token**.
+
+Used to connect integrations such as the WordPress plugin.
+
+---
+
+### `ddh login`
+
+Authenticates and stores your credentials securely on your machine.
+
+---
+
+### `ddh register`
+
+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.
+
+* CLI detects connectivity loss automatically
+* Switches to **Local Mode**
+* Writes entries to:
+
+```
+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
+
+* 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
+
+---
+
+## 🧭 Roadmap
+
+Planned features:
+
+* 🔍 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,9 +144,94 @@ 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 ---
+program
+    .command('token')
+    .description('Show your current API token')
+    .action(() => {
+    const token = config.get('auth.token');
+    if (token) {
+        console.log('\n🔑 Your Cloud Token:');
+        console.log('---------------------------------------------------');
+        console.log(token);
+        console.log('---------------------------------------------------');
+        console.log('Copy/paste this into your WordPress Settings.\n');
+    }
+    else {
+        console.log('❌ You are not logged in.');
+        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.5",
+  "version": "1.1.0",
   "description": "Package for Daily Dev Habit CLI Tool",
   "main": "dist/index.js",
   "bin": {