@n8n-as-code/sync 0.6.0 → 0.8.0

package/dist/helpers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Helper utilities for workflow and project management
+ *
+ * This module exports reusable helper functions that can be used
+ * across different interfaces (CLI, VS Code extension, etc.)
+ */
+export { getDisplayProjectName, getWorkflowProjectName, getProjectDisplayName, groupWorkflowsByProject, sortWorkflowsInGroups, buildProjectGroups, formatWorkflowNameWithBadges, type IProjectGroup } from './project-helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,aAAa,EACrB,MAAM,sBAAsB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,8 @@
+/**
+ * Helper utilities for workflow and project management
+ *
+ * This module exports reusable helper functions that can be used
+ * across different interfaces (CLI, VS Code extension, etc.)
+ */
+export { getDisplayProjectName, getWorkflowProjectName, getProjectDisplayName, groupWorkflowsByProject, sortWorkflowsInGroups, buildProjectGroups, formatWorkflowNameWithBadges } from './project-helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,EAE/B,MAAM,sBAAsB,CAAC"}

package/dist/helpers/project-helpers.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Project-related helper functions for workflow organization
+ *
+ * These helpers provide reusable utilities for working with projects
+ * across different interfaces (CLI, VS Code extension, etc.)
+ */
+import { IProject, IWorkflow } from '../types.js';
+/**
+ * Gets a user-friendly display name for a project.
+ *
+ * Personal projects (type === 'personal') are displayed as "Personal"
+ * regardless of their actual name (which often includes user email).
+ *
+ * @param project The project to get a display name for
+ * @returns A user-friendly display name
+ */
+export declare function getDisplayProjectName(project: IProject): string;
+/**
+ * Gets a user-friendly display name for a workflow's project.
+ *
+ * If the workflow has no project assignment, returns the fallback.
+ *
+ * @param workflow The workflow to get a project name for
+ * @param fallback The name to use if the workflow has no project (default: "Personal")
+ * @returns A user-friendly display name
+ */
+export declare function getWorkflowProjectName(workflow: IWorkflow, fallback?: string): string;
+/**
+ * Gets a display name for a project from an object with project metadata.
+ * Works with IWorkflow, IWorkflowStatus, or any object with projectName and homeProject.
+ *
+ * @param obj Object containing project metadata
+ * @param fallback The name to use if no project (default: "Personal")
+ * @returns A user-friendly display name
+ */
+export declare function getProjectDisplayName(obj: {
+    projectName?: string;
+    homeProject?: IProject;
+}, fallback?: string): string;
+/**
+ * Groups workflows by their project assignment.
+ *
+ * @param workflows Array of workflows to group
+ * @returns Map of projectId -> workflows array
+ */
+export declare function groupWorkflowsByProject(workflows: IWorkflow[]): Map<string, IWorkflow[]>;
+/**
+ * Sorts workflows within each project group.
+ *
+ * Default sort order: active workflows first, then by name alphabetically.
+ *
+ * @param groups Map of projectId -> workflows to sort in-place
+ * @param compareFn Optional custom comparison function
+ */
+export declare function sortWorkflowsInGroups(groups: Map<string, IWorkflow[]>, compareFn?: (a: IWorkflow, b: IWorkflow) => number): void;
+/**
+ * Interface for a project with its workflows
+ */
+export interface IProjectGroup {
+    id: string;
+    name: string;
+    displayName: string;
+    project: IProject | null;
+    workflows: IWorkflow[];
+}
+/**
+ * Converts grouped workflows into structured project groups with metadata.
+ *
+ * @param groupedWorkflows Map of projectId -> workflows
+ * @param sortProjects Whether to sort projects (no-project last)
+ * @returns Array of project groups with display information
+ */
+export declare function buildProjectGroups(groupedWorkflows: Map<string, IWorkflow[]>, sortProjects?: boolean): IProjectGroup[];
+/**
+ * Format workflow name with project and archived badges
+ *
+ * @param workflow The workflow object (must have name, projectName/homeProject, isArchived)
+ * @param options Optional formatting options
+ * @returns Workflow name with badges
+ */
+export declare function formatWorkflowNameWithBadges(workflow: {
+    name: string;
+    projectName?: string;
+    homeProject?: IProject;
+    isArchived?: boolean;
+}, options?: {
+    showProjectBadge?: boolean;
+    showArchivedBadge?: boolean;
+    maxLength?: number;
+    projectBadgeStyle?: (text: string) => string;
+    archivedBadgeStyle?: (text: string) => string;
+}): string;
+//# sourceMappingURL=project-helpers.d.ts.map

