work-chronicler 0.3.0 → 0.3.2

package/.agent/skills/work-chronicler-detect-projects/SKILL.md

@@ -57,6 +57,17 @@ Analyze work history to identify major projects and group related work.
    - Consider temporal clustering (work in same 2-4 week period)
    - Use PR labels and repository patterns
 
+## Output Location
+
+**IMPORTANT:** You must do BOTH of the following:
+
+1. **Respond in-thread** with the project summary (for immediate feedback and MCP integration)
+2. **Save to file**: `<profile-root>/outputs/projects-detected-YYYY-MM-DD.md`
+
+Get the profile root with: `work-chronicler workspace root`
+
+This ensures users have both immediate feedback AND a persistent file they can reference later.
+
 ## Project Summary Format
 
 For each project, gather:

package/.agent/skills/work-chronicler-detect-themes/SKILL.md

@@ -77,6 +77,17 @@ Work data is stored in the workspace work-log directory:
    - PR titles and descriptions keywords
    - Timeline trends (what themes emerged when?)
 
+## Output Location
+
+**IMPORTANT:** You must do BOTH of the following:
+
+1. **Respond in-thread** with the themes analysis (for immediate feedback and MCP integration)
+2. **Save to file**: `<profile-root>/outputs/themes-detected-YYYY-MM-DD.md`
+
+Get the profile root with: `work-chronicler workspace root`
+
+This ensures users have both immediate feedback AND a persistent file they can reference later.
+
 ## Output Format
 
 ```markdown

package/.agent/skills/work-chronicler-generate-resume-bullets/SKILL.md

@@ -66,7 +66,14 @@ Work data is stored in the workspace work-log directory:
 
 ## Output Location
 
-Save generated documents to `generated/resume-bullets-YYYY-MM-DD.md` in the workspace root.
+**IMPORTANT:** You must do BOTH of the following:
+
+1. **Respond in-thread** with the resume bullets (for immediate feedback and MCP integration)
+2. **Save to file**: `<profile-root>/outputs/resume-bullets-YYYY-MM-DD.md`
+
+Get the profile root with: `work-chronicler workspace root`
+
+This ensures users have both immediate feedback AND a persistent file they can reference later.
 
 ## Bullet Point Format
 

package/.agent/skills/work-chronicler-summarize-work/SKILL.md

@@ -65,6 +65,17 @@ Generate a summary including:
 - **Timeline**: Busiest periods, activity trends
 - **Notable Contributions**: Largest PRs, most complex changes
 
+## Output Location
+
+**IMPORTANT:** You must do BOTH of the following:
+
+1. **Respond in-thread** with the work summary (for immediate feedback and MCP integration)
+2. **Save to file**: `<profile-root>/outputs/work-summary-YYYY-MM-DD.md`
+
+Get the profile root with: `work-chronicler workspace root`
+
+This ensures users have both immediate feedback AND a persistent file they can reference later.
+
 ## Example Output
 
 ```markdown

package/.agent/skills/work-chronicler-update-resume/SKILL.md

@@ -104,7 +104,14 @@ Work data is stored in the workspace work-log directory:
 
 ## Output Location
 
-Save generated documents to `generated/resume-updated-YYYY-MM-DD.md` in the workspace root.
+**IMPORTANT:** You must do BOTH of the following:
+
+1. **Respond in-thread** with the resume updates (for immediate feedback and MCP integration)
+2. **Save to file**: `<profile-root>/outputs/resume-updated-YYYY-MM-DD.md`
+
+Get the profile root with: `work-chronicler workspace root`
+
+This ensures users have both immediate feedback AND a persistent file they can reference later.
 
 ## Output Format
 

package/.agent/skills/work-chronicler-write-self-review/SKILL.md

@@ -75,7 +75,14 @@ Work data is stored in the workspace work-log directory:
 
 ## Output Location
 
-Save generated documents to `generated/self-review-YYYY-MM-DD.md` in the workspace root.
+**IMPORTANT:** You must do BOTH of the following:
+
+1. **Respond in-thread** with the self-review (for immediate feedback and MCP integration)
+2. **Save to file**: `<profile-root>/outputs/self-review-YYYY-MM-DD.md`
+
+Get the profile root with: `work-chronicler workspace root`
+
+This ensures users have both immediate feedback AND a persistent file they can reference later.
 
 ## Output Format
 

package/README.md

@@ -275,7 +275,15 @@ See [work-chronicler.example.yaml](work-chronicler.example.yaml) for a complete
 
 ### GitHub Token
 
