@s_s/harmonia 1.3.0 → 1.4.0

package/build/core/overrides.d.ts

@@ -1,62 +1,55 @@
 /**
- * Override configuration — three-layer merge system.
+ * Override configuration — two-layer system: project overrides > workflow defaults.
  *
- * Priority: project-level > global-level > workflow defaults
+ * Project-level overrides are stored in:
+ *   <data_dir>/<project_name>/overrides.json
  *
- * Files:
- *   <data_dir>/overrides.json                    (global)
- *   <data_dir>/<project_name>/overrides.json     (project)
+ * Workflow defaults come from the workflow definition (artifactDefinitions, roles).
+ * The override system lets users customize per-project settings without modifying
+ * the workflow definition itself.
  */
-import type { CapabilityOverride, DocDefinition, OverrideConfig } from './types.js';
-/**
- * Read global overrides (<data_dir>/overrides.json).
- */
-export declare function readGlobalOverrides(): Promise<OverrideConfig>;
+import type { CapabilityOverride, ArtifactDefinition, OverrideConfig } from './types.js';
 /**
  * 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
+ * Get the override config for a project.
+ * Returns the project-level overrides directly — no global merge.
  */
 export declare function getMergedOverrides(projectName: string): Promise<OverrideConfig>;
 /**
- * Resolve whether a specific doc requires review.
+ * Resolve whether a specific artifact requires review.
  *
- * Priority: project override > global override > workflow default
+ * Priority: project override > workflow default
  */
