@s_s/harmonia 1.0.0

package/build/core/registry.js

@@ -0,0 +1,121 @@
+/**
+ * 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/
+ *       └── ...
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { platform } from 'node:os';
+const REGISTRY_FILE = 'registry.json';
+/**
+ * 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 function getGlobalDir() {
+    const envDir = process.env.HARMONIA_DATA_DIR;
+    if (envDir)
+        return envDir;
+    const home = homedir();
+    switch (platform()) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'harmonia');
+        case 'win32':
+            return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'harmonia');
+        default:
+            // Linux and others: follow XDG Base Directory spec
+            return join(process.env.XDG_DATA_HOME || join(home, '.local', 'share'), 'harmonia');
+    }
+}
+/**
+ * Get the data directory for a specific project within the global dir.
+ */
+export function getProjectDataDir(projectName) {
+    return join(getGlobalDir(), projectName);
+}
+/**
+ * Read the global registry. Returns empty registry if file doesn't exist.
+ */
+export async function readRegistry() {
+    try {
+        const content = await readFile(join(getGlobalDir(), REGISTRY_FILE), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return { projects: {} };
+    }
+}
+/**
+ * Write the global registry to disk.
+ */
+export async function writeRegistry(registry) {
+    const globalDir = getGlobalDir();
+    await mkdir(globalDir, { recursive: true });
+    await writeFile(join(globalDir, REGISTRY_FILE), JSON.stringify(registry, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Register a new project. Creates the project data directory.
+ */
+export async function registerProject(projectName, projectDir, workflow) {
+    const registry = await readRegistry();
+    if (registry.projects[projectName]) {
+        throw new Error(`Project "${projectName}" already exists. Use a different name or remove the existing project first.`);
+    }
+    registry.projects[projectName] = {
+        dir: projectDir,
+        workflow,
+        createdAt: new Date().toISOString(),
+    };
+    // Create project data directory structure under global dir
+    const dataDir = getProjectDataDir(projectName);
+    await mkdir(join(dataDir, 'docs'), { recursive: true });
+    // Create the project source directory if it doesn't exist
+    await mkdir(projectDir, { recursive: true });
+    await writeRegistry(registry);
+}
+/**
+ * Look up a project by name. Returns null if not found.
+ */
+export async function getProject(projectName) {
+    const registry = await readRegistry();
+    return registry.projects[projectName] ?? null;
+}
+/**
+ * List all registered project names.
+ */
+export async function listProjects() {
+    const registry = await readRegistry();
+    return Object.keys(registry.projects);
+}
+/**
+ * Remove a project from the registry (does NOT delete files).
+ */
+export async function unregisterProject(projectName) {
+    const registry = await readRegistry();
+    delete registry.projects[projectName];
+    await writeRegistry(registry);
+}
+//# sourceMappingURL=registry.js.map

package/build/core/registry.js.map

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

package/build/core/reviews.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Document review state management — <data_dir>/<project_name>/reviews.json
+ *
+ * Tracks which documents are pending review, approved, or rejected.
+ */
+import type { DocReviewState } from './types.js';
+/**
+ * Read the reviews state for a project.
+ */
+export declare function readReviews(projectName: string): Promise<Record<string, DocReviewState>>;
+/**
+ * Submit a document for review. Sets status to "pending".
+ */
+export declare function submitForReview(projectName: string, docId: string): Promise<DocReviewState>;
+/**
+ * Approve or reject a document review.
+ */
+export declare function resolveReview(projectName: string, docId: string, status: 'approved' | 'rejected', comment?: string): Promise<DocReviewState>;
+/**
+ * Get the review state for a specific document.
+ */
+export declare function getDocReview(projectName: string, docId: string): Promise<DocReviewState | null>;
+/**
+ * Get all pending reviews for a project.
+ */
+export declare function getPendingReviews(projectName: string): Promise<DocReviewState[]>;

package/build/core/reviews.js

@@ -0,0 +1,83 @@
+/**
+ * Document review state management — <data_dir>/<project_name>/reviews.json
+ *
+ * Tracks which documents are pending review, approved, or rejected.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { getProjectDataDir } from './registry.js';
+const REVIEWS_FILE = 'reviews.json';
+function reviewsPath(projectName) {
+    return join(getProjectDataDir(projectName), REVIEWS_FILE);
+}
+/**
+ * Read the reviews state for a project.
+ */
+export async function readReviews(projectName) {
+    try {
+        const content = await readFile(reviewsPath(projectName), 'utf-8');
+        const data = JSON.parse(content);
+        return data.docs ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write reviews state to disk.
+ */
+async function writeReviews(projectName, docs) {
+    const filePath = reviewsPath(projectName);
+    await mkdir(dirname(filePath), { recursive: true });
+    const data = { docs };
+    await writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Submit a document for review. Sets status to "pending".
+ */
+export async function submitForReview(projectName, docId) {
+    const reviews = await readReviews(projectName);
+    const state = {
+        docId,
+        status: 'pending',
+        submittedAt: new Date().toISOString(),
+    };
+    reviews[docId] = state;
+    await writeReviews(projectName, reviews);
+    return state;
+}
+/**
+ * Approve or reject a document review.
+ */
+export async function resolveReview(projectName, docId, status, comment) {
+    const reviews = await readReviews(projectName);
+    const existing = reviews[docId];
+    if (!existing) {
+        throw new Error(`No review pending for document "${docId}". Submit it for review first.`);
+    }
+    if (existing.status !== 'pending') {
+        throw new Error(`Document "${docId}" review is already ${existing.status}.`);
+    }
+    existing.status = status;
+    existing.reviewedAt = new Date().toISOString();
+    if (comment) {
+        existing.comment = comment;
+    }
+    await writeReviews(projectName, reviews);
+    return existing;
+}
+/**
+ * Get the review state for a specific document.
+ */
+export async function getDocReview(projectName, docId) {
+    const reviews = await readReviews(projectName);
+    return reviews[docId] ?? null;
+}
+/**
+ * Get all pending reviews for a project.
+ */
+export async function getPendingReviews(projectName) {
+    const reviews = await readReviews(projectName);
+    return Object.values(reviews).filter((r) => r.status === 'pending');
+}
+//# sourceMappingURL=reviews.js.map

package/build/core/reviews.js.map

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

package/build/core/state.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Project state management — manages <data_dir>/<project_name>/state.json
+ */
+import type { PhaseStatus, ProjectScale, ProjectState, LoadedWorkflow } from './types.js';
+/**
+ * Initialize a new project state file.
+ * Note: directory creation and registry are handled by registry.registerProject().
+ * This only writes the state.json.
+ */
+export declare function initProjectState(projectName: string, projectDir: string, workflow: LoadedWorkflow, scale?: ProjectScale): Promise<ProjectState>;
+/**
+ * Read the current project state.
+ */
+export declare function readState(projectName: string): Promise<ProjectState>;
+/**
+ * Write project state to disk.
+ */
+export declare function writeState(projectName: string, state: ProjectState): Promise<void>;
+/**
+ * Update a specific phase's status.
+ */
+export declare function updatePhaseStatus(projectName: string, phaseId: string, status: PhaseStatus, blockedReason?: string): Promise<ProjectState>;
+/**
+ * Check if a project state file exists.
+ */
+export declare function projectStateExists(projectName: string): Promise<boolean>;

package/build/core/state.js

@@ -0,0 +1,103 @@
+/**
+ * Project state management — manages <data_dir>/<project_name>/state.json
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { getProjectDataDir } from './registry.js';
+const STATE_FILE = 'state.json';
+function statePath(projectName) {
+    return join(getProjectDataDir(projectName), STATE_FILE);
+}
+/**
+ * Initialize a new project state file.
+ * Note: directory creation and registry are handled by registry.registerProject().
+ * This only writes the state.json.
+ */
+export async function initProjectState(projectName, projectDir, workflow, scale = 'small') {
+    const now = new Date().toISOString();
+    const phases = workflow.definition.phases;
+    const firstPhaseId = phases[0]?.id ?? '';
+    const state = {
+        projectName,
+        projectDir,
+        workflow: workflow.definition.name,
+        scale,
+        currentPhase: firstPhaseId,
+        phases: phases.map((p, i) => ({
+            id: p.id,
+            status: i === 0 ? 'in_progress' : 'pending',
+            ...(i === 0 ? { startedAt: now } : {}),
+        })),
+        createdAt: now,
+        updatedAt: now,
+    };
+    await writeState(projectName, state);
+    return state;
+}
+/**
+ * Read the current project state.
+ */
+export async function readState(projectName) {
+    const content = await readFile(statePath(projectName), 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Write project state to disk.
+ */
+export async function writeState(projectName, state) {
+    const filePath = statePath(projectName);
+    await mkdir(dirname(filePath), { recursive: true });
+    state.updatedAt = new Date().toISOString();
+    await writeFile(filePath, JSON.stringify(state, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Update a specific phase's status.
+ */
+export async function updatePhaseStatus(projectName, phaseId, status, blockedReason) {
+    const state = await readState(projectName);
+    const phase = state.phases.find((p) => p.id === phaseId);
+    if (!phase) {
+        throw new Error(`Phase "${phaseId}" not found in project state`);
+    }
+    const now = new Date().toISOString();
+    phase.status = status;
+    if (status === 'in_progress' && !phase.startedAt) {
+        phase.startedAt = now;
+    }
+    if (status === 'completed') {
+        phase.completedAt = now;
+        delete phase.blockedReason;
+    }
+    if (status === 'blocked' && blockedReason) {
+        phase.blockedReason = blockedReason;
+    }
+    // If advancing to in_progress, update currentPhase
+    if (status === 'in_progress') {
+        state.currentPhase = phaseId;
+    }
+    // If completing a phase, auto-advance currentPhase to the next pending one
+    if (status === 'completed') {
+        const idx = state.phases.findIndex((p) => p.id === phaseId);
+        const next = state.phases.find((p, i) => i > idx && p.status === 'pending');
+        if (next) {
+            next.status = 'in_progress';
+            next.startedAt = now;
+            state.currentPhase = next.id;
+        }
+    }
+    await writeState(projectName, state);
+    return state;
+}
+/**
+ * Check if a project state file exists.
+ */
+export async function projectStateExists(projectName) {
+    try {
+        await readFile(statePath(projectName), 'utf-8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=state.js.map

package/build/core/state.js.map

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

package/build/core/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Core type definitions for Harmonia.
+ * These types are workflow-agnostic — no hardcoded role names or phase names.
+ */
+export interface PhaseDefinition {
+    id: string;
+    name: string;
+    roles: string[];
+    inputs?: string[];
+    outputs: string[];
+    description: string;
+}
+export type DocScale = 'full' | 'lite' | 'skip' | 'optional';
+export interface DocDefinition {
+    name: string;
+    scale: Record<ProjectScale, DocScale>;
+    /** File format: "md" (default) or "html" */
+    format?: 'md' | 'html';
+    /** Whether this doc requires user review/approval after creation */
+    review?: boolean;
+    /** External output — not managed by write_doc (e.g. code written directly to project dir) */
+    external?: boolean;
+}
+export interface ScaleDimension {
+    small: string | number | boolean;
+    medium: string | number | boolean;
+    large: string | number | boolean;
+}
+export interface WorkflowDefinition {
+    name: string;
+    description: string;
+    phases: PhaseDefinition[];
+    docs: Record<string, DocDefinition>;
+    scale_criteria: {
+        description: string;
+        dimensions: Record<string, ScaleDimension>;
+    };
+}
+export interface RoleCapability {
+    /** Unique ID for this capability */
+    id: string;
+    /** Human-readable description of what this capability does */
+    description: string;
+    /** Associated doc ID — if set, this capability produces this document */
+    doc?: string;
+}
+export interface RoleFrontmatter {
+    model: string;
+    session: 'none' | 'persistent' | 'optional';
+    parallel: boolean;
+    /** Capabilities this role provides (used by override system) */
+    capabilities?: RoleCapability[];
+}
+export interface RoleDefinition {
+    id: string;
+    frontmatter: RoleFrontmatter;
+    prompt: string;
+}
+export interface LoadedWorkflow {
+    definition: WorkflowDefinition;
+    roles: Record<string, RoleDefinition>;
+}
+export type PhaseStatus = 'pending' | 'in_progress' | 'completed' | 'blocked' | 'review';
+export type ProjectScale = 'small' | 'medium' | 'large';
+export interface PhaseState {
+    id: string;
+    status: PhaseStatus;
+    startedAt?: string;
+    completedAt?: string;
+    blockedReason?: string;
+}
+export interface ProjectState {
+    /** Project name (unique identifier) */
+    projectName: string;
+    /** Absolute path to the project source directory */
+    projectDir: string;
+    /** Workflow name, e.g. "dev" */
+    workflow: string;
+    /** Project scale determined by PM */
+    scale: ProjectScale;
+    /** Current phase id */
+    currentPhase: string;
+    /** State of each phase */
+    phases: PhaseState[];
+    /** Timestamp of project initialization */
+    createdAt: string;
+    /** Last updated timestamp */
+    updatedAt: string;
+}
+export type ReviewStatus = 'pending' | 'approved' | 'rejected';
+export interface DocReviewState {
+    docId: string;
+    status: ReviewStatus;
+    submittedAt: string;
+    reviewedAt?: string;
+    comment?: string;
+}
+export type SessionStatus = 'active' | 'idle' | 'closed' | 'lost';
+export interface SessionRecord {
+    /** Harmonia-generated session ID, e.g. "ses-001" */
+    id: string;
+    /** Role this session belongs to */
+    role: string;
+    /** Actual session ID from the host agent (e.g. OpenCode session ID) */
+    agentSessionId?: string;
+    /** Agent type used for this session */
+    agentType?: AgentType;
+    /** Current session status */
+    status: SessionStatus;
+    /** PM-defined label, e.g. "dev-auth-module" */
+    label?: string;
+    /** When this session was created */
+    createdAt: string;
+    /** When this session was last active */
+    lastActiveAt: string;
+}
+export type DispatchStatus = 'dispatched' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface DispatchRecord {
+    /** Auto-incremented dispatch ID, e.g. "dispatch-001" */
+    id: string;
+    /** Role dispatched */
+    role: string;
+    /** Associated session ID (set when agent is launched) */
+    sessionId?: string;
+    /** Task description for the dispatched role */
+    taskBrief: string;
+    /** Current dispatch status */
+    status: DispatchStatus;
+    /** Expected output doc IDs from this dispatch */
+    expectedOutputs: string[];
+    /** When this dispatch was created */
+    createdAt: string;
+    /** Last updated timestamp */
+    updatedAt: string;
+    /** When this dispatch was completed */
+    completedAt?: string;
+    /** Failure reason or notes */
+    note?: string;
+}
+export type OverrideToolType = 'skill' | 'mcp';
+export interface CapabilityOverride {
+    /** Tool source type */
+    type: OverrideToolType;
+    /** Tool name */
+    tool: string;
+    /** MCP server name (required when type is "mcp") */
+    server?: string;
+    /** Static parameters to always pass when calling the tool */
+    params?: Record<string, unknown>;
+    /** Additional notes for prompt generation (rarely needed) */
+    notes?: string;
+}
+/** Agent type for spawning team member agents */
+export type AgentType = 'opencode' | 'openclaw' | 'claude-code' | 'codex';
+/** Per-role override configuration */
+export interface RoleOverride {
+    /** Agent type to use for this role */
+    agent?: AgentType;
+    /** Model to use for this role (overrides the role's default model level) */
+    model?: string;
+    /** Capability overrides for this role */
+    capabilities?: Record<string, CapabilityOverride>;
+}
+/**
+ * Override configuration file structure (<data_dir>/overrides.json or project-level).
+ *
+ * review: boolean | Record<docId, boolean>
+ *   - boolean: global toggle for all docs
+ *   - Record: per-doc toggle
+ *
+ * roles: Record<roleId, RoleOverride>
+ *   - agent: agent type for spawning
+ *   - model: model override
+ *   - capabilities: Record<capabilityId, CapabilityOverride>
+ */
+export interface OverrideConfig {
+    /** Review overrides — global toggle or per-doc */
+    review?: boolean | Record<string, boolean>;
+    /** Role overrides (agent, model, capabilities) */
+    roles?: Record<string, RoleOverride>;
+}

package/build/core/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core type definitions for Harmonia.
+ * These types are workflow-agnostic — no hardcoded role names or phase names.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/build/core/workflow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Workflow loader — reads workflow definitions and role prompts from the
+ * workflows/ directory bundled with Harmonia.
+ */
+import type { LoadedWorkflow } from './types.js';
+/**
+ * Load a single workflow by name from the given workflows root directory.
+ */
+export declare function loadWorkflow(workflowsDir: string, name: string): Promise<LoadedWorkflow>;
+/**
+ * List all available workflow names.
+ */
+export declare function listWorkflows(workflowsDir: string): Promise<string[]>;

package/build/core/workflow.js

@@ -0,0 +1,63 @@
+/**
+ * Workflow loader — reads workflow definitions and role prompts from the
+ * workflows/ directory bundled with Harmonia.
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, parse } from 'node:path';
+import YAML from 'yaml';
+/**
+ * Parse a role markdown file.
+ * Format: YAML frontmatter (---\n...\n---) followed by markdown prompt.
+ */
+function parseRoleFile(id, content) {
+    const fmRegex = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+    const match = content.match(fmRegex);
+    if (!match) {
+        return {
+            id,
+            frontmatter: { model: 'medium', session: 'none', parallel: false },
+            prompt: content.trim(),
+        };
+    }
+    const yamlBlock = match[1];
+    const prompt = match[2].trim();
+    const parsed = YAML.parse(yamlBlock);
+    const fm = parsed ?? {};
+    const capabilities = Array.isArray(fm.capabilities) ? fm.capabilities : undefined;
+    const frontmatter = {
+        model: fm.model ?? 'medium',
+        session: fm.session ?? 'none',
+        parallel: fm.parallel ?? false,
+        ...(capabilities ? { capabilities } : {}),
+    };
+    return { id, frontmatter, prompt };
+}
+/**
+ * Load a single workflow by name from the given workflows root directory.
+ */
+export async function loadWorkflow(workflowsDir, name) {
+    const workflowDir = join(workflowsDir, name);
+    // Load workflow.json
+    const workflowJson = await readFile(join(workflowDir, 'workflow.json'), 'utf-8');
+    const definition = JSON.parse(workflowJson);
+    // Load roles
+    const rolesDir = join(workflowDir, 'roles');
+    const roleFiles = await readdir(rolesDir);
+    const roles = {};
+    for (const file of roleFiles) {
+        if (!file.endsWith('.md'))
+            continue;
+        const roleId = parse(file).name;
+        const content = await readFile(join(rolesDir, file), 'utf-8');
+        roles[roleId] = parseRoleFile(roleId, content);
+    }
+    return { definition, roles };
+}
+/**
+ * List all available workflow names.
+ */
+export async function listWorkflows(workflowsDir) {
+    const entries = await readdir(workflowsDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+}
+//# sourceMappingURL=workflow.js.map

package/build/core/workflow.js.map

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