package/dist/helpers/project-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-helpers.d.ts","sourceRoot":"","sources":["../../src/helpers/project-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAAE,MAAmB,GAAG,MAAM,CAKjG;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,GAAG,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,QAAQ,CAAA;CAAE,EACrD,QAAQ,GAAE,MAAmB,GAC9B,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAexF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAChC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,KAAK,MAAM,GACnD,IAAI,CAcN;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAC1C,YAAY,GAAE,OAAc,GAC7B,aAAa,EAAE,CAqCjB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CACxC,QAAQ,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAA;CACvB,EACD,OAAO,CAAC,EAAE;IACN,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD,GACF,MAAM,CAoCR"}

package/dist/helpers/project-helpers.js

@@ -0,0 +1,168 @@
+/**
+ * Project-related helper functions for workflow organization
+ *
+ * These helpers provide reusable utilities for working with projects
+ * across different interfaces (CLI, VS Code extension, etc.)
+ */
+/**
+ * Gets a user-friendly display name for a project.
+ *
+ * Personal projects (type === 'personal') are displayed as "Personal"
+ * regardless of their actual name (which often includes user email).
+ *
+ * @param project The project to get a display name for
+ * @returns A user-friendly display name
+ */
+export function getDisplayProjectName(project) {
+    return project.type === 'personal' ? 'Personal' : project.name;
+}
+/**
+ * Gets a user-friendly display name for a workflow's project.
+ *
+ * If the workflow has no project assignment, returns the fallback.
+ *
+ * @param workflow The workflow to get a project name for
+ * @param fallback The name to use if the workflow has no project (default: "Personal")
+ * @returns A user-friendly display name
+ */
+export function getWorkflowProjectName(workflow, fallback = 'Personal') {
+    if (!workflow.homeProject) {
+        return fallback;
+    }
+    return getDisplayProjectName(workflow.homeProject);
+}
+/**
+ * Gets a display name for a project from an object with project metadata.
+ * Works with IWorkflow, IWorkflowStatus, or any object with projectName and homeProject.
+ *
+ * @param obj Object containing project metadata
+ * @param fallback The name to use if no project (default: "Personal")
+ * @returns A user-friendly display name
+ */
+export function getProjectDisplayName(obj, fallback = 'Personal') {
+    if (obj.homeProject) {
+        return getDisplayProjectName(obj.homeProject);
+    }
+    return obj.projectName || fallback;
+}
+/**
+ * Groups workflows by their project assignment.
+ *
+ * @param workflows Array of workflows to group
+ * @returns Map of projectId -> workflows array
+ */
+export function groupWorkflowsByProject(workflows) {
+    const NO_PROJECT_KEY = '__NO_PROJECT__';
+    const groups = new Map();
+    for (const workflow of workflows) {
+        const projectId = workflow.projectId || NO_PROJECT_KEY;
+        if (!groups.has(projectId)) {
+            groups.set(projectId, []);
+        }
+        groups.get(projectId).push(workflow);
+    }
+    return groups;
+}
+/**
+ * Sorts workflows within each project group.
+ *
+ * Default sort order: active workflows first, then by name alphabetically.
+ *
+ * @param groups Map of projectId -> workflows to sort in-place
+ * @param compareFn Optional custom comparison function
+ */
+export function sortWorkflowsInGroups(groups, compareFn) {
+    const defaultCompare = (a, b) => {
+        // Active workflows first
+        if (a.active && !b.active)
+            return -1;
+        if (!a.active && b.active)
+            return 1;
+        // Then by name
+        return a.name.localeCompare(b.name);
+    };
+    const compare = compareFn || defaultCompare;
+    for (const [, workflows] of groups) {
+        workflows.sort(compare);
+    }
+}
+/**
+ * Converts grouped workflows into structured project groups with metadata.
+ *
+ * @param groupedWorkflows Map of projectId -> workflows
+ * @param sortProjects Whether to sort projects (no-project last)
+ * @returns Array of project groups with display information
+ */
+export function buildProjectGroups(groupedWorkflows, sortProjects = true) {
+    const NO_PROJECT_KEY = '__NO_PROJECT__';
+    const groups = [];
+    for (const [projectId, workflows] of groupedWorkflows) {
+        const isNoProject = projectId === NO_PROJECT_KEY;
+        const firstWorkflow = workflows[0];
+        const project = firstWorkflow?.homeProject || null;
+        const name = isNoProject
+            ? 'Personal'
+            : project?.name || 'Unknown Project';
+        const displayName = project
+            ? getDisplayProjectName(project)
+            : 'Personal';
+        groups.push({
+            id: projectId,
+            name,
+            displayName,
+            project,
+            workflows
+        });
+    }
+    if (sortProjects) {
+        groups.sort((a, b) => {
+            // No-project (Personal) last
+            if (a.id === NO_PROJECT_KEY)
+                return 1;
+            if (b.id === NO_PROJECT_KEY)
+                return -1;
+            // Others alphabetically by display name
+            return a.displayName.localeCompare(b.displayName);
+        });
+    }
+    return groups;
+}
+/**
+ * Format workflow name with project and archived badges
+ *
+ * @param workflow The workflow object (must have name, projectName/homeProject, isArchived)
+ * @param options Optional formatting options
+ * @returns Workflow name with badges
+ */
+export function formatWorkflowNameWithBadges(workflow, options) {
+    const opts = {
+        showProjectBadge: true,
+        showArchivedBadge: true,
+        projectBadgeStyle: (text) => text,
+        archivedBadgeStyle: (text) => text,
+        ...options
+    };
+    let name = workflow.name;
+    const badges = [];
+    // Add project badge (only if not Personal)
+    if (opts.showProjectBadge) {
+        const projectName = getProjectDisplayName(workflow, '');
+        if (projectName && projectName !== 'Personal' && projectName !== '-') {
+            badges.push(opts.projectBadgeStyle(`[${projectName}]`));
+        }
+    }
+    // Add archived badge
+    if (opts.showArchivedBadge && workflow.isArchived) {
+        badges.push(opts.archivedBadgeStyle('[archived]'));
+    }
+    // Truncate name if needed (before adding badges)
+    if (opts.maxLength && name.length > opts.maxLength) {
+        name = name.substring(0, opts.maxLength - 3) + '...';
+    }
+    // Combine name and badges
+    if (badges.length > 0) {
+        return `${name} ${badges.join(' ')}`;
+    }
+    return name;
+}
+//# sourceMappingURL=project-helpers.js.map

