bitcompass 0.2.5 → 0.2.6

package/dist/commands/log.d.ts

@@ -6,4 +6,19 @@ import type { TimeFrame } from '../lib/git-analysis.js';
 export declare const buildAndPushActivityLog: (timeFrame: TimeFrame, cwd: string) => Promise<{
     id: string;
 }>;
-export declare const runLog: () => Promise<void>;
+/**
+ * Push an activity log for a custom date or date range. timeFrame is used for display (day/week/month).
+ */
+export declare const buildAndPushActivityLogWithPeriod: (period: {
+    period_start: string;
+    period_end: string;
+    since: string;
+}, timeFrame: TimeFrame, cwd: string) => Promise<{
+    id: string;
+}>;
+/** Parse argv for log: [start] or [start, end] or [start, '-', end]. Returns { start, end } or null for interactive. */
+export declare const parseLogArgs: (args: string[]) => {
+    start: string;
+    end?: string;
+} | null;
+export declare const runLog: (args?: string[]) => Promise<void>;

package/dist/commands/log.js

@@ -2,7 +2,7 @@ import inquirer from 'inquirer';
 import chalk from 'chalk';
 import { insertActivityLog } from '../api/client.js';
 import { loadCredentials } from '../auth/config.js';
-import { getRepoRoot, getRepoSummary, getGitAnalysis, getPeriodForTimeFrame, } from '../lib/git-analysis.js';
+import { getRepoRoot, getRepoSummary, getGitAnalysis, getPeriodForTimeFrame, getPeriodForCustomDates, } from '../lib/git-analysis.js';
 /**
  * Shared logic: resolve repo, compute period, gather summary + git analysis, insert log.
  * Used by both CLI and MCP. Returns the created log id or throws.
@@ -25,7 +25,55 @@ export const buildAndPushActivityLog = async (timeFrame, cwd) => {
     const created = await insertActivityLog(payload);
     return { id: created.id };
 };
-export const runLog = async () => {
+/**
+ * Push an activity log for a custom date or date range. timeFrame is used for display (day/week/month).
+ */
+export const buildAndPushActivityLogWithPeriod = async (period, timeFrame, cwd) => {
+    const repoRoot = getRepoRoot(cwd);
+    if (!repoRoot) {
+        throw new Error('Not a git repository. Run from a project with git or pass a valid repo path.');
+    }
+    const repo_summary = getRepoSummary(repoRoot);
+    const git_analysis = getGitAnalysis(repoRoot, period.since, period.period_end);
+    const payload = {
+        time_frame: timeFrame,
+        period_start: period.period_start,
+        period_end: period.period_end,
+        repo_summary: repo_summary,
+        git_analysis: git_analysis,
+    };
+    const created = await insertActivityLog(payload);
+    return { id: created.id };
+};
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const isDateArg = (s) => ISO_DATE.test(s.trim());
+/** Parse argv for log: [start] or [start, end] or [start, '-', end]. Returns { start, end } or null for interactive. */
+export const parseLogArgs = (args) => {
+    const trimmed = args.map((a) => a.trim()).filter(Boolean);
+    if (trimmed.length === 0)
+        return null;
+    if (trimmed.length === 1 && isDateArg(trimmed[0]))
+        return { start: trimmed[0] };
+    if (trimmed.length === 2 && isDateArg(trimmed[0]) && isDateArg(trimmed[1])) {
+        return { start: trimmed[0], end: trimmed[1] };
+    }
+    if (trimmed.length === 3 && isDateArg(trimmed[0]) && trimmed[1] === '-' && isDateArg(trimmed[2])) {
+        return { start: trimmed[0], end: trimmed[2] };
+    }
+    throw new Error('Usage: bitcompass log [YYYY-MM-DD] or bitcompass log [YYYY-MM-DD] [YYYY-MM-DD] or bitcompass log [YYYY-MM-DD] - [YYYY-MM-DD]');
+};
+/** Choose time_frame for a custom range by span (day ≤ 1, week ≤ 7, else month). */
+const timeFrameForRange = (start, end) => {
+    const a = new Date(start);
+    const b = new Date(end);
+    const days = Math.round((b.getTime() - a.getTime()) / (24 * 60 * 60 * 1000)) + 1;
+    if (days <= 1)
+        return 'day';
+    if (days <= 7)
+        return 'week';
+    return 'month';
+};
+export const runLog = async (args = []) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
         process.exit(1);
@@ -36,6 +84,14 @@ export const runLog = async () => {
         console.error(chalk.red('Not a git repository. Run this command from a project with git.'));
         process.exit(1);
     }
