figmanage 1.0.0 → 1.1.0

package/dist/cli/index.js

@@ -1,5 +1,22 @@
+import { navigateCommand } from './navigate.js';
+import { filesCommand } from './files.js';
+import { projectsCommand } from './projects.js';
+import { permissionsCommand } from './permissions.js';
+import { versionsCommand } from './versions.js';
+import { branchingCommand } from './branching.js';
+import { commentsCommand } from './comments.js';
+import { exportCommand } from './export.js';
+import { readingCommand } from './reading.js';
+import { componentsCommand } from './components.js';
+import { webhooksCommand } from './webhooks.js';
+import { variablesCommand } from './variables.js';
+import { analyticsCommand } from './analytics.js';
+import { orgCommand } from './org.js';
+import { librariesCommand } from './libraries.js';
+import { teamsCommand } from './teams.js';
+import { fileSummaryCommand, workspaceOverviewCommand, openCommentsCommand, cleanupStaleFilesCommand, organizeProjectCommand, setupProjectStructureCommand, seatOptimizationCommand, permissionAuditCommand, branchCleanupCommand, offboardUserCommand, onboardUserCommand, quarterlyReportCommand, } from './compound-commands.js';
 export function registerCliCommands(program) {
-    // Auth commands -- handlers live in cli/login.ts (built by another agent)
+    // Auth commands (flat -- not resource-scoped)
     program
         .command('login')
         .description('Authenticate with Figma')
@@ -23,93 +40,52 @@ export function registerCliCommands(program) {
         const { handleLogout } = await import('./login.js');
         await handleLogout();
     });
-    // Workspace management commands
-    program
-        .command('seat-optimization')
-        .description('Identify inactive paid seats and calculate savings')
-        .option('--days-inactive <days>', 'Days threshold (default: 90)', '90')
-        .option('--no-cost', 'Skip cost analysis')
-        .option('--json', 'Force JSON output')
-        .action(async (options) => {
-        const { runSeatOptimization } = await import('./commands.js');
-        await runSeatOptimization(options);
-    });
-    program
-        .command('offboard <user>')
-        .description('Audit or execute user offboarding')
-        .option('--execute', 'Execute the offboarding (default: audit only)')
-        .option('--transfer-to <user>', 'Transfer file ownership to this user')
-        .option('--json', 'Force JSON output')
-        .action(async (user, options) => {
-        const { runOffboard } = await import('./commands.js');
-        await runOffboard(user, options);
-    });
-    program
-        .command('onboard <email>')
-        .description('Invite user to teams and set up access')
-        .option('--teams <ids>', 'Comma-separated team IDs', (v) => v.split(','))
-        .option('--role <role>', 'Role: editor or viewer (default: editor)', 'editor')
-        .option('--share-files <keys>', 'Comma-separated file keys to share (viewer access)', (v) => v.split(','))
-        .option('--seat <type>', 'Seat type: full, dev, collab, view')
-        .option('--confirm', 'Confirm seat change')
-        .option('--json', 'Force JSON output')
-        .action(async (email, options) => {
-        const { runOnboard } = await import('./commands.js');
-        await runOnboard(email, options);
-    });
-    program
-        .command('quarterly-report')
-        .description('Org-wide design ops snapshot')
-        .option('--days <days>', 'Lookback period (default: 90)', '90')
-        .option('--json', 'Force JSON output')
-        .action(async (options) => {
-        const { runQuarterlyReport } = await import('./commands.js');
-        await runQuarterlyReport(options);
-    });
-    program
-        .command('members')
-        .description('List org members')
-        .option('--search <query>', 'Filter by name or email')
-        .option('--json', 'Force JSON output')
-        .action(async (options) => {
-        const { runMembers } = await import('./commands.js');
-        await runMembers(options);
-    });
-    program
-        .command('teams')
-        .description('List org teams')
-        .option('--json', 'Force JSON output')
-        .action(async (options) => {
-        const { runTeams } = await import('./commands.js');
-        await runTeams(options);
-    });
-    program
-        .command('permissions <type> <id>')
-        .description('Show who has access to a file, project, or team')
-        .option('--json', 'Force JSON output')
-        .action(async (type, id, options) => {
-        const { runPermissions } = await import('./commands.js');
-        await runPermissions(type, id, options);
-    });
-    program
-        .command('permission-audit')
-        .description('Audit permissions across a team or project')
-        .option('--scope <type>', 'Scope: team or project', 'team')
-        .option('--id <id>', 'Team or project ID')
-        .option('--json', 'Force JSON output')
-        .action(async (options) => {
-        const { runPermissionAudit } = await import('./commands.js');
-        await runPermissionAudit(options);
-    });
-    program
-        .command('branch-cleanup <project-id>')
-        .description('Find and optionally archive stale branches')
-        .option('--days-stale <days>', 'Days threshold (default: 60)', '60')
-        .option('--execute', 'Archive stale branches (default: dry run)')
-        .option('--json', 'Force JSON output')
-        .action(async (projectId, options) => {
-        const { runBranchCleanup } = await import('./commands.js');
-        await runBranchCleanup(projectId, options);
-    });
+    // Noun-verb subcommand groups
+    const navigate = navigateCommand();
+    const files = filesCommand();
+    const projects = projectsCommand();
+    const permissions = permissionsCommand();
+    const versions = versionsCommand();
+    const branches = branchingCommand();
+    const comments = commentsCommand();
+    const exp = exportCommand();
+    const reading = readingCommand();
+    const components = componentsCommand();
+    const webhooks = webhooksCommand();
+    const variables = variablesCommand();
+    const analytics = analyticsCommand();
+    const org = orgCommand();
+    const libraries = librariesCommand();
+    const teams = teamsCommand();
+    // Route compound commands into noun groups
+    files.addCommand(fileSummaryCommand());
+    files.addCommand(cleanupStaleFilesCommand());
+    projects.addCommand(organizeProjectCommand());
+    projects.addCommand(setupProjectStructureCommand());
+    comments.addCommand(openCommentsCommand());
+    permissions.addCommand(permissionAuditCommand());
+    branches.addCommand(branchCleanupCommand());
+    org.addCommand(workspaceOverviewCommand());
+    org.addCommand(seatOptimizationCommand());
+    org.addCommand(offboardUserCommand());
+    org.addCommand(onboardUserCommand());
+    org.addCommand(quarterlyReportCommand());
+    // Register all groups
+    program.addCommand(navigate);
+    program.addCommand(files);
+    program.addCommand(projects);
+    program.addCommand(permissions);
+    program.addCommand(versions);
+    program.addCommand(branches);
+    program.addCommand(comments);
+    program.addCommand(exp);
+    program.addCommand(reading);
+    program.addCommand(components);
+    program.addCommand(webhooks);
+    program.addCommand(variables);
+    program.addCommand(analytics);
+    program.addCommand(org);
+    program.addCommand(libraries);
+    program.addCommand(teams);
 }
 //# sourceMappingURL=index.js.map

