@s_s/harmonia 1.0.0

package/README.md

@@ -0,0 +1,3 @@
+# harmonia
+
+让不同角色和谐协作

package/build/core/dispatch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Dispatch & Session tracking — manages:
+ *   <data_dir>/<project_name>/sessions.json
+ *   <data_dir>/<project_name>/dispatches.json
+ *
+ * Sessions represent agent instances (can be reused across dispatches).
+ * Dispatches represent individual task assignments to a role.
+ * Relationship: Session 1:N Dispatch (a persistent session can receive multiple dispatches).
+ */
+import type { AgentType, SessionRecord, SessionStatus, DispatchRecord, DispatchStatus } from './types.js';
+export declare function readSessions(projectName: string): Promise<SessionRecord[]>;
+export declare function createSession(projectName: string, role: string, agentType?: AgentType, label?: string): Promise<SessionRecord>;
+export declare function updateSession(projectName: string, sessionId: string, updates: {
+    status?: SessionStatus;
+    agentSessionId?: string;
+    agentType?: AgentType;
+    label?: string;
+}): Promise<SessionRecord>;
+/**
+ * Find an idle session for a given role (for session reuse).
+ * Returns the most recently active idle session, or null if none found.
+ */
+export declare function findIdleSession(projectName: string, role: string): Promise<SessionRecord | null>;
+/**
+ * Find a session by its agent session ID (for correlating external sessions).
+ */
+export declare function findSessionByAgentId(projectName: string, role: string, agentSessionId: string): Promise<SessionRecord | null>;
+export declare function readDispatches(projectName: string): Promise<DispatchRecord[]>;
+export declare function createDispatch(projectName: string, role: string, taskBrief: string, expectedOutputs: string[], sessionId?: string): Promise<DispatchRecord>;
+export declare function updateDispatch(projectName: string, dispatchId: string, updates: {
+    status?: DispatchStatus;
+    sessionId?: string;
+    note?: string;
+}): Promise<DispatchRecord>;
+/**
+ * Get a single dispatch record by ID.
+ */
+export declare function getDispatch(projectName: string, dispatchId: string): Promise<DispatchRecord | null>;

package/build/core/dispatch.js

