@gitgov/core 1.0.0

package/dist/src/config_manager/config_manager.test.js

@@ -0,0 +1,321 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { ConfigManager } from './index';
+// Mock filesystem operations
+jest.mock('fs', () => ({
+    promises: {
+        readFile: jest.fn(),
+        writeFile: jest.fn(),
+    },
+    existsSync: jest.fn(),
+}));
+const mockedFs = jest.mocked(fs);
+const mockedExistsSync = jest.mocked(require('fs').existsSync);
+describe('ConfigManager', () => {
+    let configManager;
+    let tempDir;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        tempDir = '/test/project';
+        configManager = new ConfigManager(tempDir);
+        // Reset project root cache
+        global.projectRoot = null;
+    });
+    // --- Configuration Methods (EARS-1 to EARS-6) ---
+    describe('loadConfig', () => {
+        it('[EARS-1] WHEN loadConfig is invoked with valid config.json file, THE SYSTEM SHALL return complete GitGovConfig object', async () => {
+            const mockConfig = {
+                protocolVersion: '1.0',
+                projectId: 'test-project-123',
+                projectName: 'Test Project',
+                rootCycle: 'root-cycle-456',
+                blueprints: { root: './blueprints' },
+                state: { branch: 'gitgov-state' },
+                cloud: { projectId: 'cloud-123', providerMappings: { github: 'repo-456' } }
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockConfig));
+            const result = await configManager.loadConfig();
+            expect(result).toEqual(mockConfig);
+            expect(mockedFs.readFile).toHaveBeenCalledWith(path.join(tempDir, '.gitgov', 'config.json'), 'utf-8');
+        });
+        it('[EARS-2] WHEN loadConfig is invoked with non-existent config.json file, THE SYSTEM SHALL return null without throwing error', async () => {
+            mockedFs.readFile.mockRejectedValue(new Error('ENOENT: no such file or directory'));
+            const result = await configManager.loadConfig();
+            expect(result).toBeNull();
+        });
+        it('[EARS-3] WHEN loadConfig is invoked with invalid JSON in config.json, THE SYSTEM SHALL return null without throwing error', async () => {
+            mockedFs.readFile.mockResolvedValue('{ invalid json }');
+            const result = await configManager.loadConfig();
+            expect(result).toBeNull();
+        });
+    });
+    describe('getRootCycle', () => {
+        it('[EARS-4] WHEN getRootCycle is invoked with configuration that has rootCycle defined, THE SYSTEM SHALL return the root cycle ID', async () => {
+            const mockConfig = {
+                protocolVersion: '1.0',
+                projectId: 'test-project',
+                projectName: 'Test',
+                rootCycle: 'root-cycle-123'
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockConfig));
+            const result = await configManager.getRootCycle();
+            expect(result).toBe('root-cycle-123');
+        });
+        it('[EARS-5] WHEN getRootCycle is invoked with configuration without rootCycle defined, THE SYSTEM SHALL return null', async () => {
+            // Note: This test simulates an invalid/incomplete config.json file
+            // In practice, rootCycle is obligatory and created during 'gitgov init'
+            const incompleteConfig = {
+                protocolVersion: '1.0',
+                projectId: 'test-project',
+                projectName: 'Test'
+                // Missing rootCycle - invalid config
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(incompleteConfig));
+            const result = await configManager.getRootCycle();
+            expect(result).toBeNull();
+        });
+    });
+    describe('getProjectInfo', () => {
+        it('[EARS-6] WHEN getProjectInfo is invoked with valid configuration, THE SYSTEM SHALL return object with projectId and projectName', async () => {
+            const mockConfig = {
+                protocolVersion: '1.0',
+                projectId: 'project-456',
+                projectName: 'My Project',
+                rootCycle: 'root-cycle-789'
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockConfig));
+            const result = await configManager.getProjectInfo();
+            expect(result).toEqual({
+                id: 'project-456',
+                name: 'My Project'
+            });
+        });
+    });
+    // --- Session Methods (EARS-7 to EARS-14) ---
+    describe('loadSession', () => {
+        it('[EARS-7] WHEN loadSession is invoked with valid .session.json file, THE SYSTEM SHALL return complete GitGovSession object', async () => {
+            const mockSession = {
+                cloud: { sessionToken: 'jwt-token-123' },
+                lastSession: { actorId: 'human:camilo', timestamp: '2025-01-09T10:00:00Z' },
+                actorState: {
+                    'human:camilo': { activeTaskId: 'task-123', activeCycleId: 'cycle-456', lastSync: '2025-01-09T09:30:00Z' }
+                }
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockSession));
+            const result = await configManager.loadSession();
+            expect(result).toEqual(mockSession);
+            expect(mockedFs.readFile).toHaveBeenCalledWith(path.join(tempDir, '.gitgov', '.session.json'), 'utf-8');
+        });
+        it('[EARS-8] WHEN loadSession is invoked with non-existent .session.json file, THE SYSTEM SHALL return null without throwing error', async () => {
+            mockedFs.readFile.mockRejectedValue(new Error('ENOENT: no such file or directory'));
+            const result = await configManager.loadSession();
+            expect(result).toBeNull();
+        });
+    });
+    describe('getActorState', () => {
+        it('[EARS-9] WHEN getActorState is invoked with actorId existing in session, THE SYSTEM SHALL return actor state', async () => {
+            const mockSession = {
+                actorState: {
+                    'human:camilo': { activeTaskId: 'task-789', activeCycleId: 'cycle-101', lastSync: '2025-01-09T10:15:00Z' }
+                }
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockSession));
+            const result = await configManager.getActorState('human:camilo');
+            expect(result).toEqual({
+                activeTaskId: 'task-789',
+                activeCycleId: 'cycle-101',
+                lastSync: '2025-01-09T10:15:00Z'
+            });
+        });
+        it('[EARS-10] WHEN getActorState is invoked with non-existent actorId, THE SYSTEM SHALL return null', async () => {
+            const mockSession = {
+                actorState: {
+                    'human:alice': { activeTaskId: 'task-999' }
+                }
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockSession));
+            const result = await configManager.getActorState('human:bob');
+            expect(result).toBeNull();
+        });
+    });
+    describe('updateActorState', () => {
+        it('[EARS-11] WHEN updateActorState is invoked, THE SYSTEM SHALL merge partial state with existing state and persist', async () => {
+            const existingSession = {
+                actorState: {
+                    'human:camilo': { activeTaskId: 'task-old', activeCycleId: 'cycle-old', lastSync: '2025-01-08T10:00:00Z' }
+                }
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(existingSession));
+            mockedFs.writeFile.mockResolvedValue();
+            const partialState = { activeTaskId: 'task-new' };
+            await configManager.updateActorState('human:camilo', partialState);
+            expect(mockedFs.writeFile).toHaveBeenCalledWith(path.join(tempDir, '.gitgov', '.session.json'), expect.stringContaining('task-new'), 'utf-8');
+            expect(mockedFs.writeFile).toHaveBeenCalledWith(path.join(tempDir, '.gitgov', '.session.json'), expect.stringContaining('cycle-old'), 'utf-8');
+        });
+        it('[EARS-12] WHEN updateActorState is invoked with non-existent session, THE SYSTEM SHALL create new session with provided state', async () => {
+            mockedFs.readFile.mockRejectedValue(new Error('ENOENT'));
+            mockedFs.writeFile.mockResolvedValue();
+            const newState = { activeTaskId: 'task-first', activeCycleId: 'cycle-first' };
+            await configManager.updateActorState('human:new-user', newState);
+            expect(mockedFs.writeFile).toHaveBeenCalledWith(path.join(tempDir, '.gitgov', '.session.json'), expect.stringContaining('human:new-user'), 'utf-8');
+            expect(mockedFs.writeFile).toHaveBeenCalledWith(path.join(tempDir, '.gitgov', '.session.json'), expect.stringContaining('task-first'), 'utf-8');
+        });
+    });
+    describe('getCloudSessionToken', () => {
+        it('[EARS-13] WHEN getCloudSessionToken is invoked with token configured, THE SYSTEM SHALL return the session token', async () => {
+            const mockSession = {
+                cloud: { sessionToken: 'jwt-token-xyz' }
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockSession));
+            const result = await configManager.getCloudSessionToken();
+            expect(result).toBe('jwt-token-xyz');
+        });
+        it('[EARS-14] WHEN getCloudSessionToken is invoked without token configured, THE SYSTEM SHALL return null', async () => {
+            const mockSession = {
+                lastSession: { actorId: 'human:test', timestamp: '2025-01-09T10:00:00Z' }
+                // No cloud.sessionToken
+            };
+            mockedFs.readFile.mockResolvedValue(JSON.stringify(mockSession));
+            const result = await configManager.getCloudSessionToken();
+            expect(result).toBeNull();
+        });
+    });
+    // --- Static Utility Methods (EARS-15 to EARS-20) ---
+    describe('findProjectRoot', () => {
+        beforeEach(() => {
+            // Reset project root cache before each test
+            global.projectRoot = null;
+        });
+        it('[EARS-15] WHEN findProjectRoot is invoked from directory within Git project, THE SYSTEM SHALL return absolute path to root directory', () => {
+            const startPath = '/test/project/src/components';
+            const rootPath = '/test/project';
+            mockedExistsSync.mockImplementation((checkPath) => {
+                return checkPath === path.join(rootPath, '.git');
+            });
+            const result = ConfigManager.findProjectRoot(startPath);
+            expect(result).toBe(rootPath);
+        });
+        it('[EARS-16] WHEN findProjectRoot is invoked from directory outside Git project, THE SYSTEM SHALL return null', () => {
+            mockedExistsSync.mockReturnValue(false);
+            // Reset cache for this specific test
+            global.projectRoot = null;
+            const result = ConfigManager.findProjectRoot('/some/random/path');
+            expect(result).toBeNull();
+        });
+    });
+    describe('findGitgovRoot - Critical for CLI Directory Search', () => {
+        it('[CRITICAL-BUG-PREVENTION] should find .gitgov when executing from subdirectory', () => {
+            // This test ensures CLI commands work from any subdirectory
+            const rootPath = '/Users/camilo/solo-hub';
+            const subPath = '/Users/camilo/solo-hub/packages/cli';
+            // Mock existsSync to return true for .gitgov at root
+            mockedExistsSync.mockImplementation((path) => {
+                return path === '/Users/camilo/solo-hub/.gitgov';
+            });
+            const result = ConfigManager.findGitgovRoot(subPath);
+            expect(result).toBe(rootPath);
+        });
+        it('[CRITICAL-BUG-PREVENTION] should NOT find parent .gitgov when doing init', () => {
+            // This test ensures init doesn't accidentally find parent .gitgov
+            // When user wants to create NEW project in subdirectory
+            const currentPath = '/Users/camilo/new-project';
+            // Mock: parent has .gitgov but current doesn't
+            mockedExistsSync.mockImplementation((path) => {
+                if (path === '/Users/camilo/solo-hub/.gitgov') {
+                    return true; // Parent has .gitgov
+                }
+                if (path === '/Users/camilo/new-project/.gitgov') {
+                    return false; // Current doesn't have .gitgov
+                }
+                if (path === '/Users/camilo/new-project/.git') {
+                    return true; // Current has .git (valid for init)
+                }
+                return false;
+            });
+            const result = ConfigManager.findGitgovRoot(currentPath);
+            // Should find .git in current directory, NOT .gitgov in parent
+            expect(result).toBe(currentPath);
+        });
+    });
+    describe('findGitgovRoot', () => {
+        beforeEach(() => {
+            // Reset project root cache before each test
+            global.projectRoot = null;
+        });
+        it('should find .gitgov directory when searching upward', () => {
+            const rootPath = '/test/project';
+            const subPath = '/test/project/packages/cli';
+            // Mock existsSync to return true for .gitgov at root
+            mockedExistsSync.mockImplementation((path) => {
+                return path === '/test/project/.gitgov';
+            });
+            const result = ConfigManager.findGitgovRoot(subPath);
+            expect(result).toBe(rootPath);
+        });
+        it('should find .git directory when no .gitgov exists (for init)', () => {
+            const rootPath = '/test/project';
+            const subPath = '/test/project/packages/cli';
+            // Mock existsSync to return true for .git at root
+            mockedExistsSync.mockImplementation((path) => {
+                return path === '/test/project/.git';
+            });
+            const result = ConfigManager.findGitgovRoot(subPath);
+            expect(result).toBe(rootPath);
+        });
+        it('should prefer .gitgov over .git when both exist', () => {
+            const rootPath = '/test/project';
+            const subPath = '/test/project/packages/cli';
+            // Mock existsSync to return true for both
+            mockedExistsSync.mockImplementation((path) => {
+                return path === '/test/project/.gitgov' || path === '/test/project/.git';
+            });
+            const result = ConfigManager.findGitgovRoot(subPath);
+            expect(result).toBe(rootPath);
+        });
+        it('should return null when neither .gitgov nor .git found', () => {
+            const subPath = '/test/project/packages/cli';
+            // Mock existsSync to always return false
+            mockedExistsSync.mockReturnValue(false);
+            const result = ConfigManager.findGitgovRoot(subPath);
+            expect(result).toBeNull();
+        });
+    });
+    describe('getGitgovPath', () => {
+        beforeEach(() => {
+            // Reset project root cache before each test
+            global.projectRoot = null;
+        });
+        it('[EARS-17] WHEN getGitgovPath is invoked from GitGovernance project, THE SYSTEM SHALL return absolute path to .gitgov directory', () => {
+            const rootPath = '/test/project';
+            // Mock findGitgovRoot to return a specific path
+            jest.spyOn(ConfigManager, 'findGitgovRoot').mockReturnValue(rootPath);
+            const result = ConfigManager.getGitgovPath();
+            expect(result).toBe(path.join(rootPath, '.gitgov'));
+        });
+        it('[EARS-18] WHEN getGitgovPath is invoked outside GitGovernance project, THE SYSTEM SHALL throw descriptive Error', () => {
+            // Mock findGitgovRoot to return null
+            jest.spyOn(ConfigManager, 'findGitgovRoot').mockReturnValue(null);
+            expect(() => ConfigManager.getGitgovPath()).toThrow('Could not find project root. Make sure you are inside a GitGovernance repository.');
+        });
+    });
+    describe('isGitgovProject', () => {
+        beforeEach(() => {
+            // Reset project root cache before each test
+            global.projectRoot = null;
+        });
+        it('[EARS-19] WHEN isGitgovProject is invoked from GitGovernance project, THE SYSTEM SHALL return true', () => {
+            const rootPath = '/test/project';
+            // Mock getGitgovPath to return a valid path and existsSync to return true
+            jest.spyOn(ConfigManager, 'getGitgovPath').mockReturnValue(path.join(rootPath, '.gitgov'));
+            mockedExistsSync.mockReturnValue(true);
+            const result = ConfigManager.isGitgovProject();
+            expect(result).toBe(true);
+        });
+        it('[EARS-20] WHEN isGitgovProject is invoked outside GitGovernance project, THE SYSTEM SHALL return false', () => {
+            mockedExistsSync.mockReturnValue(false);
+            const result = ConfigManager.isGitgovProject();
+            expect(result).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=config_manager.test.js.map

package/dist/src/config_manager/config_manager.test.js.map

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

package/dist/src/config_manager/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * GitGovernance Configuration Types
+ * Based on config_file.md blueprint
+ */
+export interface GitGovConfig {
+    protocolVersion: string;
+    projectId: string;
+    projectName: string;
+    rootCycle: string;
+    blueprints?: {
+        root?: string;
+    };
+    state?: {
+        branch?: string;
+    };
+    cloud?: {
+        projectId?: string;
+        providerMappings?: Record<string, string>;
+    };
+}
+/**
+ * GitGovernance Session State Types
+ * Based on session_state.md blueprint
+ */
+export interface ActorState {
+    activeTaskId?: string;
+    activeCycleId?: string;
+    lastSync?: string;
+    [key: string]: any;
+}
+export interface GitGovSession {
+    cloud?: {
+        sessionToken?: string;
+    };
+    lastSession?: {
+        actorId: string;
+        timestamp: string;
+    };
+    actorState?: Record<string, ActorState>;
+}
+/**
+ * Configuration Manager Class
+ * Provides typed access to GitGovernance configuration and session state
+ */
+export declare class ConfigManager {
+    private configPath;
+    private sessionPath;
+    constructor(projectRootPath?: string);
+    /**
+     * Load GitGovernance configuration
+     */
+    loadConfig(): Promise<GitGovConfig | null>;
+    /**
+     * Load GitGovernance session state
+     */
+    loadSession(): Promise<GitGovSession | null>;
+    /**
+     * Get root cycle from configuration
+     */
+    getRootCycle(): Promise<string | null>;
+    /**
+     * Get project information from configuration
+     */
+    getProjectInfo(): Promise<{
+        id: string;
+        name: string;
+    } | null>;
+    /**
+     * Get actor state for a specific actor
+     */
+    getActorState(actorId: string): Promise<ActorState | null>;
+    /**
+     * Update actor state for a specific actor
+     */
+    updateActorState(actorId: string, state: Partial<ActorState>): Promise<void>;
+    /**
+     * Get cloud session token
+     */
+    getCloudSessionToken(): Promise<string | null>;
+    /**
+     * Finds the project root by searching upwards for a .git directory.
+     * Caches the result for subsequent calls.
+     * @param startPath The path to start searching from. Defaults to the current working directory.
+     * @returns The absolute path to the project root, or null if not found.
+     */
+    static findProjectRoot(startPath?: string): string | null;
+    /**
+     * Finds the appropriate project root by searching upwards.
+     * First looks for .gitgov (initialized project), then .git (for init).
+     * @param startPath The path to start searching from. Defaults to the current working directory.
+     * @returns The absolute path to the project root, or null if not found.
+     */
+    static findGitgovRoot(startPath?: string): string | null;
+    /**
+     * Gets the .gitgov directory path from project root
+     */
+    static getGitgovPath(): string;
+    /**
+     * Checks if current directory is a GitGovernance project
+     */
+    static isGitgovProject(): boolean;
+}
+/**
+ * Create a ConfigManager instance for the current project
+ */
+export declare function createConfigManager(projectRoot?: string): ConfigManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/config_manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config_manager/index.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC3C,CAAC;CACH;AAED;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,eAAe,GAAE,MAAyD;IAKtF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAUhD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUlD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK5C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAUpE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKhE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAalF;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOpD;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI;IAuCxE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI;IAiCvE;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;IAQ9B;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,OAAO;CAQlC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAEvE"}

package/dist/src/config_manager/index.js

@@ -0,0 +1,192 @@
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { existsSync } from 'fs';
+// Project root cache for performance
+let projectRoot = null;
+let lastSearchPath = null;
+/**
+ * Configuration Manager Class
+ * Provides typed access to GitGovernance configuration and session state
+ */
+export class ConfigManager {
+    configPath;
+    sessionPath;
+    constructor(projectRootPath = ConfigManager.findProjectRoot() || process.cwd()) {
+        this.configPath = path.join(projectRootPath, '.gitgov', 'config.json');
+        this.sessionPath = path.join(projectRootPath, '.gitgov', '.session.json');
+    }
+    /**
+     * Load GitGovernance configuration
+     */
+    async loadConfig() {
+        try {
+            const configContent = await fs.readFile(this.configPath, 'utf-8');
+            return JSON.parse(configContent);
+        }
+        catch (error) {
+            // Config file doesn't exist or is invalid
+            return null;
+        }
+    }
+    /**
+     * Load GitGovernance session state
+     */
+    async loadSession() {
+        try {
+            const sessionContent = await fs.readFile(this.sessionPath, 'utf-8');
+            return JSON.parse(sessionContent);
+        }
+        catch (error) {
+            // Session file doesn't exist or is invalid
+            return null;
+        }
+    }
+    /**
+     * Get root cycle from configuration
+     */
+    async getRootCycle() {
+        const config = await this.loadConfig();
+        return config?.rootCycle || null;
+    }
+    /**
+     * Get project information from configuration
+     */
+    async getProjectInfo() {
+        const config = await this.loadConfig();
+        if (!config)
+            return null;
+        return {
+            id: config.projectId,
+            name: config.projectName
+        };
+    }
+    /**
+     * Get actor state for a specific actor
+     */
+    async getActorState(actorId) {
+        const session = await this.loadSession();
+        return session?.actorState?.[actorId] || null;
+    }
+    /**
+     * Update actor state for a specific actor
+     */
+    async updateActorState(actorId, state) {
+        const session = await this.loadSession() || {};
+        if (!session.actorState)
+            session.actorState = {};
+        session.actorState[actorId] = {
+            ...session.actorState[actorId],
+            ...state,
+            lastSync: new Date().toISOString()
+        };
+        await fs.writeFile(this.sessionPath, JSON.stringify(session, null, 2), 'utf-8');
+    }
+    /**
+     * Get cloud session token
+     */
+    async getCloudSessionToken() {
+        const session = await this.loadSession();
+        return session?.cloud?.sessionToken || null;
+    }
+    // --- Static Utility Methods (consolidated from project-utils) ---
+    /**
+     * Finds the project root by searching upwards for a .git directory.
+     * Caches the result for subsequent calls.
+     * @param startPath The path to start searching from. Defaults to the current working directory.
+     * @returns The absolute path to the project root, or null if not found.
+     */
+    static findProjectRoot(startPath = process.cwd()) {
+        // In test environment, allow cache reset via global
+        if (typeof global.projectRoot !== 'undefined' && global.projectRoot === null) {
+            projectRoot = null;
+            lastSearchPath = null;
+        }
+        // Reset cache if we're searching from a different directory
+        if (lastSearchPath && lastSearchPath !== startPath) {
+            projectRoot = null;
+            lastSearchPath = null;
+        }
+        if (projectRoot && lastSearchPath === startPath) {
+            return projectRoot;
+        }
+        // Update last search path
+        lastSearchPath = startPath;
+        let currentPath = startPath;
+        // Prevent infinite loop by stopping at the filesystem root
+        while (currentPath !== path.parse(currentPath).root) {
+            if (existsSync(path.join(currentPath, '.git'))) {
+                projectRoot = currentPath;
+                return projectRoot;
+            }
+            currentPath = path.dirname(currentPath);
+        }
+        // Final check at the root directory
+        if (existsSync(path.join(currentPath, '.git'))) {
+            projectRoot = currentPath;
+            return projectRoot;
+        }
+        return null;
+    }
+    /**
+     * Finds the appropriate project root by searching upwards.
+     * First looks for .gitgov (initialized project), then .git (for init).
+     * @param startPath The path to start searching from. Defaults to the current working directory.
+     * @returns The absolute path to the project root, or null if not found.
+     */
+    static findGitgovRoot(startPath = process.cwd()) {
+        let currentPath = startPath;
+        // First pass: Look for .gitgov (initialized GitGovernance project)
+        while (currentPath !== path.parse(currentPath).root) {
+            if (existsSync(path.join(currentPath, '.gitgov'))) {
+                return currentPath;
+            }
+            currentPath = path.dirname(currentPath);
+        }
+        // Final check at root for .gitgov
+        if (existsSync(path.join(currentPath, '.gitgov'))) {
+            return currentPath;
+        }
+        // Second pass: Look for .git (for init command)
+        currentPath = startPath;
+        while (currentPath !== path.parse(currentPath).root) {
+            if (existsSync(path.join(currentPath, '.git'))) {
+                return currentPath;
+            }
+            currentPath = path.dirname(currentPath);
+        }
+        // Final check at root for .git
+        if (existsSync(path.join(currentPath, '.git'))) {
+            return currentPath;
+        }
+        return null;
+    }
+    /**
+     * Gets the .gitgov directory path from project root
+     */
+    static getGitgovPath() {
+        const root = ConfigManager.findGitgovRoot();
+        if (!root) {
+            throw new Error("Could not find project root. Make sure you are inside a GitGovernance repository.");
+        }
+        return path.join(root, '.gitgov');
+    }
+    /**
+     * Checks if current directory is a GitGovernance project
+     */
+    static isGitgovProject() {
+        try {
+            const gitgovPath = ConfigManager.getGitgovPath();
+            return existsSync(gitgovPath);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create a ConfigManager instance for the current project
+ */
+export function createConfigManager(projectRoot) {
+    return new ConfigManager(projectRoot);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/config_manager/index.js.map

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