-export declare function resolveDocReview(docId: string, docDef: DocDefinition, overrides: OverrideConfig): boolean;
+export declare function resolveArtifactReview(artifactId: string, artifactDef: ArtifactDefinition, 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.
+ * Set a single role capability override at project level.
  */
-export declare function setCapabilityOverride(scope: 'global' | 'project', projectName: string | null, roleId: string, capabilityId: string, override: CapabilityOverride): Promise<void>;
+export declare function setCapabilityOverride(projectName: string, roleId: string, capabilityId: string, override: CapabilityOverride): Promise<void>;
 /**
- * Set review override for a specific doc at project or global level.
+ * Set review override for a specific artifact at project level.
  */
-export declare function setReviewOverride(scope: 'global' | 'project', projectName: string | null, docId: string, enabled: boolean): Promise<void>;
+export declare function setReviewOverride(projectName: string, artifactId: 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.
+ * Returns { agent, model } from the 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.
+ * Set agent/model config for a role at project level.
  */
-export declare function setRoleAgentConfig(scope: 'global' | 'project', projectName: string | null, roleId: string, agent?: string, model?: string): Promise<void>;
+export declare function setRoleAgentConfig(projectName: string, roleId: string, agent?: string, model?: string): Promise<void>;

package/build/core/overrides.js

@@ -1,15 +1,16 @@
 /**
- * Override configuration — three-layer merge system.
+ * Override configuration — two-layer system: project overrides > workflow defaults.
  *
- * Priority: project-level > global-level > workflow defaults
+ * Project-level overrides are stored in:
+ *   <data_dir>/<project_name>/overrides.json
  *
- * Files:
- *   <data_dir>/overrides.json                    (global)
- *   <data_dir>/<project_name>/overrides.json     (project)
+ * Workflow defaults come from the workflow definition (artifactDefinitions, roles).
+ * The override system lets users customize per-project settings without modifying
+ * the workflow definition itself.
  */
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
-import { getGlobalDir, getProjectDataDir } from './registry.js';
+import { getProjectDataDir } from './registry.js';
 const OVERRIDES_FILE = 'overrides.json';
 /**
  * Read an override config file. Returns empty config if file doesn't exist.
@@ -23,12 +24,6 @@ async function readOverrideFile(filePath) {
         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).
  */
@@ -42,12 +37,6 @@ 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.
  */
@@ -55,63 +44,23 @@ 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
+ * Get the override config for a project.
+ * Returns the project-level overrides directly — no global merge.
  */
 export async function getMergedOverrides(projectName) {
-    const global = await readGlobalOverrides();
-    const project = await readProjectOverrides(projectName);
-    return mergeConfigs(global, project);
+    return readProjectOverrides(projectName);
 }
 /**
- * Resolve whether a specific doc requires review.
+ * Resolve whether a specific artifact requires review.
  *
- * Priority: project override > global override > workflow default
+ * Priority: project override > workflow default
  */
-export function resolveDocReview(docId, docDef, overrides) {
+export function resolveArtifactReview(artifactId, artifactDef, overrides) {
     const review = overrides.review;
-    // Override is a per-doc record
+    // Override is a per-artifact record
     if (typeof review === 'object' && review !== null) {
-        if (docId in review) {
-            return review[docId];
+        if (artifactId in review) {
+            return review[artifactId];
         }
         // Not mentioned in override, fall through to workflow default
     }
@@ -120,7 +69,7 @@ export function resolveDocReview(docId, docDef, overrides) {
         return review;
     }
     // No override — use workflow default
-    return docDef.review ?? false;
+    return artifactDef.review ?? false;
 }
 /**
  * Resolve the capability override for a specific role + capability.
@@ -130,10 +79,10 @@ export function resolveCapabilityOverride(roleId, capabilityId, overrides) {
     return overrides.roles?.[roleId]?.capabilities?.[capabilityId] ?? null;
 }
 /**
- * Set a single role capability override at project or global level.
+ * Set a single role capability override at project level.
  */
-export async function setCapabilityOverride(scope, projectName, roleId, capabilityId, override) {
-    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+export async function setCapabilityOverride(projectName, roleId, capabilityId, override) {
+    const config = await readProjectOverrides(projectName);
     if (!config.roles) {
         config.roles = {};
     }
@@ -144,33 +93,23 @@ export async function setCapabilityOverride(scope, projectName, roleId, capabili
         config.roles[roleId].capabilities = {};
     }
     config.roles[roleId].capabilities[capabilityId] = override;
-    if (scope === 'global') {
-        await writeGlobalOverrides(config);
-    }
-    else {
-        await writeProjectOverrides(projectName, config);
-    }
+    await writeProjectOverrides(projectName, config);
 }
 /**
- * Set review override for a specific doc at project or global level.
+ * Set review override for a specific artifact at project 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
+export async function setReviewOverride(projectName, artifactId, enabled) {
+    const config = await readProjectOverrides(projectName);
+    // Ensure review is a per-artifact 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);
-    }
+    config.review[artifactId] = enabled;
+    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.
+ * Returns { agent, model } from the overrides, or undefined fields if not set.
  */
 export function resolveRoleConfig(roleId, overrides) {
     const role = overrides.roles?.[roleId];
@@ -182,10 +121,10 @@ export function resolveRoleConfig(roleId, overrides) {
     };
 }
 /**
- * Set agent/model config for a role at project or global level.
+ * Set agent/model config for a role at project level.
  */
-export async function setRoleAgentConfig(scope, projectName, roleId, agent, model) {
-    const config = scope === 'global' ? await readGlobalOverrides() : await readProjectOverrides(projectName);
+export async function setRoleAgentConfig(projectName, roleId, agent, model) {
+    const config = await readProjectOverrides(projectName);
     if (!config.roles) {
         config.roles = {};
     }
@@ -196,11 +135,6 @@ export async function setRoleAgentConfig(scope, projectName, roleId, agent, mode
         config.roles[roleId].agent = agent;
     if (model)
         config.roles[roleId].model = model;
-    if (scope === 'global') {
-        await writeGlobalOverrides(config);
-    }
-    else {
-        await writeProjectOverrides(projectName, config);
-    }
+    await writeProjectOverrides(projectName, config);
 }
 //# sourceMappingURL=overrides.js.map

package/build/core/overrides.js.map

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

package/build/core/plugin.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Plugin system — discovery, loading, and registration of workflow plugins.
+ *
+ * A workflow plugin is a directory containing:
+ *   workflow.json  — Node tree definition + artifact definitions
+ *   roles/*.md     — Role prompts with YAML frontmatter
+ *   schemas/*.json — Artifact schemas for validation
+ *   hooks/index.js  — Optional, exports createHooks()
+ *   tools/index.js  — Optional, exports registerActions()
+ *
+ * Loading flow:
+ * 1. Read workflow.json → parse node tree + artifact definitions
+ * 2. Validate via workflow-validator
+ * 3. Scan roles/ → parse role files
+ * 4. Scan schemas/ → load artifact schemas
+ * 5. If tools/index.js exists → dynamic import, register actions
+ * 6. If hooks/index.js exists → record hook creator (not executed yet)
+ */
+import type { WorkflowPlugin, PluginEntry } from './types.js';
+export declare class PluginLoadError extends Error {
+    constructor(pluginPath: string, reason: string);
+}
+export declare class PluginValidationError extends Error {
+    errors: {
+        type: string;
+        message: string;
+        nodeId?: string;
+    }[];
+    constructor(pluginPath: string, errors: {
+        type: string;
+        message: string;
+        nodeId?: string;
+    }[]);
+}
+export declare class WorkflowNotFoundError extends Error {
+    constructor(name: string, searched: string[]);
+}
+/**
+ * Load a workflow plugin from a directory.
+ *
+ * Full loading flow:
+ * 1. Read workflow.json → parse definition + artifact definitions
+ * 2. Validate the workflow definition (static analysis)
+ * 3. Load roles from roles/
+ * 4. Load schemas from schemas/
+ * 5. Optionally load actions from tools/index.js
+ * 6. Optionally load hook creator from hooks/index.js
+ *
+ * @param pluginPath - Absolute path to the plugin directory
+ * @param config - Optional plugin configuration
+ * @param skipValidation - Skip workflow validation (for testing)
+ */
+export declare function loadPlugin(pluginPath: string, config?: unknown, skipValidation?: boolean): Promise<WorkflowPlugin>;
+/**
+ * Discover registered plugins from a config.json file.
+ *
+ * Config format:
+ * ```json
+ * {
+ *   "workflows": {
+ *     "dev": { "path": "/path/to/dev/plugin" },
+ *     "custom": { "path": "/path/to/custom", "config": { ... } }
+ *   }
+ * }
+ * ```
+ */
+export declare function discoverPlugins(configPath: string): Promise<PluginEntry[]>;
+/**
+ * Resolve the actual directory for a workflow name.
+ * Searches only the single workflows directory (<data_dir>/harmonia/.workflows/).
+ */
+export declare function resolveWorkflowDir(workflowsDir: string, name: string): Promise<string>;
+/**
+ * Load a single workflow by name.
+ * Delegates to loadPlugin() internally.
+ *
+ * @param workflowsDir - Workflows directory (<data_dir>/harmonia/.workflows)
+ * @param name         - Workflow name (directory name)
+ */
+export declare function loadWorkflow(workflowsDir: string, name: string): Promise<WorkflowPlugin>;
+/**
+ * List all available workflow names from the workflows directory.
+ *
+ * @param workflowsDir - Workflows directory (<data_dir>/harmonia/.workflows)
+ */
+export declare function listWorkflows(workflowsDir: string): Promise<string[]>;