@@ -0,0 +1,156 @@
+/**
+ * Dispatch & Session tracking — manages:
+ *   <data_dir>/<project_name>/sessions.json
+ *   <data_dir>/<project_name>/dispatches.json
+ *
+ * Sessions represent agent instances (can be reused across dispatches).
+ * Dispatches represent individual task assignments to a role.
+ * Relationship: Session 1:N Dispatch (a persistent session can receive multiple dispatches).
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { getProjectDataDir } from './registry.js';
+const SESSIONS_FILE = 'sessions.json';
+const DISPATCHES_FILE = 'dispatches.json';
+function sessionsPath(projectName) {
+    return join(getProjectDataDir(projectName), SESSIONS_FILE);
+}
+function dispatchesPath(projectName) {
+    return join(getProjectDataDir(projectName), DISPATCHES_FILE);
+}
+// ─── Session CRUD ───
+export async function readSessions(projectName) {
+    try {
+        const content = await readFile(sessionsPath(projectName), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+}
+async function writeSessions(projectName, sessions) {
+    const filePath = sessionsPath(projectName);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(sessions, null, 2) + '\n', 'utf-8');
+}
+function nextSessionId(sessions) {
+    const num = sessions.length + 1;
+    return `ses-${String(num).padStart(3, '0')}`;
+}
+export async function createSession(projectName, role, agentType, label) {
+    const sessions = await readSessions(projectName);
+    const now = new Date().toISOString();
+    const session = {
+        id: nextSessionId(sessions),
+        role,
+        agentType,
+        status: 'active',
+        label,
+        createdAt: now,
+        lastActiveAt: now,
+    };
+    sessions.push(session);
+    await writeSessions(projectName, sessions);
+    return session;
+}
+export async function updateSession(projectName, sessionId, updates) {
+    const sessions = await readSessions(projectName);
+    const session = sessions.find((s) => s.id === sessionId);
+    if (!session) {
+        throw new Error(`Session "${sessionId}" not found in project "${projectName}"`);
+    }
+    if (updates.status !== undefined)
+        session.status = updates.status;
+    if (updates.agentSessionId !== undefined)
+        session.agentSessionId = updates.agentSessionId;
+    if (updates.agentType !== undefined)
+        session.agentType = updates.agentType;
+    if (updates.label !== undefined)
+        session.label = updates.label;
+    session.lastActiveAt = new Date().toISOString();
+    await writeSessions(projectName, sessions);
+    return session;
+}
+/**
+ * Find an idle session for a given role (for session reuse).
+ * Returns the most recently active idle session, or null if none found.
+ */
+export async function findIdleSession(projectName, role) {
+    const sessions = await readSessions(projectName);
+    const idle = sessions
+        .filter((s) => s.role === role && s.status === 'idle')
+        .sort((a, b) => b.lastActiveAt.localeCompare(a.lastActiveAt));
+    return idle[0] ?? null;
+}
+/**
+ * Find a session by its agent session ID (for correlating external sessions).
+ */
+export async function findSessionByAgentId(projectName, role, agentSessionId) {
+    const sessions = await readSessions(projectName);
+    return sessions.find((s) => s.role === role && s.agentSessionId === agentSessionId) ?? null;
+}
+// ─── Dispatch CRUD ───
+export async function readDispatches(projectName) {
+    try {
+        const content = await readFile(dispatchesPath(projectName), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+}
+async function writeDispatches(projectName, dispatches) {
+    const filePath = dispatchesPath(projectName);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(dispatches, null, 2) + '\n', 'utf-8');
+}
+function nextDispatchId(dispatches) {
+    const num = dispatches.length + 1;
+    return `dispatch-${String(num).padStart(3, '0')}`;
+}
+export async function createDispatch(projectName, role, taskBrief, expectedOutputs, sessionId) {
+    const dispatches = await readDispatches(projectName);
+    const now = new Date().toISOString();
+    const dispatch = {
+        id: nextDispatchId(dispatches),
+        role,
+        taskBrief,
+        status: 'dispatched',
+        expectedOutputs,
+        createdAt: now,
+        updatedAt: now,
+        ...(sessionId ? { sessionId } : {}),
+    };
+    dispatches.push(dispatch);
+    await writeDispatches(projectName, dispatches);
+    return dispatch;
+}
+export async function updateDispatch(projectName, dispatchId, updates) {
+    const dispatches = await readDispatches(projectName);
+    const dispatch = dispatches.find((d) => d.id === dispatchId);
+    if (!dispatch) {
+        throw new Error(`Dispatch "${dispatchId}" not found in project "${projectName}"`);
+    }
+    const now = new Date().toISOString();
+    if (updates.status !== undefined) {
+        dispatch.status = updates.status;
+        if (updates.status === 'completed' || updates.status === 'failed' || updates.status === 'cancelled') {
+            dispatch.completedAt = now;
+        }
+    }
+    if (updates.sessionId !== undefined)
+        dispatch.sessionId = updates.sessionId;
+    if (updates.note !== undefined)
+        dispatch.note = updates.note;
+    dispatch.updatedAt = now;
+    await writeDispatches(projectName, dispatches);
+    return dispatch;
+}
+/**
+ * Get a single dispatch record by ID.
+ */
+export async function getDispatch(projectName, dispatchId) {
+    const dispatches = await readDispatches(projectName);
+    return dispatches.find((d) => d.id === dispatchId) ?? null;
+}
+//# sourceMappingURL=dispatch.js.map

package/build/core/dispatch.js.map

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

package/build/core/docs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Document management — read/write files under <data_dir>/<project_name>/docs/
+ *
+ * Supports both .md and .html files based on doc format configuration.
+ */
+import type { DocDefinition } from './types.js';
+/**
+ * Write a document to <data_dir>/<project_name>/docs/<docId>.<ext>
+ */
+export declare function writeDoc(projectName: string, docId: string, content: string, docDef?: DocDefinition): Promise<string>;
+/**
+ * Read a document from <data_dir>/<project_name>/docs/<docId>.<ext>
+ * Tries both .md and .html extensions.
+ */
+export declare function readDoc(projectName: string, docId: string): Promise<string>;
+/**
+ * List all documents in <data_dir>/<project_name>/docs/
+ */
+export declare function listDocs(projectName: string): Promise<string[]>;

package/build/core/docs.js

@@ -0,0 +1,59 @@
+/**
+ * Document management — read/write files under <data_dir>/<project_name>/docs/
+ *
+ * Supports both .md and .html files based on doc format configuration.
+ */
+import { mkdir, readFile, writeFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getProjectDataDir } from './registry.js';
+function docsDir(projectName) {
+    return join(getProjectDataDir(projectName), 'docs');
+}
+/**
+ * Get file extension for a doc based on its definition.
+ */
+function getDocExtension(docDef) {
+    return docDef?.format === 'html' ? '.html' : '.md';
+}
+/**
+ * Write a document to <data_dir>/<project_name>/docs/<docId>.<ext>
+ */
+export async function writeDoc(projectName, docId, content, docDef) {
+    const dir = docsDir(projectName);
+    await mkdir(dir, { recursive: true });
+    const ext = getDocExtension(docDef);
+    const filePath = join(dir, `${docId}${ext}`);
+    await writeFile(filePath, content, 'utf-8');
+    return filePath;
+}
+/**
+ * Read a document from <data_dir>/<project_name>/docs/<docId>.<ext>
+ * Tries both .md and .html extensions.
+ */
+export async function readDoc(projectName, docId) {
+    const dir = docsDir(projectName);
+    // Try .md first, then .html
+    for (const ext of ['.md', '.html']) {
+        try {
+            return await readFile(join(dir, `${docId}${ext}`), 'utf-8');
+        }
+        catch {
+            // try next extension
+        }
+    }
+    throw new Error(`Document "${docId}" not found`);
+}
+/**
+ * List all documents in <data_dir>/<project_name>/docs/
+ */
+export async function listDocs(projectName) {
+    const dir = docsDir(projectName);
+    try {
+        const files = await readdir(dir);
+        return files.filter((f) => f.endsWith('.md') || f.endsWith('.html')).map((f) => f.replace(/\.(md|html)$/, ''));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=docs.js.map

package/build/core/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/core/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,SAAS,OAAO,CAAC,WAAmB;IAChC,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAAsB;IAC3C,OAAO,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,WAAmB,EACnB,KAAa,EACb,OAAe,EACf,MAAsB;IAEtB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,KAAa;IAC5D,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjC,4BAA4B;IAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}

package/build/core/overrides.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Override configuration — three-layer merge system.
+ *
+ * Priority: project-level > global-level > workflow defaults
+ *
+ * Files:
+ *   <data_dir>/overrides.json                    (global)
+ *   <data_dir>/<project_name>/overrides.json     (project)
+ */
+import type { CapabilityOverride, DocDefinition, OverrideConfig } from './types.js';
+/**
+ * Read global overrides (<data_dir>/overrides.json).
+ */
+export declare function readGlobalOverrides(): Promise<OverrideConfig>;
+/**
+ * Read project-level overrides (<data_dir>/<project_name>/overrides.json).
+ */
+export declare function readProjectOverrides(projectName: string): Promise<OverrideConfig>;
+/**
+ * Write global overrides.
+ */
+export declare function writeGlobalOverrides(config: OverrideConfig): Promise<void>;
+/**
+ * Write project-level overrides.
+ */
+export declare function writeProjectOverrides(projectName: string, config: OverrideConfig): Promise<void>;
+/**
+ * Get the fully merged override config for a project.
+ * Priority: project > global
+ */
+export declare function getMergedOverrides(projectName: string): Promise<OverrideConfig>;
+/**
+ * Resolve whether a specific doc requires review.
+ *
+ * Priority: project override > global override > workflow default
+ */
+export declare function resolveDocReview(docId: string, docDef: DocDefinition, overrides: OverrideConfig): boolean;
+/**
+ * Resolve the capability override for a specific role + capability.
+ * Returns null if no override is configured.
+ */
+export declare function resolveCapabilityOverride(roleId: string, capabilityId: string, overrides: OverrideConfig): CapabilityOverride | null;
+/**
+ * Set a single role capability override at project or global level.
+ */
+export declare function setCapabilityOverride(scope: 'global' | 'project', projectName: string | null, roleId: string, capabilityId: string, override: CapabilityOverride): Promise<void>;
+/**
+ * Set review override for a specific doc at project or global level.
+ */
+export declare function setReviewOverride(scope: 'global' | 'project', projectName: string | null, docId: string, enabled: boolean): Promise<void>;
+/**
+ * Resolve the agent/model configuration for a role.
+ * Returns { agent, model } from the merged overrides, or undefined fields if not set.
+ */
+export declare function resolveRoleConfig(roleId: string, overrides: OverrideConfig): {
+    agent?: string;
+    model?: string;
+};
+/**
+ * Set agent/model config for a role at project or global level.
+ */
+export declare function setRoleAgentConfig(scope: 'global' | 'project', projectName: string | null, roleId: string, agent?: string, model?: string): Promise<void>;

package/build/core/overrides.js

@@ -0,0 +1,206 @@
+/**
+ * Override configuration — three-layer merge system.
+ *
+ * Priority: project-level > global-level > workflow defaults
+ *
+ * Files:
+ *   <data_dir>/overrides.json                    (global)
+ *   <data_dir>/<project_name>/overrides.json     (project)
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { getGlobalDir, getProjectDataDir } from './registry.js';
+const OVERRIDES_FILE = 'overrides.json';
+/**
+ * Read an override config file. Returns empty config if file doesn't exist.
+ */
+async function readOverrideFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Read global overrides (<data_dir>/overrides.json).
+ */
+export async function readGlobalOverrides() {
+    return readOverrideFile(join(getGlobalDir(), OVERRIDES_FILE));
+}
+/**
+ * Read project-level overrides (<data_dir>/<project_name>/overrides.json).
+ */
+export async function readProjectOverrides(projectName) {
+    return readOverrideFile(join(getProjectDataDir(projectName), OVERRIDES_FILE));
+}
+/**
+ * Write an override config file.
+ */
+async function writeOverrideFile(filePath, config) {
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Write global overrides.
+ */
+export async function writeGlobalOverrides(config) {
+    await writeOverrideFile(join(getGlobalDir(), OVERRIDES_FILE), config);
+}
+/**
+ * Write project-level overrides.
+ */
+export async function writeProjectOverrides(projectName, config) {
+    await writeOverrideFile(join(getProjectDataDir(projectName), OVERRIDES_FILE), config);
+}
+/**
+ * Merge two override configs. `higher` takes priority over `lower`.
+ */
+function mergeConfigs(lower, higher) {
+    const merged = {};
+    // Merge review: higher wins entirely if present
+    if (higher.review !== undefined) {
+        merged.review = higher.review;
+    }
+    else if (lower.review !== undefined) {
+        merged.review = lower.review;
+    }
+    // Merge roles: deep merge per role (agent, model, capabilities)
+    const lowerRoles = lower.roles ?? {};
+    const higherRoles = higher.roles ?? {};
+    const allRoleIds = new Set([...Object.keys(lowerRoles), ...Object.keys(higherRoles)]);
+    if (allRoleIds.size > 0) {
+        merged.roles = {};
+        for (const roleId of allRoleIds) {
+            const lo = lowerRoles[roleId] ?? {};
+            const hi = higherRoles[roleId] ?? {};
+            merged.roles[roleId] = {
+                ...lo,
+                ...hi,
+                // Deep merge capabilities
+                capabilities: {
+                    ...(lo.capabilities ?? {}),
+                    ...(hi.capabilities ?? {}),
+                },
+            };
+            // Clean up empty capabilities
+            if (Object.keys(merged.roles[roleId].capabilities).length === 0) {
+                delete merged.roles[roleId].capabilities;
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Get the fully merged override config for a project.
+ * Priority: project > global
+ */
+export async function getMergedOverrides(projectName) {
+    const global = await readGlobalOverrides();
+    const project = await readProjectOverrides(projectName);
+    return mergeConfigs(global, project);
+}
+/**
+ * Resolve whether a specific doc requires review.
+ *
+ * Priority: project override > global override > workflow default
+ */
+export function resolveDocReview(docId, docDef, overrides) {
+    const review = overrides.review;
+    // Override is a per-doc record
+    if (typeof review === 'object' && review !== null) {
+        if (docId in review) {
+            return review[docId];
+        }
+        // Not mentioned in override, fall through to workflow default
+    }
+    // Override is a global boolean toggle
+    if (typeof review === 'boolean') {
+        return review;
+    }
+    // No override — use workflow default
+    return docDef.review ?? false;
+}
+/**
+ * Resolve the capability override for a specific role + capability.
+ * Returns null if no override is configured.
+ */
+export function resolveCapabilityOverride(roleId, capabilityId, overrides) {
+    return overrides.roles?.[roleId]?.capabilities?.[capabilityId] ?? null;
+}
+/**
+ * Set a single role capability override at project or global level.
+ */
+export async function setCapabilityOverride(scope, projectName, roleId, capabilityId, override) {
+    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+    if (!config.roles) {
+        config.roles = {};
+    }
+    if (!config.roles[roleId]) {
+        config.roles[roleId] = {};
+    }
+    if (!config.roles[roleId].capabilities) {
+        config.roles[roleId].capabilities = {};
+    }
+    config.roles[roleId].capabilities[capabilityId] = override;
+    if (scope === 'global') {
+        await writeGlobalOverrides(config);
+    }
+    else {
+        await writeProjectOverrides(projectName, config);
+    }
+}
+/**
+ * Set review override for a specific doc at project or global level.
+ */
+export async function setReviewOverride(scope, projectName, docId, enabled) {
+    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+    // Ensure review is a per-doc record
+    if (typeof config.review !== 'object' || config.review === null) {
+        config.review = {};
+    }
+    config.review[docId] = enabled;
+    if (scope === 'global') {
+        await writeGlobalOverrides(config);
+    }
+    else {
+        await writeProjectOverrides(projectName, config);
+    }
+}
+/**
+ * Resolve the agent/model configuration for a role.
+ * Returns { agent, model } from the merged overrides, or undefined fields if not set.
+ */
+export function resolveRoleConfig(roleId, overrides) {
+    const role = overrides.roles?.[roleId];
+    if (!role)
+        return {};
+    return {
+        ...(role.agent ? { agent: role.agent } : {}),
+        ...(role.model ? { model: role.model } : {}),
+    };
+}
+/**
+ * Set agent/model config for a role at project or global level.
+ */
+export async function setRoleAgentConfig(scope, projectName, roleId, agent, model) {
+    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+    if (!config.roles) {
+        config.roles = {};
+    }
+    if (!config.roles[roleId]) {
+        config.roles[roleId] = {};
+    }
+    if (agent)
+        config.roles[roleId].agent = agent;
+    if (model)
+        config.roles[roleId].model = model;
+    if (scope === 'global') {
+        await writeGlobalOverrides(config);
+    }
+    else {
+        await writeProjectOverrides(projectName, config);
+    }
+}
+//# sourceMappingURL=overrides.js.map

package/build/core/overrides.js.map

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

package/build/core/registry.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Global registry — manages Harmonia data directory and project name → directory mappings.
+ *
+ * Data directory follows system conventions (see getGlobalDir()):
+ *   macOS:   ~/Library/Application Support/harmonia
+ *   Linux:   $XDG_DATA_HOME/harmonia  (defaults to ~/.local/share/harmonia)
+ *   Windows: %APPDATA%/harmonia
+ *   Override: HARMONIA_DATA_DIR env var
+ *
+ * Structure:
+ *   <data_dir>/
+ *   ├── registry.json        # { projects: { "my-app": { dir: "/path/to/src", ... } } }
+ *   ├── overrides.json       # global overrides (optional)
+ *   ├── my-app/
+ *   │   ├── state.json
+ *   │   ├── docs/
+ *   │   ├── reviews.json
+ *   │   ├── overrides.json   # project-level overrides (optional)
+ *   │   └── ...
+ *   └── another-project/
+ *       └── ...
+ */
+export interface ProjectEntry {
+    /** Absolute path to the project source directory */
+    dir: string;
+    /** Workflow name used by this project */
+    workflow: string;
+    /** When the project was registered */
+    createdAt: string;
+}
+export interface Registry {
+    projects: Record<string, ProjectEntry>;
+}
+/**
+ * Get the global Harmonia data directory, following system conventions.
+ *
+ * Resolution order:
+ *   1. HARMONIA_DATA_DIR env var (explicit override)
+ *   2. Platform default:
+ *      - macOS:   ~/Library/Application Support/harmonia
+ *      - Windows: %APPDATA%/harmonia
+ *      - Linux:   $XDG_DATA_HOME/harmonia (defaults to ~/.local/share/harmonia)
+ */
+export declare function getGlobalDir(): string;
+/**
+ * Get the data directory for a specific project within the global dir.
+ */
+export declare function getProjectDataDir(projectName: string): string;
+/**
+ * Read the global registry. Returns empty registry if file doesn't exist.
+ */
+export declare function readRegistry(): Promise<Registry>;
+/**
+ * Write the global registry to disk.
+ */
+export declare function writeRegistry(registry: Registry): Promise<void>;
+/**
+ * Register a new project. Creates the project data directory.
+ */
+export declare function registerProject(projectName: string, projectDir: string, workflow: string): Promise<void>;
+/**
+ * Look up a project by name. Returns null if not found.
+ */
+export declare function getProject(projectName: string): Promise<ProjectEntry | null>;
+/**
+ * List all registered project names.
+ */
+export declare function listProjects(): Promise<string[]>;
+/**
+ * Remove a project from the registry (does NOT delete files).
+ */
+export declare function unregisterProject(projectName: string): Promise<void>;