@cleocode/core 2026.3.59 → 2026.3.61

package/dist/cleo.js

@@ -0,0 +1,267 @@
+/**
+ * Cleo — standalone facade for @cleocode/core
+ *
+ * Provides a project-bound API covering all 10 canonical domains:
+ * tasks, sessions, memory, orchestration, lifecycle, release, admin,
+ * check, sticky, and nexus.
+ *
+ * @example
+ * const cleo = await Cleo.init('./my-project');
+ * await cleo.tasks.add({ title: 'Build API', description: 'REST endpoints' });
+ *
+ * @example
+ * // Custom store backend
+ * const cleo = await Cleo.init('./my-project', { store: myCustomAccessor });
+ */
+import path from 'node:path';
+// Admin
+import { exportTasks } from './admin/export.js';
+import { importTasks } from './admin/import.js';
+// Lifecycle
+import { checkGate, completeStage, failGate, getLifecycleHistory, getLifecycleStatus, PIPELINE_STAGES, passGate, resetStage, skipStage, startStage, } from './lifecycle/index.js';
+// Memory
+import { fetchBrainEntries, observeBrain, searchBrainCompact, timelineBrain, } from './memory/brain-retrieval.js';
+import { hybridSearch, searchBrain } from './memory/brain-search.js';
+// Nexus
+import { discoverRelated, searchAcrossProjects } from './nexus/discover.js';
+import { setPermission } from './nexus/permissions.js';
+import { nexusGetProject, nexusInit, nexusList, nexusRegister, nexusSync, nexusSyncAll, nexusUnregister, } from './nexus/registry.js';
+import { getSharingStatus } from './nexus/sharing/index.js';
+// Orchestration
+import { analyzeEpic, buildDependencyGraph, computeEpicStatus, computeProgress, getNextTask, getOrchestratorContext, getReadyTasks, startOrchestration, } from './orchestration/index.js';
+// Reconciliation (sync)
+import { reconcile } from './reconciliation/index.js';
+import { getLinksByProvider, getLinksByTaskId, removeLinksByProvider, } from './reconciliation/link-store.js';
+// Release
+import { bumpVersionFromConfig, calculateNewVersion, commitRelease, prepareRelease, pushRelease, rollbackRelease, tagRelease, } from './release/index.js';
+// Sessions
+import { computeBriefing, computeHandoff, endSession, findSessions, gcSessions, getContextDrift, getDecisionLog, getLastHandoff, listSessions, recordAssumption, recordDecision, resumeSession, sessionStatus, showSession, startSession, suspendSession, } from './sessions/index.js';
+// Sticky
+import { addSticky, archiveSticky, convertStickyToMemory, convertStickyToTask, getSticky, listStickies, purgeSticky, } from './sticky/index.js';
+// Store
+import { getAccessor } from './store/data-accessor.js';
+// Tasks
+import { addTask } from './tasks/add.js';
+import { archiveTasks } from './tasks/archive.js';
+import { completeTask } from './tasks/complete.js';
+import { deleteTask } from './tasks/delete.js';
+import { findTasks } from './tasks/find.js';
+import { listTasks } from './tasks/list.js';
+import { showTask } from './tasks/show.js';
+import { updateTask } from './tasks/update.js';
+// ============================================================================
+// Cleo facade class
+// ============================================================================
+export class Cleo {
+    projectRoot;
+    _store;
+    constructor(projectRoot, store) {
+        this.projectRoot = projectRoot;
+        this._store = store;
+    }
+    static async init(projectRoot, options) {
+        const resolvedRoot = path.resolve(projectRoot);
+        const store = options?.store ?? (await getAccessor(resolvedRoot));
+        return new Cleo(resolvedRoot, store);
+    }
+    static forProject(projectRoot) {
+        return new Cleo(path.resolve(projectRoot), null);
+    }
+    // === Tasks ===
+    get tasks() {
+        const root = this.projectRoot;
+        const store = this._store ?? undefined;
+        return {
+            add: (p) => addTask({
+                title: p.title,
+                description: p.description,
+                parentId: p.parent,
+                priority: p.priority,
+                type: p.type,
+                size: p.size,
+                phase: p.phase,
+                labels: p.labels,
+                depends: p.depends,
+                notes: p.notes,
+            }, root, store),
+            find: (p) => findTasks({ query: p.query, id: p.id, status: p.status, limit: p.limit }, root, store),
+            show: (taskId) => showTask(taskId, root, store),
+            list: (p) => listTasks({
+                status: p?.status,
+                priority: p?.priority,
+                parentId: p?.parentId,
+                phase: p?.phase,
+                limit: p?.limit,
+            }, root, store),
+            update: (p) => updateTask({
+                taskId: p.taskId,
+                title: p.title,
+                status: p.status,
+                priority: p.priority,
+                description: p.description,
+                notes: p.notes,
+            }, root, store),
+            complete: (p) => completeTask({ taskId: p.taskId, notes: p.notes }, root, store),
+            delete: (p) => deleteTask({ taskId: p.taskId, force: p.force }, root, store),
+            archive: (p) => archiveTasks({ before: p?.before, taskIds: p?.taskIds, dryRun: p?.dryRun }, root, store),
+        };
+    }
+    // === Sessions ===
+    get sessions() {
+        const root = this.projectRoot;
+        const store = this._store ?? undefined;
+        return {
+            start: (p) => startSession({ name: p.name, scope: p.scope, agent: p.agent }, root, store),
+            end: (p) => endSession({ note: p?.note }, root, store),
+            status: () => sessionStatus(root, store),
+            resume: (id) => resumeSession(id, root, store),
+            list: (p) => listSessions({ status: p?.status, limit: p?.limit }, root, store),
+            find: async (p) => findSessions(store ?? (await getAccessor(root)), {
+                status: p?.status,
+                scope: p?.scope,
+                query: p?.query,
+                limit: p?.limit,
+            }),
+            show: (id) => showSession(root, id),
+            suspend: (id, reason) => suspendSession(root, id, reason),
+            briefing: (p) => computeBriefing(root, { maxNextTasks: p?.maxNextTasks, scope: p?.scope }),
+            handoff: (id, opts) => computeHandoff(root, { sessionId: id, note: opts?.note, nextAction: opts?.nextAction }),
+            gc: (hours) => gcSessions(hours, root, store),
+            recordDecision: (p) => recordDecision(root, p),
+            recordAssumption: (p) => recordAssumption(root, p),
+            contextDrift: (p) => getContextDrift(root, p),
+            decisionLog: (p) => getDecisionLog(root, { sessionId: p?.sessionId, taskId: p?.taskId }),
+            lastHandoff: (scope) => getLastHandoff(root, scope),
+        };
+    }
+    // === Memory ===
+    get memory() {
+        const root = this.projectRoot;
+        return {
+            observe: (p) => observeBrain(root, { text: p.text, title: p.title, type: p.type }),
+            find: (p) => searchBrainCompact(root, { query: p.query, limit: p.limit, tables: p.tables }),
+            fetch: (p) => fetchBrainEntries(root, { ids: p.ids }),
+            timeline: (p) => timelineBrain(root, {
+                anchor: p.anchor,
+                depthBefore: p.depthBefore,
+                depthAfter: p.depthAfter,
+            }),
+            search: (query, opts) => searchBrain(root, query, { limit: opts?.limit }),
+            hybridSearch: (query, opts) => hybridSearch(query, root, opts),
+        };
+    }
+    // === Orchestration ===
+    get orchestration() {
+        const root = this.projectRoot;
+        const store = this._store ?? undefined;
+        return {
+            start: (epicId) => startOrchestration(epicId, root, store),
+            analyze: (epicId) => analyzeEpic(epicId, root, store),
+            readyTasks: (epicId) => getReadyTasks(epicId, root, store),
+            nextTask: (epicId) => getNextTask(epicId, root, store),
+            context: (epicId) => getOrchestratorContext(epicId, root, store),
+            dependencyGraph: (t) => buildDependencyGraph(t),
+            epicStatus: (id, title, children) => computeEpicStatus(id, title, children),
+            progress: (t) => computeProgress(t),
+        };
+    }
+    // === Lifecycle ===
+    get lifecycle() {
+        const root = this.projectRoot;
+        return {
+            status: (epicId) => getLifecycleStatus(epicId, root),
+            startStage: (epicId, stage) => startStage(epicId, stage, root),
+            completeStage: (epicId, stage, artifacts) => completeStage(epicId, stage, artifacts, root),
+            skipStage: (epicId, stage, reason) => skipStage(epicId, stage, reason, root),
+            checkGate: (epicId, target) => checkGate(epicId, target, root),
+            history: (epicId) => getLifecycleHistory(epicId, root),
+            resetStage: (epicId, stage, reason) => resetStage(epicId, stage, reason, root),
+            passGate: (epicId, gate, agent) => passGate(epicId, gate, agent, undefined, root),
+            failGate: (epicId, gate, reason) => failGate(epicId, gate, reason, root),
+            stages: PIPELINE_STAGES,
+        };
+    }
+    // === Release ===
+    get release() {
+        const root = this.projectRoot;
+        return {
+            prepare: (p) => prepareRelease(p.version, p.tasks, p.notes, async () => [], root),
+            commit: (p) => commitRelease(p.version, root),
+            tag: (p) => tagRelease(p.version, root),
+            push: (p) => pushRelease(p.version, p.remote, root, { explicitPush: p.explicitPush }),
+            rollback: (p) => rollbackRelease(p.version, p.reason, root),
+            calculateVersion: (cur, bump) => calculateNewVersion(cur, bump),
+            bumpVersion: async () => bumpVersionFromConfig(root),
+        };
+    }
+    // === Admin ===
+    get admin() {
+        const root = this.projectRoot;
+        return {
+            export: (p) => exportTasks({ cwd: root, ...p }),
+            import: (p) => importTasks({ ...p, cwd: root }),
+        };
+    }
+    // === Sticky ===
+    get sticky() {
+        const root = this.projectRoot;
+        return {
+            add: (p) => addSticky({
+                content: p.content,
+                tags: p.tags,
+                priority: p.priority,
+                color: p.color,
+            }, root),
+            show: (id) => getSticky(id, root),
+            list: (p) => listStickies({
+                status: p?.status,
+                color: p?.color,
+                priority: p?.priority,
+                limit: p?.limit,
+            }, root),
+            archive: (id) => archiveSticky(id, root),
+            purge: (id) => purgeSticky(id, root),
+            convert: (p) => {
+                if (p.targetType === 'task')
+                    return convertStickyToTask(p.stickyId, p.title, root);
+                if (p.targetType === 'memory')
+                    return convertStickyToMemory(p.stickyId, p.memoryType, root);
+                return convertStickyToTask(p.stickyId, p.title, root);
+            },
+        };
+    }
+    // === Nexus ===
+    get nexus() {
+        return {
+            init: () => nexusInit(),
+            register: (p) => nexusRegister(p.path, p.name, p.permissions),
+            unregister: (p) => nexusUnregister(p.name),
+            list: () => nexusList(),
+            show: (p) => nexusGetProject(p.name),
+            sync: (p) => (p?.name ? nexusSync(p.name) : nexusSyncAll()),
+            discover: (p) => discoverRelated(p.query, p.method, p.limit),
+            search: (p) => searchAcrossProjects(p.pattern, p.project, p.limit),
+            setPermission: (p) => setPermission(p.name, p.level),
+            sharingStatus: () => getSharingStatus(),
+        };
+    }
+    // === Sync (Task Reconciliation) ===
+    get sync() {
+        const root = this.projectRoot;
+        const store = this._store ?? undefined;
+        return {
+            reconcile: (p) => reconcile(p.externalTasks, {
+                providerId: p.providerId,
+                cwd: root,
+                dryRun: p.dryRun,
+                conflictPolicy: p.conflictPolicy,
+                defaultPhase: p.defaultPhase,
+                defaultLabels: p.defaultLabels,
+            }, store),
+            getLinks: (providerId) => getLinksByProvider(providerId, root),
+            getTaskLinks: (taskId) => getLinksByTaskId(taskId, root),
+            removeProviderLinks: (providerId) => removeLinksByProvider(providerId, root),
+        };
+    }
+}
+//# sourceMappingURL=cleo.js.map