package/dist/cli/libraries.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function librariesCommand(): Command;
+//# sourceMappingURL=libraries.d.ts.map

package/dist/cli/libraries.js

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import { listOrgLibraries } from '../operations/libraries.js';
+import { output, error } from './format.js';
+import { requireCookie } from './helpers.js';
+export function librariesCommand() {
+    const libraries = new Command('libraries')
+        .description('Manage org design system libraries');
+    libraries
+        .command('list')
+        .description('List all design system libraries in the org')
+        .option('--org-id <id>', 'Org ID override (defaults to current workspace)')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listOrgLibraries(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return libraries;
+}
+//# sourceMappingURL=libraries.js.map

package/dist/cli/navigate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function navigateCommand(): Command;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/cli/navigate.js

@@ -0,0 +1,192 @@
+import { Command } from 'commander';
+import { checkAuthStatus, listOrgs, switchOrg, listTeams, listProjects, listFiles, listRecentFiles, search, getFileInfo, listFavorites, } from '../operations/navigate.js';
+import { output, error } from './format.js';
+import { requireAuth, requireCookie } from './helpers.js';
+export function navigateCommand() {
+    const nav = new Command('navigate')
+        .description('Browse workspaces, teams, projects, and files');
+    nav
+        .command('check-auth')
+        .description('Check authentication status for PAT and session cookie')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireAuth();
+            const result = await checkAuthStatus(config);
+            if (options.json) {
+                output(result.status, options);
+            }
+            else {
+                console.log(result.formatted);
+            }
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('list-orgs')
+        .description('List all workspaces you belong to')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const orgs = await listOrgs(config);
+            if (orgs.length === 0) {
+                console.log('No workspaces found. You may be on a free/starter plan.');
+                return;
+            }
+            output(orgs, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('switch-org <org>')
+        .description('Switch active workspace (name or ID)')
+        .option('--json', 'Force JSON output')
+        .action(async (org, options) => {
+        try {
+            const config = requireCookie();
+            const result = await switchOrg(config, { org });
+            output({
+                previous: result.previous,
+                current: result.current,
+            }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('list-teams')
+        .description('List all teams you belong to')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const teams = await listTeams(config);
+            output(teams, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('list-projects <team-id>')
+        .description('List projects (folders) in a team')
+        .option('--json', 'Force JSON output')
+        .action(async (teamId, options) => {
+        try {
+            const config = requireAuth();
+            const projects = await listProjects(config, { team_id: teamId });
+            output(projects, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('list-files <project-id>')
+        .description('List files in a project')
+        .option('--page-size <n>', 'Results per page (default 25, max 100)')
+        .option('--page-token <token>', 'Pagination token from previous response')
+        .option('--json', 'Force JSON output')
+        .action(async (projectId, options) => {
+        try {
+            const config = requireAuth();
+            const result = await listFiles(config, {
+                project_id: projectId,
+                page_size: options.pageSize ? parseInt(options.pageSize, 10) : undefined,
+                page_token: options.pageToken,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('list-recent-files')
+        .description('List recently viewed/edited files')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const files = await listRecentFiles(config);
+            output(files, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('search <query>')
+        .description('Search for files across the workspace')
+        .option('--sort <order>', 'Sort order: relevancy or last_modified')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (query, options) => {
+        try {
+            const config = requireCookie();
+            const results = await search(config, {
+                query,
+                sort: options.sort,
+                org_id: options.orgId,
+            });
+            if (results.length === 0) {
+                console.log('No results found.');
+                return;
+            }
+            output(results, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('file-info <file-key>')
+        .description('Get metadata for a file')
+        .option('--json', 'Force JSON output')
+        .action(async (fileKey, options) => {
+        try {
+            const config = requireAuth();
+            const info = await getFileInfo(config, { file_key: fileKey });
+            output(info, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    nav
+        .command('list-favorites')
+        .description('List starred/favorited files')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const favorites = await listFavorites(config);
+            if (favorites.length === 0) {
+                console.log('No favorites found.');
+                return;
+            }
+            output(favorites, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return nav;
+}
+//# sourceMappingURL=navigate.js.map

package/dist/cli/org.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function orgCommand(): Command;
+//# sourceMappingURL=org.d.ts.map

package/dist/cli/org.js

@@ -0,0 +1,227 @@
+import { Command } from 'commander';
+import { listAdmins, listOrgTeams, seatUsage, listTeamMembers, billingOverview, listInvoices, orgDomains, aiCreditUsage, exportMembers, listOrgMembers, contractRates, changeSeat, } from '../operations/org.js';
+import { output, error } from './format.js';
+import { requireCookie } from './helpers.js';
+export function orgCommand() {
+    const org = new Command('org')
+        .description('Org administration and billing');
+    org
+        .command('list-admins')
+        .description('List org admins with permission levels and seat status')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--include-license-admins', 'Include license admins')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listAdmins(config, {
+                org_id: options.orgId,
+                include_license_admins: options.includeLicenseAdmins,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('list-teams')
+        .description('List all teams in the org')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--include-secret-teams', 'Include secret teams')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listOrgTeams(config, {
+                org_id: options.orgId,
+                include_secret_teams: options.includeSecretTeams,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('seat-usage')
+        .description('Seat usage breakdown by type and activity')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--search <query>', 'Filter counts by user search query')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await seatUsage(config, {
+                org_id: options.orgId,
+                search_query: options.search,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('team-members <team-id>')
+        .description('List members of a team')
+        .option('--json', 'Force JSON output')
+        .action(async (teamId, options) => {
+        try {
+            const config = requireCookie();
+            const result = await listTeamMembers(config, { team_id: teamId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('billing')
+        .description('Org billing data including invoice history and amounts')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await billingOverview(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('invoices')
+        .description('List open and upcoming invoices')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listInvoices(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('domains')
+        .description('Org domain configuration and SSO/SAML settings')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await orgDomains(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('ai-credits <plan-id>')
+        .description('AI credit usage summary for a billing plan')
+        .option('--json', 'Force JSON output')
+        .action(async (planId, options) => {
+        try {
+            const config = requireCookie();
+            const result = await aiCreditUsage(config, { plan_id: planId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('export-members')
+        .description('Trigger async CSV export of all org members')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const msg = await exportMembers(config, { org_id: options.orgId });
+            output({ message: msg }, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('members')
+        .description('List org members with seat type, permission, and activity')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--search <query>', 'Filter members by name or email')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await listOrgMembers(config, {
+                org_id: options.orgId,
+                search_query: options.search,
+            });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('contract-rates')
+        .description('Seat pricing per type (expert, developer, collaborator)')
+        .option('--org-id <id>', 'Org ID override')
+        .option('--json', 'Force JSON output')
+        .action(async (options) => {
+        try {
+            const config = requireCookie();
+            const result = await contractRates(config, { org_id: options.orgId });
+            output(result, options);
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    org
+        .command('change-seat <user-id> <seat-type>')
+        .description("Change a user's seat type (full, dev, collab, view)")
+        .option('--org-id <id>', 'Org ID override')
+        .option('--confirm', 'Authorize billing change for upgrades')
+        .option('--json', 'Force JSON output')
+        .action(async (userId, seatType, options) => {
+        try {
+            const config = requireCookie();
+            const result = await changeSeat(config, {
+                user_id: userId,
+                seat_type: seatType,
+                org_id: options.orgId,
+                confirm: options.confirm,
+            });
+            if (typeof result === 'string') {
+                output({ message: result }, options);
+            }
+            else {
+                output(result, options);
+            }
+        }
+        catch (e) {
+            error(e.response?.status ? `API error: ${e.response.status}` : e.message);
+            process.exit(1);
+        }
+    });
+    return org;
+}
+//# sourceMappingURL=org.js.map

package/dist/cli/permissions.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function permissionsCommand(): Command;
+//# sourceMappingURL=permissions.d.ts.map