-Create a personal access token at https://github.com/settings/tokens with the `repo` scope (or `public_repo` for public repos only).
+Create a personal access token at https://github.com/settings/tokens with the following scopes:
+
+**Required:**
+- `repo` (for private repos) or `public_repo` (for public repos only)
+
+**Required for auto-discovery with organizations:**
+- `read:org` - Needed to query organization repositories during `init` auto-discovery
+
+Without `read:org`, you can still use work-chronicler by entering repos manually during setup.
 
 ### JIRA Token
 

package/dist/cli/commands/analyze/reports.d.ts

@@ -5,7 +5,7 @@
  */
 import { Command } from 'commander';
 /**
- * analyze reports <id> command
+ * analyze reports [id] command
  */
 export declare const reportsCommand: Command;
 //# sourceMappingURL=reports.d.ts.map

package/dist/cli/commands/analyze/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/analyze/reports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,eAAO,MAAM,cAAc,SAiTvB,CAAC"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/analyze/reports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,eAAO,MAAM,cAAc,SAmUvB,CAAC"}

package/dist/cli/commands/analyze/reports.js

@@ -7,17 +7,19 @@ import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { classifyPRImpact, detectProjects, generateStats, generateTimeline, } from '../../analyzer/index.js';
 import { getAnalysisFilePath, readAllPRs, readAllTickets, writeMarkdownFile, } from '../../../core/index.js';
+import { select } from '@inquirer/prompts';
 import { getActiveProfile } from '../../../core/workspace/global-config.js';
+import { listReports } from '../../../core/workspace/report-manager.js';
 import { getReportAnalysisDir, getReportWorkLogDir, isManagerMode, } from '../../../core/workspace/resolver.js';
 import chalk from 'chalk';
 import { Command } from 'commander';
 import ora from 'ora';
 /**
- * analyze reports <id> command
+ * analyze reports [id] command
  */
 export const reportsCommand = new Command('reports')
     .description('Generate per-report analysis (manager mode only)')
-    .argument('<id>', 'Report ID (e.g., "alice-smith")')
+    .argument('[id]', 'Report ID (e.g., "alice-smith")')
     .option('--tag-prs', 'Update PR files with impact tags')
     .option('--projects', 'Detect and group related PRs/tickets into projects')
     .option('--timeline', 'Generate chronological timeline grouped by week/month')
@@ -32,6 +34,22 @@ export const reportsCommand = new Command('reports')
             process.exit(1);
         }
         const profileName = activeProfile;
+        // If no report ID provided, prompt to select one
+        if (!reportId) {
+            const reports = listReports(profileName);
+            if (reports.length === 0) {
+                console.error(chalk.red('\n❌ No reports configured.'));
+                console.log(chalk.gray('Add reports with "reports add"'));
+                process.exit(1);
+            }
+            reportId = await select({
+                message: 'Select a report to analyze:',
+                choices: reports.map((r) => ({
+                    name: `${r.name} (${r.github})`,
+                    value: r.id,
+                })),
+            });
+        }
         // Get report-specific paths
         const workLogDir = getReportWorkLogDir(profileName, reportId);
         const analysisDir = getReportAnalysisDir(profileName, reportId);

package/dist/cli/commands/fetch/all.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fetch/all.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwMpC,eAAO,MAAM,UAAU,SA2BnB,CAAC"}
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fetch/all.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8LpC,eAAO,MAAM,UAAU,SA2BnB,CAAC"}

package/dist/cli/commands/fetch/all.js

@@ -10,7 +10,7 @@ import { isManagerMode } from '../../../core/workspace/resolver.js';
 import chalk from 'chalk';
 import { Command } from 'commander';
 import { resolveCacheBehavior } from './fetch.utils.js';
