@ginkoai/cli 2.0.0-beta.2 → 2.0.0-beta.4

package/dist/commands/invite/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [invite, team, collaboration, epic-008]
+ * @related: [../join/index.ts, ../team/index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora]
+ */
+/**
+ * Invite Command (EPIC-008 Sprint 1)
+ *
+ * CLI command for team owners/admins to invite members via email
+ */
+import { Command } from 'commander';
+/**
+ * Main invite command with subcommands
+ */
+export declare function inviteCommand(): Command;
+export default inviteCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/invite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/invite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8LpC;;GAEG;AACH,wBAAgB,aAAa,YA2C5B;AAED,eAAe,aAAa,CAAC"}

package/dist/commands/invite/index.js

@@ -0,0 +1,192 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [invite, team, collaboration, epic-008]
+ * @related: [../join/index.ts, ../team/index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora]
+ */
+/**
+ * Invite Command (EPIC-008 Sprint 1)
+ *
+ * CLI command for team owners/admins to invite members via email
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import { api } from '../../utils/api-client.js';
+/**
+ * Send invitation to join a team
+ */
+async function sendInvite(email, options) {
+    const spinner = ora('Sending invitation...').start();
+    try {
+        // Get team ID - if not provided, use current project's default team
+        let teamId = options.team;
+        if (!teamId) {
+            // Try to get team from current project context
+            const teamsResponse = await api.get('/api/v1/teams?limit=1');
+            if (teamsResponse.error || !teamsResponse.data?.teams?.length) {
+                spinner.fail(chalk.red('No team specified and no default team found'));
+                console.log('');
+                console.log(chalk.dim('Usage: ginko invite <email> --team <team-id>'));
+                console.log(chalk.dim('       ginko teams list   # to see available teams'));
+                process.exit(1);
+            }
+            teamId = teamsResponse.data.teams[0].id;
+        }
+        const response = await api.post('/api/v1/team/invite', {
+            team_id: teamId,
+            email: email.toLowerCase(),
+            role: options.role || 'member',
+        });
+        if (response.error) {
+            spinner.fail(chalk.red('Failed to send invitation'));
+            console.error(chalk.red(`  ${response.error}`));
+            process.exit(1);
+        }
+        const invitation = response.data.invitation;
+        spinner.succeed(chalk.green('Invitation sent'));
+        console.log('');
+        console.log(chalk.bold(`  Invited: ${invitation.email}`));
+        console.log(chalk.dim(`  Team: ${invitation.team_name}`));
+        console.log(chalk.dim(`  Role: ${invitation.role}`));
+        console.log(chalk.dim(`  Expires: ${new Date(invitation.expires_at).toLocaleDateString()}`));
+        console.log('');
+        console.log(chalk.cyan(`  Invite code: ${invitation.code}`));
+        console.log('');
+        console.log(chalk.dim('Share this code with the invitee to join:'));
+        console.log(chalk.green(`  ginko join ${invitation.code}`));
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to send invitation'));
+        console.error(chalk.red(`  ${error.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * List pending invitations for a team
+ */
+async function listInvites(options) {
+    const spinner = ora('Loading invitations...').start();
+    try {
+        let teamId = options.team;
+        if (!teamId) {
+            // Get first team
+            const teamsResponse = await api.get('/api/v1/teams?limit=1');
+            if (teamsResponse.error || !teamsResponse.data?.teams?.length) {
+                spinner.fail(chalk.red('No team specified and no default team found'));
+                process.exit(1);
+            }
+            teamId = teamsResponse.data.teams[0].id;
+        }
+        const response = await api.get(`/api/v1/team/invite?team_id=${teamId}`);
+        if (response.error) {
+            spinner.fail(chalk.red('Failed to load invitations'));
+            console.error(chalk.red(`  ${response.error}`));
+            process.exit(1);
+        }
+        const invitations = response.data.invitations;
+        if (invitations.length === 0) {
+            spinner.succeed(chalk.yellow('No pending invitations'));
+            return;
+        }
+        spinner.succeed(chalk.green(`Found ${invitations.length} pending invitation(s)`));
+        console.log('');
+        const table = new Table({
+            head: [
+                chalk.cyan('Email'),
+                chalk.cyan('Role'),
+                chalk.cyan('Code'),
+                chalk.cyan('Expires'),
+            ],
+            colWidths: [30, 10, 15, 15],
+            wordWrap: true,
+        });
+        invitations.forEach((inv) => {
+            table.push([
+                inv.email,
+                inv.role,
+                inv.code,
+                new Date(inv.expires_at).toLocaleDateString(),
+            ]);
+        });
+        console.log(table.toString());
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to load invitations'));
+        console.error(chalk.red(`  ${error.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Revoke a pending invitation
+ */
+async function revokeInvite(code) {
+    const spinner = ora('Revoking invitation...').start();
+    try {
+        const response = await api.delete('/api/v1/team/invite', { code });
+        if (response.error) {
+            spinner.fail(chalk.red('Failed to revoke invitation'));
+            console.error(chalk.red(`  ${response.error}`));
+            process.exit(1);
+        }
+        spinner.succeed(chalk.green('Invitation revoked'));
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to revoke invitation'));
+        console.error(chalk.red(`  ${error.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Main invite command with subcommands
+ */
+export function inviteCommand() {
+    const invite = new Command('invite')
+        .description('Invite collaborators to join your team')
+        .showHelpAfterError('(use --help for additional information)')
+        .addHelpText('after', `
+${chalk.gray('Quick Start:')}
+  ${chalk.green('ginko invite')} user@example.com              ${chalk.gray('# Invite as member')}
+  ${chalk.green('ginko invite')} user@example.com --role owner ${chalk.gray('# Invite as owner')}
+
+${chalk.gray('Management:')}
+  ${chalk.green('ginko invite --list')}                        ${chalk.gray('# List pending invitations')}
+  ${chalk.green('ginko invite --revoke')} <code>               ${chalk.gray('# Cancel invitation')}
+
+${chalk.gray('Options:')}
+  --team <id>     ${chalk.dim('Team to invite to (defaults to your first team)')}
+  --role <role>   ${chalk.dim('Role to assign: owner, admin, member (default: member)')}
+
+${chalk.gray('Workflow:')}
+  1. ${chalk.green('ginko invite')} collaborator@example.com
+  2. Share the invite code with them
+  3. They run: ${chalk.green('ginko join')} <code>
+`)
+        .argument('[email]', 'Email address to invite')
+        .option('-t, --team <id>', 'Team ID to invite to')
+        .option('-r, --role <role>', 'Role to assign (owner|admin|member)', 'member')
+        .option('-l, --list', 'List pending invitations')
+        .option('--revoke <code>', 'Revoke an invitation by code')
+        .action(async (email, options) => {
+        if (options.list) {
+            await listInvites({ team: options.team });
+        }
+        else if (options.revoke) {
+            await revokeInvite(options.revoke);
+        }
+        else if (email) {
+            await sendInvite(email, { team: options.team, role: options.role });
+        }
+        else {
+            invite.help({ error: false });
+        }
+    });
+    return invite;
+}
+export default inviteCommand;
+//# sourceMappingURL=index.js.map

package/dist/commands/invite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/invite/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/join/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [join, team, collaboration, epic-008]
+ * @related: [../invite/index.ts, ../team/index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora, prompts]
+ */
+/**
+ * Join Command (EPIC-008 Sprint 1)
+ *
+ * CLI command for users to join a team via invitation code
+ */
+import { Command } from 'commander';
+/**
+ * Main join command
+ */
+export declare function joinCommand(): Command;
+export default joinCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/join/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/join/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgLpC;;GAEG;AACH,wBAAgB,WAAW,YAqC1B;AAED,eAAe,WAAW,CAAC"}

package/dist/commands/join/index.js

@@ -0,0 +1,177 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-03
+ * @tags: [join, team, collaboration, epic-008]
+ * @related: [../invite/index.ts, ../team/index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora, prompts]
+ */
+/**
+ * Join Command (EPIC-008 Sprint 1)
+ *
+ * CLI command for users to join a team via invitation code
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { api } from '../../utils/api-client.js';
+/**
+ * Validate and preview invitation
+ */
+async function previewInvitation(code) {
+    const spinner = ora('Validating invitation code...').start();
+    try {
+        const response = await api.get(`/api/v1/team/join?code=${code}`);
+        if (response.error) {
+            spinner.fail(chalk.red('Invalid invitation code'));
+            console.error(chalk.red(`  ${response.error}`));
+            return null;
+        }
+        spinner.succeed(chalk.green('Invitation valid'));
+        return response.data;
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to validate invitation'));
+        console.error(chalk.red(`  ${error.message}`));
+        return null;
+    }
+}
+/**
+ * Accept invitation and join team
+ */
+async function acceptInvitation(code) {
+    const spinner = ora('Joining team...').start();
+    try {
+        const response = await api.post('/api/v1/team/join', { code });
+        if (response.error) {
+            spinner.fail(chalk.red('Failed to join team'));
+            console.error(chalk.red(`  ${response.error}`));
+            process.exit(1);
+        }
+        const result = response.data;
+        spinner.succeed(chalk.green(result.message));
+        console.log('');
+        console.log(chalk.bold(`  Team: ${result.membership.team_name}`));
+        console.log(chalk.dim(`  Role: ${result.membership.role}`));
+        console.log(chalk.dim(`  Joined: ${new Date(result.membership.joined_at).toLocaleString()}`));
+        if (!result.email_matched) {
+            console.log('');
+            console.log(chalk.yellow('  Note: Invitation was sent to a different email.'));
+        }
+        console.log('');
+        console.log(chalk.dim('Next steps:'));
+        console.log(chalk.green(`  ginko sync                 ${chalk.dim('# Pull team context')}`));
+        console.log(chalk.green(`  ginko teams list-members   ${chalk.dim('# See your teammates')}`));
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to join team'));
+        console.error(chalk.red(`  ${error.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Interactive join flow (prompts for code)
+ */
+async function interactiveJoin() {
+    console.log('');
+    console.log(chalk.cyan('Join a Team'));
+    console.log(chalk.dim('Enter the invitation code you received'));
+    console.log('');
+    const response = await prompts({
+        type: 'text',
+        name: 'code',
+        message: 'Invitation code:',
+        validate: (value) => value.length >= 8 || 'Code should be at least 8 characters',
+    });
+    if (!response.code) {
+        console.log(chalk.yellow('Cancelled'));
+        return;
+    }
+    await joinTeam(response.code);
+}
+/**
+ * Main join flow
+ */
+async function joinTeam(code) {
+    // First validate and preview
+    const preview = await previewInvitation(code);
+    if (!preview) {
+        process.exit(1);
+    }
+    // Check if already a member
+    if (preview.already_member) {
+        console.log('');
+        console.log(chalk.yellow(`You are already a member of "${preview.team.name}"`));
+        console.log(chalk.dim(`  Current role: ${preview.current_role}`));
+        process.exit(0);
+    }
+    // Show preview
+    console.log('');
+    console.log(chalk.bold('Invitation Details:'));
+    console.log(`  Team: ${chalk.cyan(preview.team.name)}`);
+    console.log(`  Role: ${chalk.cyan(preview.invitation.role)}`);
+    console.log(`  Expires: ${new Date(preview.invitation.expires_at).toLocaleDateString()}`);
+    if (!preview.invitation.is_for_current_user) {
+        console.log('');
+        console.log(chalk.yellow(`  Note: This invitation was sent to ${preview.invitation.email}`));
+        console.log(chalk.dim('  You can still accept it with your current account.'));
+    }
+    console.log('');
+    // Confirm
+    const confirm = await prompts({
+        type: 'confirm',
+        name: 'accept',
+        message: `Join team "${preview.team.name}" as ${preview.invitation.role}?`,
+        initial: true,
+    });
+    if (!confirm.accept) {
+        console.log(chalk.yellow('Cancelled'));
+        return;
+    }
+    // Accept
+    await acceptInvitation(code);
+}
+/**
+ * Main join command
+ */
+export function joinCommand() {
+    const join = new Command('join')
+        .description('Join a team using an invitation code')
+        .showHelpAfterError('(use --help for additional information)')
+        .addHelpText('after', `
+${chalk.gray('Usage:')}
+  ${chalk.green('ginko join')} <invite-code>    ${chalk.gray('# Join via invitation code')}
+  ${chalk.green('ginko join')}                  ${chalk.gray('# Interactive: prompts for code')}
+
+${chalk.gray('Workflow:')}
+  1. Receive invitation code from a team owner
+  2. Run: ${chalk.green('ginko join')} <code>
+  3. Confirm to accept invitation
+  4. Run: ${chalk.green('ginko sync')} to pull team context
+
+${chalk.gray('Example:')}
+  ${chalk.green('ginko join')} a1b2c3d4e5f6
+`)
+        .argument('[code]', 'Invitation code')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .action(async (code, options) => {
+        if (code) {
+            if (options.yes) {
+                // Skip preview confirmation
+                await acceptInvitation(code);
+            }
+            else {
+                await joinTeam(code);
+            }
+        }
+        else {
+            await interactiveJoin();
+        }
+    });
+    return join;
+}
+export default joinCommand;
+//# sourceMappingURL=index.js.map

package/dist/commands/join/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/join/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/sync/index.d.ts

@@ -17,5 +17,6 @@ import { Command } from 'commander';
 export declare function createSyncCommand(): Command;
 export { syncCommand } from './sync-command.js';
 export { findSprintFiles, syncSprintFile } from './sprint-syncer.js';
-export type { SyncOptions, SyncResult, UnsyncedNode, SprintSyncResult } from './types.js';
+export { getTeamSyncStatus, updateLastSyncTimestamp, displayStalenessWarning, } from './team-sync.js';
+export type { SyncOptions, SyncResult, UnsyncedNode, SprintSyncResult, TeamSyncOptions, TeamSyncStatus, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,iBAAiB,IAAI,OAAO,CAoB3C;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwB3C;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/commands/sync/index.js

@@ -21,13 +21,17 @@ export function createSyncCommand() {
         .option('--dry-run', 'Preview changes without applying')
         .option('--force', 'Overwrite local files with graph versions')
         .option('--type <type>', 'Sync only specific node type (ADR, PRD, Pattern, Gotcha, Charter, Sprint)')
-        .option('--no-commit', 'Sync files but do not commit');
+        .option('--no-commit', 'Sync files but do not commit')
+        .option('--staleness-days <days>', 'Days threshold for staleness warning (default: 3)', '3')
+        .option('--skip-team-check', 'Skip team membership verification');
     sync.action(async (options) => {
         const syncOptions = {
             dryRun: options.dryRun === true,
             force: options.force === true,
             type: options.type,
             interactive: true,
+            stalenessThresholdDays: parseInt(options.stalenessDays, 10) || 3,
+            skipMembershipCheck: options.skipTeamCheck === true,
         };
         await syncCommand(syncOptions);
     });
@@ -35,4 +39,5 @@ export function createSyncCommand() {
 }
 export { syncCommand } from './sync-command.js';
 export { findSprintFiles, syncSprintFile } from './sprint-syncer.js';
+export { getTeamSyncStatus, updateLastSyncTimestamp, displayStalenessWarning, } from './team-sync.js';
 //# sourceMappingURL=index.js.map

package/dist/commands/sync/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SAC7B,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,2CAA2C,CAAC;SAC9D,MAAM,CAAC,eAAe,EAAE,2EAA2E,CAAC;SACpG,MAAM,CAAC,aAAa,EAAE,8BAA8B,CAAC,CAAC;IAEzD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;QACrD,MAAM,WAAW,GAAgB;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;YAC7B,IAAI,EAAE,OAAO,CAAC,IAA4B;YAC1C,WAAW,EAAE,IAAI;SAClB,CAAC;QAEF,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SAC7B,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,2CAA2C,CAAC;SAC9D,MAAM,CAAC,eAAe,EAAE,2EAA2E,CAAC;SACpG,MAAM,CAAC,aAAa,EAAE,8BAA8B,CAAC;SACrD,MAAM,CAAC,yBAAyB,EAAE,mDAAmD,EAAE,GAAG,CAAC;SAC3F,MAAM,CAAC,mBAAmB,EAAE,mCAAmC,CAAC,CAAC;IAEpE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;QACrD,MAAM,WAAW,GAAoB;YACnC,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;YAC7B,IAAI,EAAE,OAAO,CAAC,IAA4B;YAC1C,WAAW,EAAE,IAAI;YACjB,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAuB,EAAE,EAAE,CAAC,IAAI,CAAC;YAC1E,mBAAmB,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI;SACpD,CAAC;QAEF,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/commands/sync/sync-command.d.ts

@@ -8,9 +8,9 @@
  * @complexity: high
  * @dependencies: [chalk, prompts, simple-git]
  */
-import type { SyncOptions, SyncResult } from './types.js';
+import type { SyncResult, TeamSyncOptions } from './types.js';
 /**
  * Main sync command implementation
  */
-export declare function syncCommand(options: SyncOptions): Promise<SyncResult>;
+export declare function syncCommand(options: TeamSyncOptions): Promise<SyncResult>;
 //# sourceMappingURL=sync-command.d.ts.map

package/dist/commands/sync/sync-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-command.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/sync-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6BH,OAAO,KAAK,EACV,WAAW,EAEX,UAAU,EAKX,MAAM,YAAY,CAAC;AA8PpB;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsN3E"}
+{"version":3,"file":"sync-command.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/sync-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmCH,OAAO,KAAK,EAGV,UAAU,EAKV,eAAe,EAChB,MAAM,YAAY,CAAC;AA8PpB;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAwP/E"}

package/dist/commands/sync/sync-command.js

@@ -24,6 +24,7 @@ import prompts from 'prompts';
 import { getConfig, getApiToken } from '../graph/config.js';
 import { syncNode, getFilePath, computeHash, readFileContent, applyResolution, } from './node-syncer.js';
 import { findSprintFiles, syncSprintFile, updateCurrentSprintFile, } from './sprint-syncer.js';
+import { getTeamSyncStatus, updateLastSyncTimestamp, displayStalenessWarning, displayTeamInfo, } from './team-sync.js';
 const API_BASE = process.env.GINKO_API_URL || 'https://app.ginkoai.com';
 /**
  * Transform raw API node to UnsyncedNode
@@ -236,6 +237,20 @@ export async function syncCommand(options) {
         console.error(chalk.dim('   Run `ginko login` to authenticate.'));
         return result;
     }
+    // Check team membership and staleness (EPIC-008)
+    const stalenessThreshold = options.stalenessThresholdDays ?? 3;
+    let teamStatus = null;
+    if (!options.skipMembershipCheck) {
+        teamStatus = await getTeamSyncStatus(graphId, token, stalenessThreshold);
+        // Display team info if member
+        if (teamStatus.isMember) {
+            displayTeamInfo(teamStatus);
+        }
+        // Show staleness warning if applicable
+        if (teamStatus.isMember && teamStatus.staleness.isStale) {
+            displayStalenessWarning(teamStatus);
+        }
+    }
     // Get git root directory (not cwd, which might be a subdirectory)
     let projectRoot = process.cwd();
     try {
@@ -264,8 +279,15 @@ export async function syncCommand(options) {
                 console.log(chalk.green(`\n✓ Synced ${updatedSprints.length} sprint(s) and committed to git.`));
             }
         }
-        // Summary
+        // Update team sync timestamp if we synced anything (EPIC-008)
         const totalUpdated = sprintResults.reduce((sum, r) => sum + r.tasksUpdated, 0);
+        if (totalUpdated > 0 && teamStatus?.isMember) {
+            const updated = await updateLastSyncTimestamp(graphId, token);
+            if (updated) {
+                console.log(chalk.dim('✓ Team sync timestamp updated'));
+            }
+        }
+        // Summary
         console.log(chalk.bold('\n📊 Summary:'));
         console.log(`  Sprints processed: ${sprintResults.length}`);
         console.log(`  Tasks updated: ${totalUpdated}`);
@@ -395,6 +417,13 @@ export async function syncCommand(options) {
             console.log(chalk.dim('   You can commit manually with: git add . && git commit'));
         }
     }
+    // Update team sync timestamp if we synced anything (EPIC-008)
+    if (result.synced.length > 0 && teamStatus?.isMember) {
+        const updated = await updateLastSyncTimestamp(graphId, token);
+        if (updated) {
+            console.log(chalk.dim('✓ Team sync timestamp updated'));
+        }
+    }
     // Summary
     console.log(chalk.bold('\n📊 Summary:'));
     console.log(`  Synced: ${result.synced.length}`);