@aquex/cmos-mcp 1.0.0

package/dist/intelligence/credential-store.js

@@ -0,0 +1,243 @@
+"use strict";
+// ABOUTME: CredentialStore — local persistence for dashboard credentials minted via the RFC 8628 device code flow.
+// ABOUTME: Shape mirrors dashboard's user-scoped/project-scoped split so m02/m03 can key project keys to their spawning user key.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialStore = exports.DEFAULT_CREDENTIALS_FILENAME = exports.CMOS_CONFIG_DIR_ENV = void 0;
+/**
+ * Local credential store for cmos-dashboard API keys.
+ *
+ * Sprint 57 m01 — replaces Sprint 56 m04's `project-keys.json` paste flow.
+ * The store is populated by the device code flow (user-scoped keys) and,
+ * once m02 lands, by POST /api/projects/register response capture
+ * (project-scoped keys bound to their parent user-scoped key via
+ * `parentKeyId`).
+ *
+ * File: `<configDir>/credentials.json` where `configDir` defaults to
+ * `~/.config/cmos-mcp` and can be overridden by the `CMOS_CONFIG_DIR`
+ * environment variable (same override the ProjectRegistry uses for test
+ * isolation).
+ *
+ * @module intelligence/credential-store
+ */
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const fs_2 = require("../utils/fs");
+/** Same CMOS_CONFIG_DIR env var used by ProjectRegistry — single source of truth. */
+exports.CMOS_CONFIG_DIR_ENV = 'CMOS_CONFIG_DIR';
+/** Default on-disk filename. */
+exports.DEFAULT_CREDENTIALS_FILENAME = 'credentials.json';
+const CURRENT_VERSION = 1;
+function emptyStore() {
+    return {
+        version: CURRENT_VERSION,
+        userScopedKeys: {},
+        projectKeys: {},
+        updatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * CredentialStore — thin JSON-backed persistence with atomic writes and
+ * 0600 file permissions. Singleton by default so callers share cache;
+ * tests that need isolation can construct an explicit instance with a
+ * temp `configDir`.
+ */
+class CredentialStore {
+    constructor(options = {}) {
+        this.cache = null;
+        this.configDir =
+            options.configDir ??
+                process.env[exports.CMOS_CONFIG_DIR_ENV] ??
+                path_1.default.join(os_1.default.homedir(), '.config', 'cmos-mcp');
+        const filename = options.credentialsFilename ?? exports.DEFAULT_CREDENTIALS_FILENAME;
+        this.credentialsPath = path_1.default.join(this.configDir, filename);
+    }
+    /** Singleton — one store per process by default. */
+    static getInstance(options) {
+        if (!CredentialStore.instance) {
+            CredentialStore.instance = new CredentialStore(options);
+        }
+        return CredentialStore.instance;
+    }
+    /** Reset singleton (tests only). */
+    static resetInstance() {
+        CredentialStore.instance = undefined;
+    }
+    /** Async factory — ensures the config directory exists before any read/write. */
+    static async create(options) {
+        const store = CredentialStore.getInstance(options);
+        await (0, fs_2.ensureDir)(store.configDir);
+        return store;
+    }
+    /** Absolute path to the credentials file. */
+    get path() {
+        return this.credentialsPath;
+    }
+    /** Drop in-memory cache; next read re-reads from disk. */
+    clearCache() {
+        this.cache = null;
+    }
+    /**
+     * Insert or replace a user-scoped key keyed by `keyId`.
+     * Later device-code exchanges on the same device can overwrite prior rows.
+     */
+    async upsertUserScopedKey(keyId, record) {
+        if (!keyId) {
+            throw new Error('upsertUserScopedKey: keyId is required');
+        }
+        const store = await this.load();
+        store.userScopedKeys[keyId] = record;
+        await this.save(store);
+    }
+    /** Return a user-scoped key record by `keyId`, or `undefined` if absent. */
+    async getUserScopedKey(keyId) {
+        const store = await this.load();
+        return store.userScopedKeys[keyId];
+    }
+    /**
+     * Return all user-scoped keys. Keyed by `keyId`; values are records.
+     * Used by `fromEnvForProject()` fallback + m03's `cmos_auth(action=list)`.
+     */
+    async listUserScopedKeys() {
+        const store = await this.load();
+        return { ...store.userScopedKeys };
+    }
+    /**
+     * Insert or replace a project-scoped key keyed by absolute `projectRoot`.
+     * The caller supplies `parentKeyId` — the user-scoped keyId that authenticated
+     * the register (or reissue) call, so m03's `cmos_auth(action=list)` can filter
+     * "mine-only" keys by matching against the local `userScopedKeys` map.
+     */
+    async upsertProjectKey(projectRoot, record) {
+        if (!projectRoot) {
+            throw new Error('upsertProjectKey: projectRoot is required');
+        }
+        const store = await this.load();
+        store.projectKeys[path_1.default.resolve(projectRoot)] = record;
+        await this.save(store);
+    }
+    /**
+     * Return the project-scoped key for a project root, or `undefined`.
+     * Project roots are normalized via `path.resolve` before lookup so
+     * callers don't have to worry about trailing slashes or cwd-relative paths.
+     */
+    async getProjectKey(projectRoot) {
+        if (!projectRoot)
+            return undefined;
+        const store = await this.load();
+        return store.projectKeys[path_1.default.resolve(projectRoot)];
+    }
+    /**
+     * Return all project-scoped keys keyed by absolute `projectRoot`.
+     * Used by m03's `cmos_auth(action=list)` and by the m02 startup recovery
+     * hook to detect "registered in dashboard but missing locally" projects.
+     */
+    async listProjectKeys() {
+        const store = await this.load();
+        return { ...store.projectKeys };
+    }
+    /**
+     * Remove a user-scoped key by `keyId`. No-op when the key isn't present.
+     * Sprint 57 m03 — used by `cmos_auth(action=revoke)` for user-scoped keys.
+     */
+    async removeUserScopedKey(keyId) {
+        if (!keyId)
+            return;
+        const store = await this.load();
+        if (store.userScopedKeys[keyId]) {
+            delete store.userScopedKeys[keyId];
+            await this.save(store);
+        }
+    }
+    /**
+     * Remove a project-scoped key by `projectRoot`. No-op when the key isn't
+     * present. Sprint 57 m03 — used by `cmos_auth(action=revoke)`.
+     */
+    async removeProjectKey(projectRoot) {
+        if (!projectRoot)
+            return;
+        const store = await this.load();
+        const resolved = path_1.default.resolve(projectRoot);
+        if (store.projectKeys[resolved]) {
+            delete store.projectKeys[resolved];
+            await this.save(store);
+        }
+    }
+    /**
+     * Swap the project key at `projectRoot`, keeping the outgoing key in the
+     * new record's `pendingRevoke` slot so in-flight requests survive the
+     * `graceSeconds` window before dashboard revokes the old key.
+     *
+     * Sprint 57 m03 — called atomically from `cmos_auth(action=rotate)` so
+     * readers never observe a split (old gone, new not yet written) state.
+     */
+    async swapProjectKey(projectRoot, next, pendingRevoke) {
+        if (!projectRoot) {
+            throw new Error('swapProjectKey: projectRoot is required');
+        }
+        const store = await this.load();
+        store.projectKeys[path_1.default.resolve(projectRoot)] = { ...next, pendingRevoke };
+        await this.save(store);
+    }
+    /**
+     * Drop a `pendingRevoke` slot once `revokeAt` has passed. Caller supplies
+     * the decision (usually after the dashboard has revoked the old key).
+     */
+    async clearPendingRevoke(projectRoot) {
+        if (!projectRoot)
+            return;
+        const store = await this.load();
+        const resolved = path_1.default.resolve(projectRoot);
+        const existing = store.projectKeys[resolved];
+        if (existing && existing.pendingRevoke) {
+            const { pendingRevoke: _drop, ...rest } = existing;
+            void _drop;
+            store.projectKeys[resolved] = rest;
+            await this.save(store);
+        }
+    }
+    async load() {
+        if (this.cache)
+            return this.cache;
+        try {
+            const exists = await (0, fs_2.pathExists)(this.credentialsPath);
+            if (!exists) {
+                this.cache = emptyStore();
+                return this.cache;
+            }
+            const raw = await fs_1.promises.readFile(this.credentialsPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (!parsed ||
+                typeof parsed !== 'object' ||
+                typeof parsed.version !== 'number' ||
+                !parsed.userScopedKeys ||
+                !parsed.projectKeys) {
+                this.cache = emptyStore();
+                return this.cache;
+            }
+            this.cache = {
+                version: parsed.version,
+                userScopedKeys: parsed.userScopedKeys,
+                projectKeys: parsed.projectKeys,
+                updatedAt: parsed.updatedAt ?? new Date().toISOString(),
+            };
+            return this.cache;
+        }
+        catch {
+            this.cache = emptyStore();
+            return this.cache;
+        }
+    }
+    async save(store) {
+        store.updatedAt = new Date().toISOString();
+        this.cache = store;
+        await (0, fs_2.ensureDir)(this.configDir);
+        const content = JSON.stringify(store, null, 2);
+        await (0, fs_2.writeFileAtomic)(this.credentialsPath, content, { mode: 0o600 });
+    }
+}
+exports.CredentialStore = CredentialStore;
+//# sourceMappingURL=credential-store.js.map

package/dist/intelligence/credential-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../../src/intelligence/credential-store.ts"],"names":[],"mappings":";AAAA,mHAAmH;AACnH,kIAAkI;;;;;;AAElI;;;;;;;;;;;;;;;GAeG;AAEH,4CAAoB;AACpB,gDAAwB;AACxB,2BAAoC;AACpC,oCAAqE;AAErE,qFAAqF;AACxE,QAAA,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,gCAAgC;AACnB,QAAA,4BAA4B,GAAG,kBAAkB,CAAC;AAyE/D,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,UAAU;IACjB,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAa,eAAe;IAO1B,YAAoB,UAAkC,EAAE;QAFhD,UAAK,GAA+B,IAAI,CAAC;QAG/C,IAAI,CAAC,SAAS;YACZ,OAAO,CAAC,SAAS;gBACjB,OAAO,CAAC,GAAG,CAAC,2BAAmB,CAAC;gBAChC,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,IAAI,oCAA4B,CAAC;QAC7E,IAAI,CAAC,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,WAAW,CAAC,OAAgC;QACjD,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAC9B,eAAe,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,eAAe,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,aAAa;QAClB,eAAe,CAAC,QAAQ,GAAG,SAAS,CAAC;IACvC,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAgC;QAClD,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,IAAA,cAAS,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6CAA6C;IAC7C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,0DAA0D;IAC1D,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa,EAAE,MAA2B;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,gBAAgB,CAAC,KAAa;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,WAAmB,EAAE,MAAwB;QAClE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,WAAW,CAAC,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC;QACtD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,IAAI,CAAC,WAAW;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,WAAW,CAAC,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QACxC,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,IAAsB,EACtB,aAAkC;QAElC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,WAAW,CAAC,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,CAAC;QAC1E,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,WAAmB;QAC1C,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,QAAQ,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;YACvC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;YACnD,KAAK,KAAK,CAAC;YACX,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;YACnC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,eAAU,EAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,GAAG,UAAU,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAC;YAC/D,IACE,CAAC,MAAM;gBACP,OAAO,MAAM,KAAK,QAAQ;gBAC1B,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;gBAClC,CAAC,MAAM,CAAC,cAAc;gBACtB,CAAC,MAAM,CAAC,WAAW,EACnB,CAAC;gBACD,IAAI,CAAC,KAAK,GAAG,UAAU,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,KAAK,CAAC;YACpB,CAAC;YACD,IAAI,CAAC,KAAK,GAAG;gBACX,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,cAAc,EAAE,MAAM,CAAC,cAAqD;gBAC5E,WAAW,EAAE,MAAM,CAAC,WAA+C;gBACnE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACxD,CAAC;YACF,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,UAAU,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAA0B;QAC3C,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,IAAA,cAAS,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,MAAM,IAAA,oBAAe,EAAC,IAAI,CAAC,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;CACF;AAxND,0CAwNC"}

package/dist/intelligence/dependency-analyzer.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Represents a node in the dependency graph
+ */
+export interface DependencyNode {
+    missionId: string;
+    filePath: string;
+    dependencies: string[];
+    implicitDependencies?: string[];
+}
+/**
+ * Represents a dependency graph
+ */
+export interface DependencyGraph {
+    nodes: Map<string, DependencyNode>;
+    edges: Map<string, Set<string>>;
+}
+/**
+ * Result of dependency analysis
+ */
+export interface DependencyAnalysisResult {
+    graph: DependencyGraph;
+    hasCycles: boolean;
+    cycles?: string[][];
+    executionOrder?: string[];
+    criticalPath?: string[];
+}
+interface ResearchFoundationEntry {
+    sourceMission?: string;
+}
+interface MissionBlocker {
+    missionId?: string;
+}
+interface MissionHandoffContext {
+    dependencies?: string[];
+    blockers?: MissionBlocker[];
+}
+export interface MissionDomainFields extends Record<string, unknown> {
+    researchFoundation?: ResearchFoundationEntry[];
+    handoffContext?: MissionHandoffContext;
+}
+export interface MissionRecord extends Record<string, unknown> {
+    missionId: string;
+    filePath?: string;
+    context?: string;
+    objective?: string;
+    successCriteria?: string[] | string;
+    deliverables?: string[] | string;
+    domainFields?: MissionDomainFields;
+}
+export type MissionInput = string | MissionRecord;
+export declare function isMissionRecord(value: unknown): value is MissionRecord;
+/**
+ * DependencyAnalyzer - Analyzes mission dependencies using graph-based analysis
+ * Based on research findings from R4.3_Intelligent_Mission_Sequencing
+ */
+export declare class DependencyAnalyzer {
+    private graph;
+    constructor();
+    /**
+     * Analyze dependencies for a set of missions
+     * @param missions Array of mission file paths or mission objects
+     * @returns DependencyAnalysisResult
+     */
+    analyze(missions: MissionInput[]): Promise<DependencyAnalysisResult>;
+    /**
+     * Build dependency graph from missions
+     * @param missions Array of mission file paths or mission objects
+     */
+    private buildGraph;
+    private normalizeMissionInput;
+    /**
+     * Extract explicit dependencies from mission data
+     * Uses static analysis of mission configuration
+     */
+    private extractExplicitDependencies;
+    /**
+     * Extract mission ID from a mission reference string
+     * Handles formats like "R4.3_Intelligent_Mission_Sequencing" or "<R4.3_Intelligent_Mission_Sequencing>"
+     * Also handles simple IDs like "A", "B" for test cases
+     */
+    private extractMissionId;
+    /**
+     * Extract mission references from text using simple pattern matching
+     * This is a basic implementation - could be enhanced with NLP
+     */
+    private extractMissionReferencesFromText;
+    /**
+     * Detect cycles in the dependency graph using DFS with back-edge detection
+     * Based on R4.3 research: "Implement DFS-based cycle detection with back-edge identification"
+     */
+    private detectCycles;
+    /**
+     * Extract the cycle path when a back edge is detected
+     */
+    private extractCycle;
+    /**
+     * Perform topological sort using Kahn's algorithm (BFS-based)
+     * Based on R4.3 research: "Use Kahn's algorithm for parallel execution identification"
+     *
+     * Note: In our graph, edge from A->B means A depends on B (B must execute before A)
+     */
+    private topologicalSort;
+    /**
+     * Find the critical path in the dependency graph
+     * Based on R4.3 research: "Critical Path Method (CPM) for identifying temporal bottlenecks"
+     * Simplified implementation assuming uniform task duration
+     *
+     * Critical path is the longest path from any root node to any leaf node
+     */
+    private findCriticalPath;
+    /**
+     * Get the current dependency graph
+     */
+    getGraph(): DependencyGraph;
+}
+export {};
+//# sourceMappingURL=dependency-analyzer.d.ts.map

package/dist/intelligence/dependency-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-analyzer.d.ts","sourceRoot":"","sources":["../../src/intelligence/dependency-analyzer.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,uBAAuB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC/C,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAElD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAkB;;IAS/B;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgC1E;;;OAGG;YACW,UAAU;YAwBV,qBAAqB;IA2BnC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA6CnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IAqBxC;;;OAGG;IACH,OAAO,CAAC,YAAY;IA6DpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAkDvB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA+DxB;;OAEG;IACH,QAAQ,IAAI,eAAe;CAG5B"}