-import { getReportById, resolveReportIds, resolveReportOutputDir, } from './fetch-manager.utils.js';
+import { buildReportConfig, getReportById, loadManagerConfigForFetch, resolveReportIds, resolveReportOutputDir, } from './fetch-manager.utils.js';
 import { fetchGitHubPRs } from './github/github.utils.js';
 import { fetchJiraTickets } from './jira/jira.utils.js';
 /**
@@ -89,28 +89,16 @@ async function fetchAllICMode(options) {
 async function fetchAllManagerMode(options) {
     const reportIds = await resolveReportIds(options);
     console.log(chalk.blue(`\n📥 Fetching all data for ${reportIds.length} report(s)...\n`));
-    // Load config once outside loop (for efficiency)
-    const baseConfig = await loadConfig(options.config);
+    // Load manager config once outside loop (for efficiency)
+    const managerConfig = loadManagerConfigForFetch();
     for (let i = 0; i < reportIds.length; i++) {
         const reportId = reportIds[i];
         const report = getReportById(reportId);
         console.log(chalk.blue(`\n=== Fetching data for ${report.name} (${i + 1}/${reportIds.length}) ===\n`));
         try {
             const outputDir = resolveReportOutputDir(reportId);
-            // Override config with report's credentials
-            const reportConfig = {
-                ...baseConfig,
-                github: {
-                    ...baseConfig.github,
-                    username: report.github, // Use report's GitHub username
-                },
-                jira: baseConfig.jira
-                    ? {
-                        ...baseConfig.jira,
-                        email: report.email, // Use report's Jira email
-                    }
-                    : undefined,
-            };
+            // Build IC-compatible config from manager config + report
+            const reportConfig = buildReportConfig(managerConfig, report);
             // Determine cache behavior - prompt if data exists and --cache not specified
             const useCache = await resolveCacheBehavior({
                 outputDir,

package/dist/cli/commands/fetch/fetch-manager.utils.d.ts

@@ -1,7 +1,8 @@
 /**
  * Manager mode fetch utilities
  */
-import type { ReportConfig } from '../../../core/types/manager.js';
+import type { Config } from '../../../core/config/schema.js';
+import type { ManagerConfig, ReportConfig } from '../../../core/types/manager.js';
 /**
  * Resolve report ID(s) for fetch operation
  *
@@ -26,4 +27,22 @@ export declare function getReportById(reportId: string): ReportConfig;
  * @returns Absolute path to report's work-log directory
  */
 export declare function resolveReportOutputDir(reportId: string): string;
+/**
+ * Load and return the manager config for the active profile.
+ *
+ * @returns Manager config validated against ManagerConfigSchema
+ */
+export declare function loadManagerConfigForFetch(): ManagerConfig;
+/**
+ * Build an IC-compatible Config from a manager config and a specific report.
+ *
+ * The fetch utilities (fetchGitHubPRs, fetchJiraTickets, linkPRsToTickets)
+ * all expect a Config (IC schema). This function bridges the gap by
+ * constructing one from the manager config + per-report overrides.
+ *
+ * @param managerConfig - The manager profile config
+ * @param report - The specific report to build the config for
+ * @returns A Config object compatible with IC fetch utilities
+ */
+export declare function buildReportConfig(managerConfig: ManagerConfig, report: ReportConfig): Config;
 //# sourceMappingURL=fetch-manager.utils.d.ts.map

package/dist/cli/commands/fetch/fetch-manager.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-manager.utils.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fetch/fetch-manager.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOtD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyDpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D"}
+{"version":3,"file":"fetch-manager.utils.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fetch/fetch-manager.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOrE;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyDpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAa5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,aAAa,CAGzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,YAAY,GACnB,MAAM,CA+CR"}

package/dist/cli/commands/fetch/fetch-manager.utils.js

@@ -81,3 +81,68 @@ export function resolveReportOutputDir(reportId) {
     const activeProfile = getActiveProfile();
     return getReportWorkLogDir(activeProfile, reportId);
 }
+/**
+ * Load and return the manager config for the active profile.
+ *
+ * @returns Manager config validated against ManagerConfigSchema
+ */
+export function loadManagerConfigForFetch() {
+    const activeProfile = getActiveProfile();
+    return loadManagerConfig(activeProfile);
+}
+/**
+ * Build an IC-compatible Config from a manager config and a specific report.
+ *
+ * The fetch utilities (fetchGitHubPRs, fetchJiraTickets, linkPRsToTickets)
+ * all expect a Config (IC schema). This function bridges the gap by
+ * constructing one from the manager config + per-report overrides.
+ *
+ * @param managerConfig - The manager profile config
+ * @param report - The specific report to build the config for
+ * @returns A Config object compatible with IC fetch utilities
+ */
+export function buildReportConfig(managerConfig, report) {
+    // Build GitHub orgs array from manager org + report repos
+    const orgs = [
+        {
+            name: managerConfig.github.org,
+            repos: report.repos.length > 0 ? report.repos : ['*'],
+        },
+    ];
+    // Build JIRA instances from manager's JIRA config + report's projects
+    const jira = managerConfig.jira && report.jiraProjects.length > 0
+        ? {
+            instances: [
+                {
+                    name: managerConfig.jira.host,
+                    url: managerConfig.jira.host.startsWith('https://')
+                        ? managerConfig.jira.host
+                        : `https://${managerConfig.jira.host}`,
+                    email: report.email,
+                    token: managerConfig.jira.token,
+                    projects: report.jiraProjects,
+                },
+            ],
+        }
+        : undefined;
+    return {
+        github: {
+            username: report.github,
+            token: managerConfig.github.token,
+            orgs,
+        },
+        jira,
+        output: { directory: './work-log' },
+        fetch: {
+            since: managerConfig.fetch.since,
+            until: managerConfig.fetch.until,
+        },
+        analysis: {
+            thresholds: {
+                minor: { maxLines: 20, maxFiles: 3 },
+                major: { minLines: 200, minFiles: 8 },
+                flagship: { minLines: 500, minFiles: 15 },
+            },
+        },
+    };
+}