package/dist/helpers/project-helpers.js.map

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

package/dist/index.d.ts

@@ -7,4 +7,5 @@ export * from './services/watcher.js';
 export * from './services/resolution-manager.js';
 export * from './services/state-manager.js';
 export * from './services/directory-utils.js';
+export * from './helpers/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -7,4 +7,5 @@ export * from './services/watcher.js';
 export * from './services/resolution-manager.js';
 export * from './services/state-manager.js';
 export * from './services/directory-utils.js';
+export * from './helpers/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC"}

package/dist/services/directory-utils.d.ts

@@ -32,4 +32,10 @@ export declare function createInstanceIdentifier(host: string, user?: {
  * @returns Fallback instance identifier (e.g., "local_5678_abc123")
  */
 export declare function createFallbackInstanceIdentifier(host: string, apiKey: string): string;
+/**
+ * Creates a project slug for directory naming
+ * @param projectName The project name or type
+ * @returns Project slug (e.g., "personal", "marketing_project")
+ */
+export declare function createProjectSlug(projectName: string): string;
 //# sourceMappingURL=directory-utils.d.ts.map

package/dist/services/directory-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-utils.d.ts","sourceRoot":"","sources":["../../src/services/directory-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoBtG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK/H;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrF"}
+{"version":3,"file":"directory-utils.d.ts","sourceRoot":"","sources":["../../src/services/directory-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAoBtG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK/H;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAO7D"}

package/dist/services/directory-utils.js

@@ -72,4 +72,16 @@ export function createFallbackInstanceIdentifier(host, apiKey) {
     const apiKeyHash = crypto.createHash('sha256').update(apiKey).digest('hex').substring(0, 6);
     return `${hostSlug}_${apiKeyHash}`;
 }
+/**
+ * Creates a project slug for directory naming
+ * @param projectName The project name or type
+ * @returns Project slug (e.g., "personal", "marketing_project")
+ */
+export function createProjectSlug(projectName) {
+    const slug = projectName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return slug || 'project';
+}
 //# sourceMappingURL=directory-utils.js.map

package/dist/services/directory-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"directory-utils.js","sourceRoot":"","sources":["../../src/services/directory-utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,uCAAuC;IACvC,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpE,6BAA6B;IAC7B,IAAI,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,OAAO,SAAS,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,kCAAkC;IAClC,2CAA2C;IAC3C,mCAAmC;IACnC,SAAS,GAAG,SAAS;SAChB,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC;SACvC,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC;SACtC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAE3B,sDAAsD;IACtD,OAAO,SAAS;SACX,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,WAAW,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAA+D;IAC1F,qDAAqD;IACrD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IACtF,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC1B,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;aAC7B,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,iBAAiB;IACjB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,IAAgE;IACnH,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtD,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,IAAY,EAAE,MAAc;IACzE,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5F,OAAO,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"directory-utils.js","sourceRoot":"","sources":["../../src/services/directory-utils.ts"],"names":[],"mappings":"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"}

package/dist/services/n8n-api-client.d.ts

@@ -1,6 +1,7 @@
-import { IN8nCredentials, IWorkflow } from '../types.js';
+import { IN8nCredentials, IWorkflow, IProject } from '../types.js';
 export declare class N8nApiClient {
     private client;
+    private projectsCache;
     constructor(credentials: IN8nCredentials);
     testConnection(): Promise<boolean>;
     getCurrentUser(): Promise<{
@@ -9,8 +10,33 @@ export declare class N8nApiClient {
         firstName?: string;
         lastName?: string;
     } | null>;
-    getAllWorkflows(): Promise<IWorkflow[]>;
+    /**
+     * Fetches all projects from n8n.
+     * Public method for CLI/UI to show project selection.
+     *
+     * @returns Array of IProject
+     */
+    getProjects(): Promise<IProject[]>;
+    /**
+     * Fetches all projects from n8n and caches them.
+     * Returns a Map of projectId -> IProject for quick lookups.
+     *
+     * The cache is populated on first call and reused for subsequent calls.
+     * If the API call fails, returns an empty cache to allow graceful degradation.
+     *
+     * @returns Map of projectId to IProject
+     */
+    private getProjectsCache;
+    getAllWorkflows(projectId?: string): Promise<IWorkflow[]>;
     getWorkflow(id: string): Promise<IWorkflow | null>;
+    /**
+     * Enriches a workflow with organization metadata extracted from the API response.
+     * This metadata includes project information and archived status.
+     *
+     * @param workflow Raw workflow from n8n API
+     * @returns Workflow with organization metadata
+     */
+    private enrichWorkflowMetadata;
     createWorkflow(payload: Partial<IWorkflow>): Promise<IWorkflow>;
     updateWorkflow(id: string, payload: Partial<IWorkflow>): Promise<IWorkflow>;
     deleteWorkflow(id: string): Promise<boolean>;

package/dist/services/n8n-api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"n8n-api-client.d.ts","sourceRoot":"","sources":["../../src/services/n8n-api-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAgB;gBAElB,WAAW,EAAE,eAAe;IAoBlC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUlC,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAAE,GAAG,IAAI,CAAC;IA2CvG,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAWvC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAclD,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAK/D,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAoB3E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5C,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCzC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAUvC"}
+{"version":3,"file":"n8n-api-client.d.ts","sourceRoot":"","sources":["../../src/services/n8n-api-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnE,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAAsC;gBAE/C,WAAW,EAAE,eAAe;IAoBlC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUlC,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAAE,GAAG,IAAI,CAAC;IA2C7G;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IA6DxC;;;;;;;;OAQG;YACW,gBAAgB;IAiFxB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA4BzD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAexD;;;;;;OAMG;YACW,sBAAsB;IAiC9B,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAK/D,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAoB3E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5C,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D,SAAS,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAsCzC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAUvC"}

package/dist/services/n8n-api-client.js

@@ -2,6 +2,7 @@ import axios from 'axios';
 import * as https from 'https';
 export class N8nApiClient {
     client;
+    projectsCache = null;
     constructor(credentials) {
         let host = credentials.host;
         if (host.endsWith('/')) {
@@ -74,10 +75,168 @@ export class N8nApiClient {
         console.debug('[N8nApiClient] getCurrentUser: All attempts failed, returning null');
         return null;
     }
-    async getAllWorkflows() {
+    /**
+     * Fetches all projects from n8n.
+     * Public method for CLI/UI to show project selection.
+     *
+     * @returns Array of IProject
+     */
+    async getProjects() {
+        try {
+            const res = await this.client.get('/api/v1/projects');
+            const projects = res.data.data || [];
+            return projects.map((p) => ({
+                id: p.id,
+                name: p.name,
+                type: p.type,
+                createdAt: p.createdAt,
+                updatedAt: p.updatedAt
+            }));
+        }
+        catch (error) {
+            // Check if this is a license restriction error (common on local n8n instances)
+            const isLicenseError = error.response?.status === 403 &&
+                error.response?.data?.message?.includes('license') ||
+                error.response?.data?.message?.includes('feat:projectRole:admin');
+            if (isLicenseError) {
+                console.warn(`[N8nApiClient] Projects API requires license upgrade. Using personal project fallback.`);
+                // Try to get the personal project ID from existing workflows
+                try {
+                    const workflowsRes = await this.client.get('/api/v1/workflows');
+                    const workflows = workflowsRes.data.data || [];
+                    // Find a project ID from workflow shared data
+                    for (const wf of workflows) {
+                        if (wf.shared && Array.isArray(wf.shared) && wf.shared.length > 0) {
+                            const projectId = wf.shared[0].projectId;
+                            if (projectId) {
+                                console.debug(`[N8nApiClient] Found personal project ID from workflows: ${projectId}`);
+                                return [{
+                                        id: projectId,
+                                        name: 'Personal',
+                                        type: 'personal',
+                                        createdAt: new Date().toISOString(),
+                                        updatedAt: new Date().toISOString()
+                                    }];
+                            }
+                        }
+                    }
+                }
+                catch (innerError) {
+                    console.debug(`[N8nApiClient] Could not fetch workflows to discover project ID: ${innerError.message}`);
+                }
+                // Fallback: return a placeholder personal project
+                console.warn(`[N8nApiClient] No workflows found, using placeholder personal project ID`);
+                return [{
+                        id: 'personal',
+                        name: 'Personal',
+                        type: 'personal',
+                        createdAt: new Date().toISOString(),
+                        updatedAt: new Date().toISOString()
+                    }];
+            }
+            console.error(`[N8nApiClient] Failed to fetch projects: ${error.message}`);
+            return [];
+        }
+    }
+    /**
+     * Fetches all projects from n8n and caches them.
+     * Returns a Map of projectId -> IProject for quick lookups.
+     *
+     * The cache is populated on first call and reused for subsequent calls.
+     * If the API call fails, returns an empty cache to allow graceful degradation.
+     *
+     * @returns Map of projectId to IProject
+     */
+    async getProjectsCache() {
+        if (this.projectsCache !== null) {
+            return this.projectsCache;
+        }
+        try {
+            const res = await this.client.get('/api/v1/projects');
+            const projects = res.data.data || [];
+            this.projectsCache = new Map();
+            for (const project of projects) {
+                this.projectsCache.set(project.id, {
+                    id: project.id,
+                    name: project.name,
+                    type: project.type,
+                    createdAt: project.createdAt,
+                    updatedAt: project.updatedAt
+                });
+            }
+            // Only log in debug mode to avoid noise
+            if (process.env.DEBUG) {
+                console.debug(`[N8nApiClient] Cached ${this.projectsCache.size} projects`);
+            }
+            return this.projectsCache;
+        }
+        catch (error) {
+            // Check if this is a license restriction error (common on local n8n instances)
+            const isLicenseError = error.response?.status === 403 &&
+                error.response?.data?.message?.includes('license') ||
+                error.response?.data?.message?.includes('feat:projectRole:admin');
+            if (isLicenseError) {
+                console.warn(`[N8nApiClient] Projects API requires license upgrade. Using personal project fallback in cache.`);
+                // Try to get the personal project ID from existing workflows
+                try {
+                    const workflowsRes = await this.client.get('/api/v1/workflows');
+                    const workflows = workflowsRes.data.data || [];
+                    // Find a project ID from workflow shared data
+                    for (const wf of workflows) {
+                        if (wf.shared && Array.isArray(wf.shared) && wf.shared.length > 0) {
+                            const projectId = wf.shared[0].projectId;
+                            if (projectId) {
+                                console.debug(`[N8nApiClient] Found personal project ID from workflows for cache: ${projectId}`);
+                                this.projectsCache = new Map();
+                                this.projectsCache.set(projectId, {
+                                    id: projectId,
+                                    name: 'Personal',
+                                    type: 'personal',
+                                    createdAt: new Date().toISOString(),
+                                    updatedAt: new Date().toISOString()
+                                });
+                                return this.projectsCache;
+                            }
+                        }
+                    }
+                }
+                catch (innerError) {
+                    console.debug(`[N8nApiClient] Could not fetch workflows to discover project ID for cache: ${innerError.message}`);
+                }
+                // Fallback: create a placeholder personal project
+                console.warn(`[N8nApiClient] No workflows found, using placeholder personal project ID in cache`);
+                this.projectsCache = new Map();
+                this.projectsCache.set('personal', {
+                    id: 'personal',
+                    name: 'Personal',
+                    type: 'personal',
+                    createdAt: new Date().toISOString(),
+                    updatedAt: new Date().toISOString()
+                });
+                return this.projectsCache;
+            }
+            // Graceful degradation: workflows will have projectId but no homeProject/projectName
+            console.warn(`[N8nApiClient] Failed to fetch projects: ${error.message}. Workflows will not have project names.`);
+            this.projectsCache = new Map();
+            return this.projectsCache;
+        }
+    }
+    async getAllWorkflows(projectId) {
         try {
             const res = await this.client.get('/api/v1/workflows');
-            return res.data.data;
+            let workflows = res.data.data;
+            // Filter by project if specified
+            if (projectId) {
+                workflows = workflows.filter((wf) => {
+                    if (!wf.shared || !Array.isArray(wf.shared) || wf.shared.length === 0) {
+                        return false;
+                    }
+                    return wf.shared[0].projectId === projectId;
+                });
+            }
+            // Enrich workflows with organization metadata
+            const enriched = await Promise.all(workflows.map((wf) => this.enrichWorkflowMetadata(wf)));
+            return enriched;
         }
         catch (error) {
             console.error('Failed to get workflows:', error.message);
@@ -88,7 +247,8 @@ export class N8nApiClient {
     async getWorkflow(id) {
         try {
             const res = await this.client.get(`/api/v1/workflows/${id}`);
-            return res.data;
+            // Enrich with organization metadata
+            return await this.enrichWorkflowMetadata(res.data);
         }
         catch (error) {
             // 404 is expected if workflow deleted remotely
@@ -99,6 +259,40 @@ export class N8nApiClient {
             throw error;
         }
     }
+    /**
+     * Enriches a workflow with organization metadata extracted from the API response.
+     * This metadata includes project information and archived status.
+     *
+     * @param workflow Raw workflow from n8n API
+     * @returns Workflow with organization metadata
+     */
+    async enrichWorkflowMetadata(workflow) {
+        const enriched = { ...workflow };
+        // Get projects cache
+        const projectsCache = await this.getProjectsCache();
+        // Extract project information from shared array
+        // n8n stores projectId in workflow.shared[0].projectId
+        if (workflow.shared && Array.isArray(workflow.shared) && workflow.shared.length > 0) {
+            const firstShare = workflow.shared[0];
+            if (firstShare.projectId) {
+                enriched.projectId = firstShare.projectId;
+                // Look up project details in cache
+                const project = projectsCache.get(firstShare.projectId);
+                if (project) {
+                    enriched.homeProject = project;
+                    enriched.projectName = project.name;
+                }
+                else {
+                    console.debug(`[N8nApiClient] Project ${firstShare.projectId} not found in cache`);
+                }
+            }
+        }
+        // Extract archived status (direct property)
+        if (workflow.isArchived !== undefined) {
+            enriched.isArchived = workflow.isArchived;
+        }
+        return enriched;
+    }
     async createWorkflow(payload) {
         const res = await this.client.post('/api/v1/workflows', payload);
         return res.data;