@mrpatronz/nexusflow 0.2.17 → 0.2.19

package/dist/core/plugins/index.d.ts

@@ -0,0 +1,14 @@
+import type { StoragePort } from '../ports/storage.js';
+export type { StoragePort, StorageAdapterMeta, AdapterConfigField } from '../ports/storage.js';
+export interface PluginRegistryContext {
+    /** Registers a custom storage provider/adapter. The provider must include a `meta` property. */
+    registerStorageProvider(name: string, provider: StoragePort): void;
+    /** Registers a custom commander CLI subcommand. */
+    registerCommand(commandBuilder: (program: any) => void): void;
+}
+export interface NexusFlowPlugin {
+    name: string;
+    version: string;
+    register(context: PluginRegistryContext): void | Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,MAAM,WAAW,qBAAqB;IACpC,gGAAgG;IAChG,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAEnE,mDAAmD;IACnD,eAAe,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/core/plugins/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/core/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":""}

package/dist/core/plugins/loader.d.ts

@@ -0,0 +1,2 @@
+export declare function loadPlugins(program: any, pluginsList: string[]): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/loader.ts"],"names":[],"mappings":"AAIA,wBAAsB,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BpF"}

package/dist/core/plugins/loader.js

@@ -0,0 +1,34 @@
+import * as path from 'node:path';
+import { registerStorageProvider } from '../adapters/registry.js';
+export async function loadPlugins(program, pluginsList) {
+    const context = {
+        registerStorageProvider(name, provider) {
+            registerStorageProvider(name, provider);
+        },
+        registerCommand(commandBuilder) {
+            commandBuilder(program);
+        }
+    };
+    for (const pluginPath of pluginsList) {
+        try {
+            let resolvedPath = pluginPath;
+            if (pluginPath.startsWith('.') || path.isAbsolute(pluginPath)) {
+                resolvedPath = path.resolve(pluginPath);
+            }
+            // Dynamic import works with file:// URLs on Windows
+            const fileUrl = resolvedPath.startsWith('file://') ? resolvedPath : `file:///${resolvedPath.replace(/\\/g, '/')}`;
+            const module = await import(fileUrl);
+            const plugin = module.default || module.plugin;
+            if (plugin && typeof plugin.register === 'function') {
+                await plugin.register(context);
+            }
+            else {
+                console.warn(`Warning: Plugin at "${pluginPath}" does not export a valid NexusFlowPlugin.`);
+            }
+        }
+        catch (error) {
+            console.error(`Failed to load plugin "${pluginPath}":`, error.message);
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/plugins/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAY,EAAE,WAAqB;IACnE,MAAM,OAAO,GAA0B;QACrC,uBAAuB,CAAC,IAAI,EAAE,QAAQ;YACpC,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,eAAe,CAAC,cAAc;YAC5B,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,IAAI,YAAY,GAAG,UAAU,CAAC;YAC9B,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9D,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1C,CAAC;YAED,oDAAoD;YACpD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAClH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,MAAM,GAAoB,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;YAEhE,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACpD,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,uBAAuB,UAAU,4CAA4C,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,UAAU,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/ports/storage.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @module core/ports/storage
+ * Storage Port defining the interface for workspace document persistence.
+ *
+ * Adapters implement this interface to provide different storage backends.
+ * Each adapter is self-describing via the `meta` property, which enables
+ * automatic discovery in CLI, GUI, and plugin systems.
+ */
+/** Describes a single configurable field for an adapter. */
+export interface AdapterConfigField {
+    /** Machine-readable key, stored in config.json. */
+    key: string;
+    /** Human-readable label for CLI prompts and GUI forms. */
+    label: string;
+    /** Value type — 'path' renders a file picker in the GUI. */
+    type: 'string' | 'boolean' | 'number' | 'path';
+    /** Whether the field must be set before the adapter can be used. */
+    required?: boolean;
+    /** Default value when not explicitly configured. */
+    default?: unknown;
+    /** Help text shown in CLI prompts and GUI tooltips. */
+    description?: string;
+}
+/** Metadata that makes an adapter self-describing and discoverable. */
+export interface StorageAdapterMeta {
+    /** Unique machine-readable identifier (e.g. 'obsidian'). */
+    name: string;
+    /** Human-readable name for CLI tables and GUI dropdowns (e.g. 'Obsidian Vault'). */
+    displayName: string;
+    /** One-line description of what this adapter does. */
+    description: string;
+    /** Configuration fields this adapter accepts. Empty array = no config needed. */
+    configFields: AdapterConfigField[];
+}
+export interface StoragePort {
+    /** Adapter metadata — who am I, what do I need? */
+    readonly meta: StorageAdapterMeta;
+    /** Called once after registration with the user's per-adapter settings. */
+    configure?(settings: Record<string, unknown>): void;
+    /** Writes a workspace context/metadata document. */
+    writeWorkspaceFile(workspacePath: string, featureId: string, filename: string, content: string): Promise<void>;
+    /** Reads a workspace context/metadata document. */
+    readWorkspaceFile(workspacePath: string, featureId: string, filename: string): Promise<string>;
+    /** Checks if a workspace context/metadata document exists. */
+    workspaceFileExists(workspacePath: string, featureId: string, filename: string): Promise<boolean>;
+    /** Resolves the human-readable path or link to the workspace document for the AI assistant. */
+    resolveWorkspaceFileUrl(workspacePath: string, featureId: string, filename: string): string;
+    /** Writes a base-layer context document (stable maps/conventions across workspaces). */
+    writeBaseFile(workspacePath: string, repoName: string, filename: string, content: string): Promise<void>;
+    /** Reads a base-layer context document. */
+    readBaseFile(workspacePath: string, repoName: string, filename: string): Promise<string>;
+    /** Checks if a base-layer context document exists. */
+    baseFileExists(workspacePath: string, repoName: string, filename: string): Promise<boolean>;
+    /** Resolves the human-readable path or link to the base document. */
+    resolveBaseFileUrl(workspacePath: string, repoName: string, filename: string): string;
+    /** Cleanly deletes all workspace-specific documents from the storage backend. */
+    deleteWorkspace(workspacePath: string, featureId: string): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/core/ports/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/core/ports/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAElC,2EAA2E;IAC3E,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEpD,oDAAoD;IACpD,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/G,mDAAmD;IACnD,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/F,8DAA8D;IAC9D,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElG,+FAA+F;IAC/F,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5F,wFAAwF;IACxF,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzG,2CAA2C;IAC3C,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzF,sDAAsD;IACtD,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5F,qEAAqE;IACrE,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtF,iFAAiF;IACjF,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E"}

package/dist/core/ports/storage.js

@@ -0,0 +1,10 @@
+/**
+ * @module core/ports/storage
+ * Storage Port defining the interface for workspace document persistence.
+ *
+ * Adapters implement this interface to provide different storage backends.
+ * Each adapter is self-describing via the `meta` property, which enables
+ * automatic discovery in CLI, GUI, and plugin systems.
+ */
+export {};
+//# sourceMappingURL=storage.js.map

package/dist/core/ports/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/core/ports/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/core/storage.d.ts

@@ -0,0 +1,10 @@
+export declare function writeWorkspaceFile(workspacePath: string, featureId: string, filename: string, content: string): Promise<void>;
+export declare function readWorkspaceFile(workspacePath: string, featureId: string, filename: string): Promise<string>;
+export declare function workspaceFileExists(workspacePath: string, featureId: string, filename: string): Promise<boolean>;
+export declare function resolveWorkspaceFileUrl(workspacePath: string, featureId: string, filename: string): string;
+export declare function writeBaseFile(workspacePath: string, repoName: string, filename: string, content: string): Promise<void>;
+export declare function readBaseFile(workspacePath: string, repoName: string, filename: string): Promise<string>;
+export declare function baseFileExists(workspacePath: string, repoName: string, filename: string): Promise<boolean>;
+export declare function resolveBaseFileUrl(workspacePath: string, repoName: string, filename: string): string;
+export declare function deleteWorkspaceFiles(workspacePath: string, featureId: string): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/core/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAEA,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnI;AAED,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnH;AAED,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEtH;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1G;AAED,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7H;AAED,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7G;AAED,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEhH;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpG;AAED,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElG"}

package/dist/core/storage.js

@@ -0,0 +1,29 @@
+import { getActiveStorageProvider } from './adapters/registry.js';
+export async function writeWorkspaceFile(workspacePath, featureId, filename, content) {
+    await getActiveStorageProvider().writeWorkspaceFile(workspacePath, featureId, filename, content);
+}
+export async function readWorkspaceFile(workspacePath, featureId, filename) {
+    return await getActiveStorageProvider().readWorkspaceFile(workspacePath, featureId, filename);
+}
+export async function workspaceFileExists(workspacePath, featureId, filename) {
+    return await getActiveStorageProvider().workspaceFileExists(workspacePath, featureId, filename);
+}
+export function resolveWorkspaceFileUrl(workspacePath, featureId, filename) {
+    return getActiveStorageProvider().resolveWorkspaceFileUrl(workspacePath, featureId, filename);
+}
+export async function writeBaseFile(workspacePath, repoName, filename, content) {
+    await getActiveStorageProvider().writeBaseFile(workspacePath, repoName, filename, content);
+}
+export async function readBaseFile(workspacePath, repoName, filename) {
+    return await getActiveStorageProvider().readBaseFile(workspacePath, repoName, filename);
+}
+export async function baseFileExists(workspacePath, repoName, filename) {
+    return await getActiveStorageProvider().baseFileExists(workspacePath, repoName, filename);
+}
+export function resolveBaseFileUrl(workspacePath, repoName, filename) {
+    return getActiveStorageProvider().resolveBaseFileUrl(workspacePath, repoName, filename);
+}
+export async function deleteWorkspaceFiles(workspacePath, featureId) {
+    await getActiveStorageProvider().deleteWorkspace(workspacePath, featureId);
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,aAAqB,EAAE,SAAiB,EAAE,QAAgB,EAAE,OAAe;IAClH,MAAM,wBAAwB,EAAE,CAAC,kBAAkB,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,SAAiB,EAAE,QAAgB;IAChG,OAAO,MAAM,wBAAwB,EAAE,CAAC,iBAAiB,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,aAAqB,EAAE,SAAiB,EAAE,QAAgB;IAClG,OAAO,MAAM,wBAAwB,EAAE,CAAC,mBAAmB,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,aAAqB,EAAE,SAAiB,EAAE,QAAgB;IAChG,OAAO,wBAAwB,EAAE,CAAC,uBAAuB,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,aAAqB,EAAE,QAAgB,EAAE,QAAgB,EAAE,OAAe;IAC5G,MAAM,wBAAwB,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,aAAqB,EAAE,QAAgB,EAAE,QAAgB;IAC1F,OAAO,MAAM,wBAAwB,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,aAAqB,EAAE,QAAgB,EAAE,QAAgB;IAC5F,OAAO,MAAM,wBAAwB,EAAE,CAAC,cAAc,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,QAAgB,EAAE,QAAgB;IAC1F,OAAO,wBAAwB,EAAE,CAAC,kBAAkB,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAqB,EAAE,SAAiB;IACjF,MAAM,wBAAwB,EAAE,CAAC,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAC7E,CAAC"}

package/dist/core/sync.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @module core/sync
+ * Headless workspace sync — rebases every repo in a workspace onto its base
+ * branch, records the per-repo outcome to workspace state, and regenerates
+ * context files. Produces no console output, so it can back the CLI, the HTTP
+ * API, and the MCP tool alike.
+ */
+import type { SyncStatus } from '../types.js';
+/** Sync outcome for a single repo. */
+export interface RepoSyncReport {
+    /** Directory name of the repo. */
+    name: string;
+    /** Classified outcome. */
+    status: SyncStatus;
+    /** Human-readable message. */
+    message: string;
+    /** Conflict stderr — populated only for `status === 'conflict'`. */
+    conflict?: string;
+}
+/** Aggregated result of syncing an entire workspace. */
+export interface SyncReport {
+    /** Absolute path to the workspace. */
+    workspacePath: string;
+    /** Feature branch name being synced. */
+    branchName: string;
+    /** Per-repo outcomes, in workspace order. */
+    repos: RepoSyncReport[];
+    /** Count of repos that landed cleanly (up-to-date, rebased, or stash-conflict). */
+    syncedCount: number;
+    /** Count of repos with a genuine merge conflict. */
+    conflictCount: number;
+    /** Count of repos that failed for infrastructure reasons (fetch/auth, etc.). */
+    errorCount: number;
+}
+/**
+ * Syncs all repos in a workspace. Throws if the workspace configuration cannot
+ * be loaded; individual repo failures are captured in the returned report
+ * rather than thrown.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ * @returns A structured report of every repo's outcome.
+ */
+export declare function syncWorkspace(workspacePath: string): Promise<SyncReport>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/core/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAEhE,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8D9E"}

package/dist/core/sync.js

@@ -0,0 +1,82 @@
+/**
+ * @module core/sync
+ * Headless workspace sync — rebases every repo in a workspace onto its base
+ * branch, records the per-repo outcome to workspace state, and regenerates
+ * context files. Produces no console output, so it can back the CLI, the HTTP
+ * API, and the MCP tool alike.
+ */
+import * as path from 'node:path';
+import { loadFeatureConfig } from './workspace.js';
+import { recordRepoSync } from './workspace-state.js';
+import { getWorkspaceRepos, rebaseRepo } from '../utils/multi-git.js';
+import { analyzeAllRepos } from '../analyzers/index.js';
+import { generateContextFiles } from '../generators/index.js';
+/** A sync status counts as "synced" when the rebase itself landed. */
+function isSynced(status) {
+    return status === 'up-to-date' || status === 'rebased' || status === 'stash-conflict';
+}
+/**
+ * Syncs all repos in a workspace. Throws if the workspace configuration cannot
+ * be loaded; individual repo failures are captured in the returned report
+ * rather than thrown.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ * @returns A structured report of every repo's outcome.
+ */
+export async function syncWorkspace(workspacePath) {
+    const feature = await loadFeatureConfig(workspacePath);
+    if (!feature) {
+        throw new Error(`Failed to load workspace configuration. Ensure nexusflow.json exists at ${workspacePath}.`);
+    }
+    const repos = await getWorkspaceRepos(workspacePath);
+    const repoReports = [];
+    let syncedCount = 0;
+    let conflictCount = 0;
+    let errorCount = 0;
+    for (const repo of repos) {
+        const defaultBranch = repo.defaultBranch || 'main';
+        const result = await rebaseRepo(repo.path, defaultBranch);
+        await recordRepoSync(workspacePath, repo.name, {
+            status: result.status,
+            message: result.message,
+        });
+        repoReports.push({
+            name: repo.name,
+            status: result.status,
+            message: result.message,
+            conflict: result.conflict,
+        });
+        if (isSynced(result.status))
+            syncedCount++;
+        else if (result.status === 'conflict')
+            conflictCount++;
+        else
+            errorCount++;
+    }
+    // Regenerate maps/context when anything synced. A regen failure must never
+    // fail the sync itself — the rebases already happened.
+    if (syncedCount > 0) {
+        try {
+            const allRepos = feature.repos.map((r) => ({
+                name: path.basename(r),
+                path: r,
+                defaultBranch: 'main',
+            }));
+            const analysis = await analyzeAllRepos(allRepos);
+            const ctx = { feature, repos: allRepos, analysis };
+            await generateContextFiles(ctx, feature.assistants, workspacePath);
+        }
+        catch {
+            // Best-effort regeneration; ignore failures.
+        }
+    }
+    return {
+        workspacePath,
+        branchName: feature.branchName,
+        repos: repoReports,
+        syncedCount,
+        conflictCount,
+        errorCount,
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/sync.js.map

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

package/dist/core/workspace-state.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @module core/workspace-state
+ * Persists per-repo sync/validation state for a workspace in a single
+ * `.nexusflow-state.json` file at the workspace root.
+ *
+ * Mirrors the lightweight state-file pattern used by `orchestration/runner.ts`
+ * for running services. Tracks, per repo: when it was last synced, the
+ * classified result, whether it is pending re-validation, and the last
+ * validation outcome — so agents no longer need to hand-roll their own state.
+ */
+import type { RepoSyncState, SyncStatus, WorkspaceState } from '../types.js';
+/**
+ * Loads the workspace state from disk, returning an empty skeleton when the
+ * file does not exist or cannot be parsed.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ */
+export declare function loadWorkspaceState(workspacePath: string): Promise<WorkspaceState>;
+/**
+ * Saves the workspace state to disk.
+ *
+ * @param state - The state to persist. Its `updatedAt` is refreshed on write.
+ */
+export declare function saveWorkspaceState(state: WorkspaceState): Promise<void>;
+/**
+ * Records the outcome of a sync attempt for a single repo and persists it.
+ *
+ * Sets `pendingValidation` to true when new commits were pulled in
+ * (`status === 'rebased'`), signalling that the repo should be re-validated.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ * @param repoName      - Directory name of the repo.
+ * @param result        - The classified sync status and message.
+ * @returns The updated per-repo state entry.
+ */
+export declare function recordRepoSync(workspacePath: string, repoName: string, result: {
+    status: SyncStatus;
+    message: string;
+}): Promise<RepoSyncState>;
+/**
+ * Records the result of a validation run (e.g. tests/e2e) for a repo and clears
+ * its pending-validation flag. Provided for the validation flow that consumes
+ * `pendingValidation`.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ * @param repoName      - Directory name of the repo.
+ * @param result        - Whether validation passed or failed.
+ * @returns The updated per-repo state entry.
+ */
+export declare function markValidated(workspacePath: string, repoName: string, result: 'pass' | 'fail'): Promise<RepoSyncState>;
+//# sourceMappingURL=workspace-state.d.ts.map

package/dist/core/workspace-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state.d.ts","sourceRoot":"","sources":["../../src/core/workspace-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAY7E;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/dist/core/workspace-state.js

@@ -0,0 +1,108 @@
+/**
+ * @module core/workspace-state
+ * Persists per-repo sync/validation state for a workspace in a single
+ * `.nexusflow-state.json` file at the workspace root.
+ *
+ * Mirrors the lightweight state-file pattern used by `orchestration/runner.ts`
+ * for running services. Tracks, per repo: when it was last synced, the
+ * classified result, whether it is pending re-validation, and the last
+ * validation outcome — so agents no longer need to hand-roll their own state.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/** Name of the per-repo state file, written at the workspace root. */
+const STATE_FILE = '.nexusflow-state.json';
+/**
+ * Returns the path to the workspace state file.
+ */
+function getStatePath(workspacePath) {
+    return path.join(workspacePath, STATE_FILE);
+}
+/**
+ * Loads the workspace state from disk, returning an empty skeleton when the
+ * file does not exist or cannot be parsed.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ */
+export async function loadWorkspaceState(workspacePath) {
+    try {
+        const raw = await fs.readFile(getStatePath(workspacePath), 'utf-8');
+        const state = JSON.parse(raw);
+        // Defend against a malformed/legacy file lacking the repos map.
+        if (!state.repos || typeof state.repos !== 'object') {
+            state.repos = {};
+        }
+        state.workspacePath = workspacePath;
+        return state;
+    }
+    catch {
+        return {
+            workspacePath,
+            repos: {},
+            updatedAt: new Date().toISOString(),
+        };
+    }
+}
+/**
+ * Saves the workspace state to disk.
+ *
+ * @param state - The state to persist. Its `updatedAt` is refreshed on write.
+ */
+export async function saveWorkspaceState(state) {
+    const toWrite = { ...state, updatedAt: new Date().toISOString() };
+    const data = JSON.stringify(toWrite, null, 2) + '\n';
+    await fs.writeFile(getStatePath(state.workspacePath), data, 'utf-8');
+}
+/**
+ * Records the outcome of a sync attempt for a single repo and persists it.
+ *
+ * Sets `pendingValidation` to true when new commits were pulled in
+ * (`status === 'rebased'`), signalling that the repo should be re-validated.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ * @param repoName      - Directory name of the repo.
+ * @param result        - The classified sync status and message.
+ * @returns The updated per-repo state entry.
+ */
+export async function recordRepoSync(workspacePath, repoName, result) {
+    const state = await loadWorkspaceState(workspacePath);
+    const existing = state.repos[repoName] ?? { repoName };
+    const updated = {
+        ...existing,
+        repoName,
+        lastSyncedAt: new Date().toISOString(),
+        lastSyncStatus: result.status,
+        lastSyncMessage: result.message,
+        // New commits landed → the repo needs re-validation. Preserve an existing
+        // pending flag otherwise (a no-op sync doesn't clear prior pending work).
+        pendingValidation: result.status === 'rebased' ? true : existing.pendingValidation ?? false,
+    };
+    state.repos[repoName] = updated;
+    await saveWorkspaceState(state);
+    return updated;
+}
+/**
+ * Records the result of a validation run (e.g. tests/e2e) for a repo and clears
+ * its pending-validation flag. Provided for the validation flow that consumes
+ * `pendingValidation`.
+ *
+ * @param workspacePath - Absolute path to the workspace root.
+ * @param repoName      - Directory name of the repo.
+ * @param result        - Whether validation passed or failed.
+ * @returns The updated per-repo state entry.
+ */
+export async function markValidated(workspacePath, repoName, result) {
+    const state = await loadWorkspaceState(workspacePath);
+    const existing = state.repos[repoName] ?? { repoName };
+    const updated = {
+        ...existing,
+        repoName,
+        lastValidationResult: result,
+        lastValidatedAt: new Date().toISOString(),
+        pendingValidation: false,
+    };
+    state.repos[repoName] = updated;
+    await saveWorkspaceState(state);
+    return updated;
+}
+//# sourceMappingURL=workspace-state.js.map

package/dist/core/workspace-state.js.map

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

package/dist/core/workspace-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace-state.test.d.ts.map

package/dist/core/workspace-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-state.test.d.ts","sourceRoot":"","sources":["../../src/core/workspace-state.test.ts"],"names":[],"mappings":""}

package/dist/core/workspace-state.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import { loadWorkspaceState, recordRepoSync, markValidated, } from './workspace-state.js';
+vi.mock('node:fs/promises');
+/** Parses the JSON written by the most recent writeFile call. */
+function lastWritten() {
+    const calls = vi.mocked(fs.writeFile).mock.calls;
+    const data = calls[calls.length - 1][1];
+    return JSON.parse(data);
+}
+describe('workspace-state', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+    });
+    describe('loadWorkspaceState', () => {
+        it('returns an empty skeleton when the file is absent', async () => {
+            vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
+            const state = await loadWorkspaceState('/ws');
+            expect(state.workspacePath).toBe('/ws');
+            expect(state.repos).toEqual({});
+        });
+        it('round-trips an existing state file', async () => {
+            const existing = {
+                workspacePath: '/ws',
+                repos: { api: { repoName: 'api', lastSyncStatus: 'rebased' } },
+                updatedAt: '2026-01-01T00:00:00.000Z',
+            };
+            vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(existing));
+            const state = await loadWorkspaceState('/ws');
+            expect(state.repos.api.lastSyncStatus).toBe('rebased');
+        });
+    });
+    describe('recordRepoSync', () => {
+        beforeEach(() => {
+            vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
+        });
+        it('sets pendingValidation when a repo was rebased', async () => {
+            const entry = await recordRepoSync('/ws', 'api', {
+                status: 'rebased',
+                message: 'Rebased onto latest base',
+            });
+            expect(entry.pendingValidation).toBe(true);
+            expect(entry.lastSyncStatus).toBe('rebased');
+            expect(entry.lastSyncedAt).toBeTruthy();
+            expect(lastWritten().repos.api.pendingValidation).toBe(true);
+        });
+        it('does not set pendingValidation for an up-to-date repo', async () => {
+            const entry = await recordRepoSync('/ws', 'api', {
+                status: 'up-to-date',
+                message: 'Up to date',
+            });
+            expect(entry.pendingValidation).toBe(false);
+        });
+        it('preserves a prior pending flag on a later no-op sync', async () => {
+            const existing = {
+                workspacePath: '/ws',
+                repos: { api: { repoName: 'api', pendingValidation: true } },
+                updatedAt: '2026-01-01T00:00:00.000Z',
+            };
+            vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(existing));
+            const entry = await recordRepoSync('/ws', 'api', {
+                status: 'up-to-date',
+                message: 'Up to date',
+            });
+            expect(entry.pendingValidation).toBe(true);
+        });
+    });
+    describe('markValidated', () => {
+        it('records the result and clears the pending flag', async () => {
+            const existing = {
+                workspacePath: '/ws',
+                repos: { api: { repoName: 'api', pendingValidation: true } },
+                updatedAt: '2026-01-01T00:00:00.000Z',
+            };
+            vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(existing));
+            const entry = await markValidated('/ws', 'api', 'pass');
+            expect(entry.lastValidationResult).toBe('pass');
+            expect(entry.pendingValidation).toBe(false);
+            expect(entry.lastValidatedAt).toBeTruthy();
+        });
+    });
+});
+//# sourceMappingURL=workspace-state.test.js.map

package/dist/core/workspace-state.test.js.map

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

package/dist/core/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/core/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAWvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAuEjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC,CAmCpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAWzB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBjF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOzE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAgEf"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/core/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAYvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,QAAQ,EAAE,GAChB,OAAO,CAAC,MAAM,CAAC,CAiGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,EAAE,CAAC,CAmCpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA+BzB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBjF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOzE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAwDf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA6Df"}