+    const parsed = parseLogArgs(args);
+    if (parsed) {
+        const period = getPeriodForCustomDates(parsed.start, parsed.end);
+        const timeFrame = parsed.end ? timeFrameForRange(parsed.start, parsed.end) : 'day';
+        const result = await buildAndPushActivityLogWithPeriod(period, timeFrame, cwd);
+        console.log(chalk.green('Log saved.'), chalk.dim(result.id));
+        return;
+    }
     const choice = await inquirer.prompt([
         {
             name: 'time_frame',

package/dist/index.js

@@ -28,9 +28,9 @@ program
     .description('Show current user (email)')
     .action(runWhoami);
 program
-    .command('log')
-    .description('Collect repo summary and git activity, then push to your activity logs')
-    .action(() => runLog().catch(handleErr));
+    .command('log [dates...]')
+    .description('Collect repo summary and git activity, then push to your activity logs. Optional: bitcompass log YYYY-MM-DD or bitcompass log YYYY-MM-DD YYYY-MM-DD')
+    .action((dates) => runLog(dates ?? []).catch(handleErr));
 const configCmd = program.command('config').description('Show or set config');
 configCmd.action(runConfigList);
 configCmd.command('list').description('List config values').action(runConfigList);

package/dist/lib/git-analysis.d.ts

@@ -36,7 +36,13 @@ export declare const getRepoSummary: (repoRoot: string) => RepoSummary;
  * period_end is now; period_start and since are the start of the window.
  */
 export declare const getPeriodForTimeFrame: (timeFrame: TimeFrame) => PeriodBounds;
+/**
+ * Compute period for custom date(s). Single date = that day; two dates = range (inclusive).
+ * period_end is end of last day (23:59:59.999).
+ */
+export declare const getPeriodForCustomDates: (startDateStr: string, endDateStr?: string) => PeriodBounds;
 /**
  * Run git log for the given period and return structured analysis.
+ * If until is provided, commits are limited to the range [since, until].
  */
-export declare const getGitAnalysis: (repoRoot: string, since: string) => GitAnalysisResult;
+export declare const getGitAnalysis: (repoRoot: string, since: string, until?: string) => GitAnalysisResult;

package/dist/lib/git-analysis.js

@@ -72,12 +72,61 @@ export const getPeriodForTimeFrame = (timeFrame) => {
         since,
     };
 };
+/**
+ * Parse an ISO date string (YYYY-MM-DD) to Date at start of day (UTC).
+ */
+const parseDate = (s) => {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(s.trim());
+    if (!match)
+        return null;
+    const y = parseInt(match[1], 10);
+    const m = parseInt(match[2], 10) - 1;
+    const d = parseInt(match[3], 10);
+    const date = new Date(Date.UTC(y, m, d, 0, 0, 0, 0));
+    if (date.getUTCFullYear() !== y || date.getUTCMonth() !== m || date.getUTCDate() !== d)
+        return null;
+    return date;
+};
+/**
+ * Compute period for custom date(s). Single date = that day; two dates = range (inclusive).
+ * period_end is end of last day (23:59:59.999).
+ */
+export const getPeriodForCustomDates = (startDateStr, endDateStr) => {
+    const startDate = parseDate(startDateStr);
+    if (!startDate) {
+        throw new Error(`Invalid start date: ${startDateStr}. Use YYYY-MM-DD.`);
+    }
+    let periodEnd;
+    if (endDateStr !== undefined && endDateStr.trim() !== '') {
+        const endDate = parseDate(endDateStr);
+        if (!endDate)
+            throw new Error(`Invalid end date: ${endDateStr}. Use YYYY-MM-DD.`);
+        if (endDate < startDate)
+            throw new Error('End date must be on or after start date.');
+        periodEnd = new Date(endDate);
+        periodEnd.setUTCHours(23, 59, 59, 999);
+    }
+    else {
+        periodEnd = new Date(startDate);
+        periodEnd.setUTCHours(23, 59, 59, 999);
+    }
+    const period_start = new Date(startDate);
+    period_start.setUTCHours(0, 0, 0, 0);
+    const since = period_start.toISOString();
+    return {
+        period_start: period_start.toISOString(),
+        period_end: periodEnd.toISOString(),
+        since,
+    };
+};
 /**
  * Run git log for the given period and return structured analysis.
+ * If until is provided, commits are limited to the range [since, until].
  */
-export const getGitAnalysis = (repoRoot, since) => {
+export const getGitAnalysis = (repoRoot, since, until) => {
     const format = '%H%x00%s%x00%ci';
-    const logOut = exec(`git log --since="${since}" --format=${format}`, repoRoot);
+    const untilArg = until ? ` --until="${until}"` : '';
+    const logOut = exec(`git log --since="${since}"${untilArg} --format=${format}`, repoRoot);
     const commits = [];
     if (logOut) {
         for (const line of logOut.split('\n')) {
@@ -91,7 +140,7 @@ export const getGitAnalysis = (repoRoot, since) => {
             }
         }
     }
-    const shortstatOut = exec(`git log --since="${since}" --shortstat --format=`, repoRoot);
+    const shortstatOut = exec(`git log --since="${since}"${untilArg} --shortstat --format=`, repoRoot);
     let insertions = 0;
     let deletions = 0;
     if (shortstatOut) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitcompass",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "BitCompass CLI - rules, solutions, and MCP server",
   "type": "module",
   "bin": {