kalvium-worklog 1.2.0 → 1.3.0

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { Command } from "commander";
 import { captureToken } from "./capture-token.js";
 import { discoverPosition } from "./discover-position.js";
-import { submitWorklog, checkStatus, dailySubmit, catchUpSubmit } from "./submit.js";
+import { submitWorklog, checkStatus, dailySubmit, catchUpSubmit, backfillSubmit } from "./submit.js";
 import { setupScheduler, removeScheduler } from "./scheduler.js";
 import { loadToken, saveConfig, getPositionIdFromToken } from "./config.js";
 import { existsSync } from "fs";
@@ -42,16 +42,18 @@ program
     .command("submit [text]")
     .description("Submit worklog (default text: 'Working on assigned task')")
     .option("--dry-run", "Test without submitting")
+    .option("--date <YYYY-MM-DD>", "Submit for a specific date (backdate)")
     .action(async (text, opts) => {
-    // Skip weekends (unless dry run)
+    // Skip weekends (unless dry run or backdating)
     const day = new Date().getDay();
-    if ((day === 0 || day === 6) && !opts.dryRun) {
+    if ((day === 0 || day === 6) && !opts.dryRun && !opts.date) {
         console.log("It's a weekend — skipping.");
         return;
     }
     const result = await submitWorklog({
         text: text ?? "Working on assigned task",
         dryRun: opts.dryRun,
+        date: opts.date,
     });
     if (!result.success)
         process.exit(1);
@@ -81,6 +83,16 @@ program
     if (!ok)
         process.exit(1);
 });
+// ─── backfill ──────────────────────────────────────────────────────────────
+program
+    .command("backfill [date]")
+    .description("Backfill missed worklogs. No arg = last 5 weekdays. Pass YYYY-MM-DD for a specific date.")
+    .option("--dry-run", "Test without submitting")
+    .action(async (date, opts) => {
+    const ok = await backfillSubmit(date, opts.dryRun);
+    if (!ok)
+        process.exit(1);
+});
 // ─── schedule ──────────────────────────────────────────────────────────────
 program
     .command("schedule [time]")

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { captureToken } from "./capture-token.js";
 export { discoverPosition } from "./discover-position.js";
-export { submitWorklog, checkStatus, dailySubmit, catchUpSubmit } from "./submit.js";
+export { submitWorklog, checkStatus, dailySubmit, catchUpSubmit, backfillSubmit } from "./submit.js";
 export type { SubmitOptions, SubmitResult } from "./submit.js";
 export { setupScheduler, removeScheduler } from "./scheduler.js";
 export type { ScheduleOptions } from "./scheduler.js";

package/dist/index.js

@@ -1,6 +1,6 @@
 export { captureToken } from "./capture-token.js";
 export { discoverPosition } from "./discover-position.js";
-export { submitWorklog, checkStatus, dailySubmit, catchUpSubmit } from "./submit.js";
+export { submitWorklog, checkStatus, dailySubmit, catchUpSubmit, backfillSubmit } from "./submit.js";
 export { setupScheduler, removeScheduler } from "./scheduler.js";
 export { refreshToken } from "./refresh.js";
 export { loadToken, saveToken, loadConfig, saveConfig, getWorklogApi, INSTALL_DIR, TOKEN_FILE, CONFIG_FILE, LOG_FILE, } from "./config.js";

package/dist/submit.d.ts

@@ -1,6 +1,7 @@
 export interface SubmitOptions {
     text?: string;
     dryRun?: boolean;
+    date?: string;
 }
 export interface SubmitResult {
     success: boolean;
@@ -28,3 +29,9 @@ export declare function dailySubmit(): Promise<boolean>;
  * submitted yet, submit it. Used on login/wake to handle missed runs.
  */
 export declare function catchUpSubmit(): Promise<boolean>;
+/**
+ * Backfill: submit worklogs for missed days.
+ * Can backfill a specific date (--date YYYY-MM-DD) or the last N weekdays.
+ * Skips days that already have a submitted worklog.
+ */
+export declare function backfillSubmit(dateStr?: string, dryRun?: boolean): Promise<boolean>;

package/dist/submit.js

@@ -11,6 +11,7 @@ const STATUS_LABEL = "Working on-site (Company location)";
 export async function submitWorklog(options = {}) {
     const text = options.text ?? "Working on assigned task";
     const dryRun = options.dryRun ?? false;
+    const date = options.date; // YYYY-MM-DD or undefined (today)
     const worklogApi = getWorklogApi();
     if (!worklogApi) {
         return {
@@ -18,7 +19,7 @@ export async function submitWorklog(options = {}) {
             message: "No config found. Run `kalvium-worklog discover` first.",
         };
     }
-    const body = JSON.stringify({
+    const payload = {
         title: STATUS_LABEL,
         description: STATUS_LABEL,
         category: STATUS_KEY,
@@ -26,10 +27,15 @@ export async function submitWorklog(options = {}) {
         priorityLevel: "medium",
         blockers: "",
         worklogs: JSON.stringify({ content: `<p>${text}</p>` }),
-    });
+    };
+    // Include worklogDate if backdating
+    if (date) {
+        payload.worklogDate = date;
+    }
+    const body = JSON.stringify(payload);
     if (dryRun) {
         console.log(`[DRY RUN] Would submit to ${worklogApi}`);
-        console.log(`  text='${text}', status=${STATUS_KEY}`);
+        console.log(`  text='${text}', status=${STATUS_KEY}, date=${date ?? "today"}`);
         console.log(`  Body: ${body}`);
         return { success: true, message: "Dry run" };
     }
@@ -270,3 +276,98 @@ export async function catchUpSubmit() {
     log("[INFO] Today's worklog is missing. Running catch-up submit...");
     return dailySubmit();
 }
+/**
+ * Backfill: submit worklogs for missed days.
+ * Can backfill a specific date (--date YYYY-MM-DD) or the last N weekdays.
+ * Skips days that already have a submitted worklog.
+ */
+export async function backfillSubmit(dateStr, dryRun = false) {
+    const worklogApi = getWorklogApi();
+    if (!worklogApi) {
+        console.log("ERROR: No config found. Run `kalvium-worklog discover` first.");
+        return false;
+    }
+    // Determine which dates to backfill
+    let datesToFill = [];
+    if (dateStr) {
+        // Single specific date
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr)) {
+            console.log("ERROR: Date must be in YYYY-MM-DD format.");
+            return false;
+        }
+        datesToFill = [dateStr];
+    }
+    else {
+        // Default: backfill last 5 weekdays (excluding today and weekends)
+        const dates = [];
+        const today = new Date();
+        for (let i = 1; i <= 7; i++) {
+            const d = new Date(today);
+            d.setDate(d.getDate() - i);
+            const day = d.getDay();
+            if (day === 0 || day === 6)
+                continue; // skip weekends
+            dates.push(d.toISOString().slice(0, 10));
+            if (dates.length >= 5)
+                break;
+        }
+        datesToFill = dates;
+    }
+    if (datesToFill.length === 0) {
+        console.log("No weekdays to backfill.");
+        return true;
+    }
+    console.log(`Backfilling ${datesToFill.length} day(s): ${datesToFill.join(", ")}`);
+    // Get already-submitted worklogs to skip them
+    let submittedDates = new Set();
+    const refreshResult = await refreshToken();
+    if (refreshResult.success && refreshResult.accessToken) {
+        try {
+            const res = await fetch(worklogApi, {
+                headers: { authorization: `Bearer ${refreshResult.accessToken}` },
+            });
+            if (res.ok) {
+                const worklogs = await res.json();
+                if (Array.isArray(worklogs)) {
+                    for (const w of worklogs) {
+                        if (w.status === "complete") {
+                            submittedDates.add((w.worklogDate ?? "").slice(0, 10));
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // ignore — will try to submit all dates
+        }
+    }
+    let successCount = 0;
+    let skipCount = 0;
+    let failCount = 0;
+    for (const date of datesToFill) {
+        if (submittedDates.has(date)) {
+            console.log(`  ${date}: already submitted, skipping.`);
+            skipCount++;
+            continue;
+        }
+        if (dryRun) {
+            console.log(`  ${date}: [DRY RUN] would submit.`);
+            successCount++;
+            continue;
+        }
+        console.log(`  ${date}: submitting...`);
+        const result = await submitWorklog({ date });
+        if (result.success) {
+            console.log(`  ${date}: ✓ ${result.message}`);
+            successCount++;
+        }
+        else {
+            console.log(`  ${date}: ✗ ${result.message}`);
+            failCount++;
+        }
+        // Small delay between submissions to avoid rate limiting
+        await sleep(2000);
+    }
+    console.log(`\nBackfill complete: ${successCount} submitted, ${skipCount} skipped, ${failCount} failed.`);
+    return failCount === 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kalvium-worklog",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Auto-submit your daily Kalvium worklog without opening the website",
   "keywords": [
     "kalvium",