package/dist/cli/commands/fetch/github/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/fetch/github/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwHpC,eAAO,MAAM,aAAa,SA0BtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/fetch/github/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoHpC,eAAO,MAAM,aAAa,SA0BtB,CAAC"}

package/dist/cli/commands/fetch/github/index.js

@@ -11,7 +11,7 @@ import { getActiveProfile } from '../../../../core/workspace/global-config.js';
 import { isManagerMode } from '../../../../core/workspace/resolver.js';
 import chalk from 'chalk';
 import { Command } from 'commander';
-import { getReportById, resolveReportIds, resolveReportOutputDir, } from '../fetch-manager.utils.js';
+import { buildReportConfig, getReportById, loadManagerConfigForFetch, resolveReportIds, resolveReportOutputDir, } from '../fetch-manager.utils.js';
 import { fetchGitHubPRs } from './github.utils.js';
 /**
  * Fetch GitHub PRs in IC mode
@@ -43,22 +43,16 @@ async function fetchGitHubICMode(options) {
 async function fetchGitHubManagerMode(options) {
     const reportIds = await resolveReportIds(options);
     console.log(chalk.blue(`\n📥 Fetching GitHub PRs for ${reportIds.length} report(s)...\n`));
-    // Load base config
-    const baseConfig = await loadConfig(options.config);
+    // Load manager config
+    const managerConfig = loadManagerConfigForFetch();
     for (let i = 0; i < reportIds.length; i++) {
         const reportId = reportIds[i];
         const report = getReportById(reportId);
         console.log(chalk.blue(`\nFetching data for ${report.name} (${i + 1}/${reportIds.length})...`));
         try {
             const outputDir = resolveReportOutputDir(reportId);
-            // Override github.username with report's username
-            const reportConfig = {
-                ...baseConfig,
-                github: {
-                    ...baseConfig.github,
-                    username: report.github, // Use report's GitHub username, not manager's
-                },
-            };
+            // Build IC-compatible config from manager config + report
+            const reportConfig = buildReportConfig(managerConfig, report);
             // Determine cache behavior - prompt if data exists and --cache not specified
             let useCache = options.cache;
             if (!options.cache) {

package/dist/cli/commands/fetch/jira/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/fetch/jira/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2HpC,eAAO,MAAM,WAAW,SA0BpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/fetch/jira/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqHpC,eAAO,MAAM,WAAW,SA0BpB,CAAC"}

package/dist/cli/commands/fetch/jira/index.js

@@ -11,7 +11,7 @@ import { getActiveProfile } from '../../../../core/workspace/global-config.js';
 import { isManagerMode } from '../../../../core/workspace/resolver.js';
 import chalk from 'chalk';
 import { Command } from 'commander';
-import { getReportById, resolveReportIds, resolveReportOutputDir, } from '../fetch-manager.utils.js';
+import { buildReportConfig, getReportById, loadManagerConfigForFetch, resolveReportIds, resolveReportOutputDir, } from '../fetch-manager.utils.js';
 import { fetchJiraTickets } from './jira.utils.js';
 /**
  * Fetch Jira tickets in IC mode
@@ -43,24 +43,16 @@ async function fetchJiraICMode(options) {
 async function fetchJiraManagerMode(options) {
     const reportIds = await resolveReportIds(options);
     console.log(chalk.blue(`\n📥 Fetching Jira tickets for ${reportIds.length} report(s)...\n`));
-    // Load base config (will be overridden per-report)
-    const baseConfig = await loadConfig(options.config);
+    // Load manager config
+    const managerConfig = loadManagerConfigForFetch();
     for (let i = 0; i < reportIds.length; i++) {
         const reportId = reportIds[i];
         const report = getReportById(reportId);
         console.log(chalk.blue(`\nFetching data for ${report.name} (${i + 1}/${reportIds.length})...`));
         try {
             const outputDir = resolveReportOutputDir(reportId);
-            // Override jira.email with report's email (if Jira is configured)
-            const reportConfig = {
-                ...baseConfig,
-                jira: baseConfig.jira
-                    ? {
-                        ...baseConfig.jira,
-                        email: report.email, // Use report's email, not manager's
-                    }
-                    : undefined,
-            };
+            // Build IC-compatible config from manager config + report
+            const reportConfig = buildReportConfig(managerConfig, report);
             // Determine cache behavior - prompt if data exists and --cache not specified
             let useCache = options.cache;
             if (!options.cache) {

package/dist/cli/commands/init/index.js

@@ -404,7 +404,9 @@ async function initManagerProfile(cliProfileName) {
         process.exit(1);
     }
     console.log(chalk.cyan('\nManager Mode Configuration\n'));
-    // Step 2: GitHub configuration
+    // Step 2: Time range
+    const { since, until } = await promptTimeRange();
+    // Step 3: GitHub configuration
     const githubOrg = await input({
         message: 'GitHub organization:',
         validate: (value) => {
@@ -415,7 +417,7 @@ async function initManagerProfile(cliProfileName) {
         },
     });
     const githubToken = await promptGitHubTokenForManager();
-    // Step 3: Optional JIRA configuration
+    // Step 4: Optional JIRA configuration
     const useJira = await confirm({
         message: 'Configure JIRA?',
         default: false,
@@ -462,16 +464,20 @@ async function initManagerProfile(cliProfileName) {
         tokens.jiraToken = jiraToken;
         tokens.jiraEmail = jiraEmail.trim();
     }
-    // Step 4: Create manager config
+    // Step 5: Create manager config
     const config = {
         mode: 'manager',
         github: {
             org: githubOrg.trim(),
         },
         jira: jiraConfig,
+        fetch: {
+            since,
+            until,
+        },
         reports: [],
     };
-    // Step 5: Create profile directories
+    // Step 6: Create profile directories
     ensureProfileDirs(profileName);
     // Save manager config as YAML
     const configPath = getProfileConfigPath(profileName);
@@ -485,7 +491,7 @@ async function initManagerProfile(cliProfileName) {
     // Set as active profile
     initializeWorkspaceWithProfile(profileName);
     console.log(chalk.green(`\nManager profile '${profileName}' created successfully!`));
-    // Step 6: Add reports?
+    // Step 7: Add reports?
     const addReportsNow = await confirm({
         message: 'Add reports now?',
         default: true,
@@ -516,7 +522,7 @@ async function initManagerProfile(cliProfileName) {
  */
 async function promptGitHubTokenForManager() {
     console.log(chalk.dim('\nCreate a token at: https://github.com/settings/tokens'));
-    console.log(chalk.dim('Required scopes: repo or public_repo\n'));
+    console.log(chalk.dim('Required scopes: repo or public_repo, read:org for orgs\n'));
     return await password({
         message: 'GitHub token:',
         validate: (value) => {

package/dist/cli/commands/init/init.prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.prompts.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init.prompts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5D;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,SAAY,GACtB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAgB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC,CAkED;AAcD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU5D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA8B1D;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CActE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BtE;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,CAiBhC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKxE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU9D;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAqBrD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAavD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B5D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAUzD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAUvD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAKvD"}
+{"version":3,"file":"init.prompts.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init.prompts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5D;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,SAAY,GACtB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAgB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC,CAkED;AAcD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU5D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA8B1D;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CActE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BtE;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,CAiBhC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKxE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU9D;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAqBrD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAavD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B5D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAUzD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAUvD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAKvD"}

package/dist/cli/commands/init/init.prompts.js

@@ -172,7 +172,7 @@ export async function promptRepoDiscoveryMethod(org) {
             {
                 name: 'Auto-discover',
                 value: 'auto',
-                description: 'Find repos where you have PRs (slow for large orgs, may miss old contributions)',
+                description: 'Find repos where you have PRs (requires read:org scope for orgs, slow for large orgs)',
             },
             {
                 name: 'All repos (slowest)',
@@ -357,7 +357,7 @@ export async function promptTokensReady(sources) {
     console.log('Create your tokens at:');
     if (sources.includes('github')) {
         console.log(chalk.dim('  GitHub: https://github.com/settings/tokens'));
-        console.log(chalk.dim('          (Required scopes: repo or public_repo)'));
+        console.log(chalk.dim('          (Required scopes: repo or public_repo, read:org for orgs)'));
     }
     if (sources.includes('jira')) {
         console.log(chalk.dim('  JIRA:   https://id.atlassian.com/manage-profile/security/api-tokens'));

package/dist/cli/commands/init/init.utils.js

@@ -173,7 +173,16 @@ async function checkIfOrganization(graphqlWithAuth, login) {
         });
         return response.organization !== null;
     }
-    catch {
+    catch (error) {
+        // Check if this is an INSUFFICIENT_SCOPES error for read:org
+        if (error && typeof error === 'object' && 'errors' in error) {
+            const errors = error.errors;
+            if (errors?.some((e) => e.type === 'INSUFFICIENT_SCOPES')) {
+                throw new Error(`GitHub token is missing the 'read:org' scope, which is required to query organizations.\n` +
+                    `Please add this scope at: https://github.com/settings/tokens`);
+            }
+        }
+        // For other errors, assume it's a user (not an org)
         return false;
     }
 }

package/dist/core/types/manager.d.ts

@@ -30,6 +30,19 @@ export declare const ReportConfigSchema: z.ZodObject<{
     jiraProjects?: string[] | undefined;
 }>;
 export type ReportConfig = z.infer<typeof ReportConfigSchema>;
+/**
+ * Manager fetch configuration schema
+ */
+export declare const ManagerFetchConfigSchema: z.ZodObject<{
+    since: z.ZodString;
+    until: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    since: string;
+    until: string | null;
+}, {
+    since: string;
+    until?: string | null | undefined;
+}>;
 /**
  * Manager profile configuration schema
  */
@@ -58,6 +71,16 @@ export declare const ManagerConfigSchema: z.ZodObject<{
         host: string;
         token?: string | undefined;
     }>>;
+    fetch: z.ZodObject<{
+        since: z.ZodString;
+        until: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        since: string;
+        until: string | null;
+    }, {
+        since: string;
+        until?: string | null | undefined;
+    }>;
     reports: z.ZodDefault<z.ZodArray<z.ZodObject<{
         /** Display name (e.g., "Alice Smith") */
         name: z.ZodString;
@@ -94,6 +117,10 @@ export declare const ManagerConfigSchema: z.ZodObject<{
         org: string;
         token?: string | undefined;
     };
+    fetch: {
+        since: string;
+        until: string | null;
+    };
     mode: "manager";
     jira?: {
         email: string;
@@ -105,6 +132,10 @@ export declare const ManagerConfigSchema: z.ZodObject<{
         org: string;
         token?: string | undefined;
     };
+    fetch: {
+        since: string;
+        until?: string | null | undefined;
+    };
     mode: "manager";
     reports?: {
         name: string;

package/dist/core/types/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/core/types/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,yCAAyC;;IAEzC,sBAAsB;;IAEtB,wCAAwC;;IAExC,qCAAqC;;IAErC,6BAA6B;;;;;;;;;;;;;;EAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;QAhB9B,yCAAyC;;QAEzC,sBAAsB;;QAEtB,wCAAwC;;QAExC,qCAAqC;;QAErC,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB7B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/core/types/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,yCAAyC;;IAEzC,sBAAsB;;IAEtB,wCAAwC;;IAExC,qCAAqC;;IAErC,6BAA6B;;;;;;;;;;;;;;EAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAxB9B,yCAAyC;;QAEzC,sBAAsB;;QAEtB,wCAAwC;;QAExC,qCAAqC;;QAErC,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B7B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/core/types/manager.js

@@ -17,6 +17,13 @@ export const ReportConfigSchema = z.object({
     /** Jira projects to fetch */
     jiraProjects: z.array(z.string()).default([]),
 });
+/**
+ * Manager fetch configuration schema
+ */
+export const ManagerFetchConfigSchema = z.object({
+    since: z.string(),
+    until: z.string().nullable().default(null),
+});
 /**
  * Manager profile configuration schema
  */
@@ -33,5 +40,6 @@ export const ManagerConfigSchema = z.object({
         token: z.string().optional(), // Token stored in .env, not config
     })
         .optional(),
+    fetch: ManagerFetchConfigSchema,
     reports: z.array(ReportConfigSchema).default([]),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "work-chronicler",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Gather, analyze, and summarize your work history from GitHub PRs and JIRA tickets for performance reviews and resumes",
   "type": "module",
   "main": "dist/cli/index.js",