package/dist/cleo.js.map

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

package/dist/codebase-map/analyzers/architecture.js

@@ -0,0 +1,130 @@
+/**
+ * Architecture analyzer — detects layers, entry points, and architectural patterns.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const LAYER_PURPOSE = {
+    core: 'Core business logic',
+    domain: 'Domain models and logic',
+    api: 'API layer',
+    routes: 'HTTP route handlers',
+    controllers: 'Request controllers',
+    services: 'Service layer',
+    repositories: 'Data access layer',
+    models: 'Data models',
+    store: 'State management / data store',
+    middleware: 'Middleware layer',
+    utils: 'Utility functions',
+    helpers: 'Helper functions',
+    lib: 'Library code',
+    shared: 'Shared modules',
+    common: 'Common utilities',
+    components: 'UI components',
+    pages: 'Page components',
+    views: 'View layer',
+    hooks: 'React hooks',
+    composables: 'Vue composables',
+    cli: 'CLI interface',
+    mcp: 'MCP server layer',
+    dispatch: 'Dispatch / routing layer',
+    types: 'Type definitions',
+    schemas: 'Schema definitions',
+    validation: 'Validation logic',
+    config: 'Configuration',
+    adapters: 'External adapters',
+    providers: 'Service providers',
+    plugins: 'Plugin system',
+    migrations: 'Database migrations',
+    fixtures: 'Test fixtures',
+};
+const ENTRY_POINT_NAMES = new Set([
+    'index.ts',
+    'index.js',
+    'index.mts',
+    'index.mjs',
+    'main.ts',
+    'main.js',
+    'app.ts',
+    'app.js',
+    'server.ts',
+    'server.js',
+    'cli.ts',
+    'cli.js',
+    'worker.ts',
+    'worker.js',
+]);
+const ARCH_PATTERNS = {
+    layered: ['core', 'services', 'repositories', 'controllers'],
+    mvc: ['models', 'views', 'controllers'],
+    modular: ['modules'],
+    'clean-architecture': ['domain', 'application', 'infrastructure'],
+    'dispatch-first': ['dispatch', 'core', 'mcp', 'cli'],
+    'component-based': ['components', 'pages'],
+};
+export function analyzeArchitecture(projectRoot, _projectContext) {
+    const layers = [];
+    const entryPoints = [];
+    const patterns = [];
+    // Scan src/ directory for layers
+    const srcPath = join(projectRoot, 'src');
+    if (existsSync(srcPath)) {
+        try {
+            const entries = readdirSync(srcPath);
+            for (const entry of entries) {
+                const entryPath = join(srcPath, entry);
+                try {
+                    const stat = statSync(entryPath);
+                    if (stat.isDirectory()) {
+                        const purpose = LAYER_PURPOSE[entry.toLowerCase()] ?? `${entry} layer`;
+                        layers.push({ name: entry, path: `src/${entry}`, purpose });
+                    }
+                    else if (ENTRY_POINT_NAMES.has(entry)) {
+                        entryPoints.push({ path: `src/${entry}`, type: inferEntryType(entry) });
+                    }
+                }
+                catch {
+                    // ignore stat errors
+                }
+            }
+        }
+        catch {
+            // ignore readdir errors
+        }
+    }
+    // Also scan root for entry points
+    const rootEntries = safeReaddir(projectRoot);
+    for (const entry of rootEntries) {
+        if (ENTRY_POINT_NAMES.has(entry) && !entryPoints.some((ep) => ep.path === entry)) {
+            entryPoints.push({ path: entry, type: inferEntryType(entry) });
+        }
+    }
+    // Detect architectural patterns from layer names
+    const layerNames = new Set(layers.map((l) => l.name.toLowerCase()));
+    for (const [pattern, requiredDirs] of Object.entries(ARCH_PATTERNS)) {
+        const matchCount = requiredDirs.filter((d) => layerNames.has(d)).length;
+        if (matchCount >= 2) {
+            patterns.push(pattern);
+        }
+    }
+    return { layers, entryPoints, patterns };
+}
+function inferEntryType(filename) {
+    if (filename.startsWith('cli'))
+        return 'cli';
+    if (filename.startsWith('server'))
+        return 'server';
+    if (filename.startsWith('worker'))
+        return 'worker';
+    if (filename.startsWith('app'))
+        return 'application';
+    return 'module';
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=architecture.js.map

package/dist/codebase-map/analyzers/architecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.js","sourceRoot":"","sources":["../../../src/codebase-map/analyzers/architecture.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,aAAa,GAA2B;IAC5C,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,yBAAyB;IACjC,GAAG,EAAE,WAAW;IAChB,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EAAE,qBAAqB;IAClC,QAAQ,EAAE,eAAe;IACzB,YAAY,EAAE,mBAAmB;IACjC,MAAM,EAAE,aAAa;IACrB,KAAK,EAAE,+BAA+B;IACtC,UAAU,EAAE,kBAAkB;IAC9B,KAAK,EAAE,mBAAmB;IAC1B,OAAO,EAAE,kBAAkB;IAC3B,GAAG,EAAE,cAAc;IACnB,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,kBAAkB;IAC1B,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,iBAAiB;IAC9B,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,kBAAkB;IACvB,QAAQ,EAAE,0BAA0B;IACpC,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,oBAAoB;IAC7B,UAAU,EAAE,kBAAkB;IAC9B,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,mBAAmB;IAC9B,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,qBAAqB;IACjC,QAAQ,EAAE,eAAe;CAC1B,CAAC;AAEF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,aAAa,GAA6B;IAC9C,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,CAAC;IAC5D,GAAG,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC;IACvC,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,oBAAoB,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,gBAAgB,CAAC;IACjE,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;IACpD,iBAAiB,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,eAA+B;IAE/B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAgC,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,iCAAiC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;oBACjC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;wBACvB,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,KAAK,QAAQ,CAAC;wBACvE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC9D,CAAC;yBAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,qBAAqB;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACjF,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACpE,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACxE,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/codebase-map/analyzers/concerns.js

@@ -0,0 +1,122 @@
+/**
+ * Concerns analyzer — scans for TODO/FIXME comments, large files, and complexity estimates.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const EXCLUDED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'coverage',
+    '.cleo',
+    '.next',
+    '.nuxt',
+    '__pycache__',
+    'target',
+    'vendor',
+]);
+const SOURCE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mts',
+    '.mjs',
+    '.py',
+    '.rs',
+    '.go',
+    '.rb',
+    '.java',
+    '.php',
+    '.cs',
+]);
+const TODO_PATTERN = /\b(TODO|FIXME|HACK|XXX)\b[:\s]*(.*)/g;
+export function analyzeConcerns(projectRoot) {
+    const todos = [];
+    const largeFiles = [];
+    const complexity = { high: 0, medium: 0, low: 0 };
+    const srcPath = join(projectRoot, 'src');
+    const scanRoot = existsSync(srcPath) ? srcPath : projectRoot;
+    walkSourceFiles(scanRoot, projectRoot, (filePath, relPath) => {
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const lines = content.split('\n');
+            const lineCount = lines.length;
+            // Categorize by complexity (line count)
+            if (lineCount > 500) {
+                complexity.high++;
+                largeFiles.push({ path: relPath, lines: lineCount });
+            }
+            else if (lineCount > 200) {
+                complexity.medium++;
+            }
+            else {
+                complexity.low++;
+            }
+            // Scan for TODO/FIXME (limit to first 50 total)
+            if (todos.length < 50) {
+                lines.forEach((line, idx) => {
+                    if (todos.length >= 50)
+                        return;
+                    const matches = [...line.matchAll(TODO_PATTERN)];
+                    for (const match of matches) {
+                        if (todos.length >= 50)
+                            break;
+                        todos.push({
+                            file: relPath,
+                            line: idx + 1,
+                            text: `${match[1]}: ${match[2].trim()}`.trim(),
+                        });
+                    }
+                });
+            }
+        }
+        catch {
+            // ignore unreadable files
+        }
+    });
+    // Sort large files by line count descending
+    largeFiles.sort((a, b) => b.lines - a.lines);
+    return { todos, largeFiles, complexity };
+}
+function walkSourceFiles(dir, projectRoot, callback, depth = 0) {
+    if (depth > 8)
+        return;
+    try {
+        const entries = readdirSync(dir);
+        for (const entry of entries) {
+            if (EXCLUDED_DIRS.has(entry) || entry.startsWith('.'))
+                continue;
+            const fullPath = join(dir, entry);
+            try {
+                const stat = statSync(fullPath);
+                if (stat.isDirectory()) {
+                    walkSourceFiles(fullPath, projectRoot, callback, depth + 1);
+                }
+                else {
+                    const ext = entry.slice(entry.lastIndexOf('.'));
+                    if (SOURCE_EXTENSIONS.has(ext)) {
+                        // Skip test files for concern analysis
+                        if (entry.endsWith('.test.ts') ||
+                            entry.endsWith('.spec.ts') ||
+                            entry.endsWith('.test.js') ||
+                            entry.endsWith('.spec.js'))
+                            continue;
+                        const relPath = fullPath.startsWith(projectRoot)
+                            ? fullPath.slice(projectRoot.length + 1)
+                            : fullPath;
+                        callback(fullPath, relPath);
+                    }
+                }
+            }
+            catch {
+                // ignore stat errors
+            }
+        }
+    }
+    catch {
+        // ignore readdir errors
+    }
+}
+//# sourceMappingURL=concerns.js.map

package/dist/codebase-map/analyzers/concerns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concerns.js","sourceRoot":"","sources":["../../../src/codebase-map/analyzers/concerns.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,cAAc;IACd,MAAM;IACN,MAAM;IACN,OAAO;IACP,UAAU;IACV,OAAO;IACP,OAAO;IACP,OAAO;IACP,aAAa;IACb,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,KAAK;CACN,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,sCAAsC,CAAC;AAE5D,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAkC,EAAE,CAAC;IACrD,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAElD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;IAE7D,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;YAE/B,wCAAwC;YACxC,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;gBACpB,UAAU,CAAC,IAAI,EAAE,CAAC;gBAClB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;gBAC3B,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YAED,gDAAgD;YAChD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACtB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;oBAC1B,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE;wBAAE,OAAO;oBAC/B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;oBACjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;wBAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE;4BAAE,MAAM;wBAC9B,KAAK,CAAC,IAAI,CAAC;4BACT,IAAI,EAAE,OAAO;4BACb,IAAI,EAAE,GAAG,GAAG,CAAC;4BACb,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;yBAC/C,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE7C,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,eAAe,CACtB,GAAW,EACX,WAAmB,EACnB,QAAqD,EACrD,QAAgB,CAAC;IAEjB,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAChC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;oBAChD,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC/B,uCAAuC;wBACvC,IACE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;4BAC1B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;4BAC1B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;4BAC1B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;4BAE1B,SAAS;wBACX,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;4BAC9C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;4BACxC,CAAC,CAAC,QAAQ,CAAC;wBACb,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC"}