@amsterdamdatalabs/enact-factory 0.1.1

package/dist/core/workItemPayload.d.ts

@@ -0,0 +1,195 @@
+import type { WorkItemKind, Area, WorkItemState } from '../core/workItemModel.js';
+import type { RoleId, ExecutionPhase, PhaseArtifact } from '../core/agentLifecycle.js';
+import type { WorktreeLifecycle } from '../core/devopsModel.js';
+import type { PrSidecarState } from '../core/prSidecar.js';
+import type { OperatorLane } from '../workItems/schema.js';
+/**
+ * Explicit review state for a work item, independent of execution phase.
+ *
+ * - `none`     → no review has been requested or completed
+ * - `pending`  → review has been requested, not yet started
+ * - `approved` → reviewer approved the implementation
+ * - `rejected` → reviewer rejected; executor must revise
+ * - `revision` → revision loop is in progress
+ */
+export type ReviewState = 'none' | 'pending' | 'approved' | 'rejected' | 'revision';
+/** Ordered tuple of all ReviewState values. */
+export declare const REVIEW_STATES: readonly ReviewState[];
+/**
+ * Final resolution of a work item, independent of all other state axes.
+ *
+ * - `unresolved` → work item has not reached a terminal outcome
+ * - `succeeded`  → work item completed successfully (all phases done)
+ * - `failed`     → work item terminated due to unrecoverable error
+ * - `halted`     → execution paused; awaiting operator action
+ * - `cancelled`  → work item was explicitly cancelled
+ * - `duplicate`  → work item is a duplicate of another item
+ */
+export type Resolution = 'unresolved' | 'succeeded' | 'failed' | 'halted' | 'cancelled' | 'duplicate';
+/** Ordered tuple of all Resolution values. */
+export declare const RESOLUTIONS: readonly Resolution[];
+/**
+ * Snapshot of the agent execution lifecycle attached to a work item.
+ * Derived from `AgentLifecycle` (Wave 2).
+ */
+export interface ExecutionSnapshot {
+    /** The agent role currently responsible for this work item. */
+    currentRole: RoleId;
+    /** The current execution phase of the work item. */
+    currentPhase: ExecutionPhase;
+    /**
+     * Ordered list of phase artifacts accumulated so far.
+     * Artifacts are appended in phase order.
+     */
+    artifacts: PhaseArtifact[];
+}
+/**
+ * Discriminated record of all state axes, kept explicitly separate.
+ *
+ * Each axis is independently queryable and never collapsed into a single
+ * "status" field.  Callers must read the axis they care about.
+ *
+ * - `business`   → Wave 1 state machine (EpicFeatureState | ExecutableState)
+ * - `execution`  → Wave 2 runtime phase + role
+ * - `review`     → explicit review outcome (Wave 4)
+ * - `prSidecar`  → PR sidecar state (Wave 3, optional)
+ * - `resolution` → final terminal outcome (Wave 4)
+ */
+export interface LayeredState {
+    /** Business lifecycle state (from Wave 1 WorkItemState). */
+    business: WorkItemState;
+    /**
+     * Execution snapshot from Wave 2.
+     * Absent when the work item has not yet been picked up by an agent.
+     */
+    execution: ExecutionSnapshot | null;
+    /** Explicit review state axis. */
+    review: ReviewState;
+    /**
+     * PR sidecar state from Wave 3.
+     * Absent for Epic/Feature (planning tier items have no worktree/PR).
+     */
+    prSidecar: PrSidecarState | null;
+    /** Final resolution — `unresolved` while the item is still active. */
+    resolution: Resolution;
+}
+/**
+ * Fields mirrored verbatim from Azure DevOps that don't fit cleanly into
+ * `LayeredState` (or are too AzDO-specific to lift into the canonical contract).
+ *
+ * Kept under a single namespace so the canonical `WorkItemPayload` stays
+ * provider-agnostic. Consumers only read this when `source === 'azdo'`.
+ */
+export interface AzdoFields {
+    /** Raw AzDO numeric work-item id as a string (e.g. "1234"). */
+    azdoId: string;
+    /** Backlog item / Bug / Epic / Feature as reported by AzDO. */
+    workItemType: string;
+    /** AzDO state name verbatim (e.g. "New", "Approved", "In Progress"). */
+    state: string;
+    /** Raw description HTML/plain text from AzDO. */
+    description: string;
+    /** Priority integer 1..4 from `Microsoft.VSTS.Common.Priority`. */
+    priority: number | null;
+    /** Severity (Bug only) from `Microsoft.VSTS.Common.Severity`. */
+    severity: string | null;
+    /** AzDO area path verbatim (e.g. "Enact\\Factory"). */
+    areaPath: string;
+    /** Acceptance Criteria HTML — bullets are parsed client-side. */
+    acceptanceCriteria: string;
+    /** Start Date (Epic / Feature only). */
+    startDate: string | null;
+    /** Target Date (Epic / Feature only). */
+    targetDate: string | null;
+    /** Repro Steps (Bug only). */
+    reproSteps: string | null;
+    /** System Info (Bug only). */
+    systemInfo: string | null;
+    /** Mirrors WorkItemPayload.operatorLane when the item is AzDo-sourced. Canonical source is WorkItemPayload.operatorLane. */
+    operatorLane: string | null;
+    /** Custom.FailureReason picklist value. */
+    failureReason: string | null;
+    /** Display name of the person assigned to this work item (`System.AssignedTo`). */
+    assignedTo: string | null;
+    /** Semicolon-separated tags split into an array (`System.Tags`). Empty when absent. */
+    tags: string[];
+    /** AzDO iteration path verbatim, e.g. "Enact\\Sprint 12" (`System.IterationPath`). */
+    iterationPath: string | null;
+    /** Transition reason verbatim, e.g. "Moved to a sprint" (`System.Reason`). */
+    reason: string | null;
+    /** Six lifecycle booleans → flat object for easy dot rendering. */
+    lifecycle: {
+        planWritten: boolean;
+        implementationComplete: boolean;
+        reviewPassed: boolean;
+        testsPassing: boolean;
+        docsUpdated: boolean;
+        mergedToDevelop: boolean;
+    };
+    /** Parent breadcrumb (one or two levels up) — populated by server when known. */
+    parentId: string | null;
+    parentTitle: string | null;
+    parentWorkItemType: string | null;
+    parentStartDate: string | null;
+    parentTargetDate: string | null;
+    grandparentId: string | null;
+    grandparentTitle: string | null;
+    grandparentWorkItemType: string | null;
+    grandparentStartDate: string | null;
+    grandparentTargetDate: string | null;
+}
+/**
+ * Wire shape returned by `GET /api/factory/workitems` and
+ * `GET /api/factory/workitems/:id`.
+ *
+ * This is the canonical contract for Wave 4 and later (Wave 5 dashboard).
+ * All state axes are explicit and separate via `LayeredState`.
+ *
+ * Identity fields are flat for easy consumption by the dashboard.
+ * State is nested under `layeredState` to make the separation visible.
+ *
+ * Optional Wave 3 fields (`worktreeLifecycle`, `prSidecar`) are only
+ * present for executable items (Backlog item | Bug).  Planning-tier items
+ * (Epic | Feature) will always carry `null` for those fields.
+ */
+export interface WorkItemPayload {
+    /** Unique identifier (matches WorkItem.id or Azure DevOps work-item ID). */
+    id: string;
+    /** Operator-facing kind label. */
+    kind: WorkItemKind;
+    /** Human-readable title. */
+    title: string;
+    /** Owning area — mandatory. */
+    area: Area;
+    /**
+     * Parent item ID.  Null for Epics (root items).
+     * For Features → Epic ID.  For Backlog item | Bug → Feature or Epic ID.
+     */
+    parentId: string | null;
+    /**
+     * All state axes kept separate.
+     * Do not flatten these into a single "status" field.
+     */
+    layeredState: LayeredState;
+    /**
+     * Worktree lifecycle from Wave 3.
+     * Present only for executable items (Backlog item | Bug).
+     * Null for planning-tier items (Epic | Feature).
+     */
+    worktreeLifecycle: WorktreeLifecycle | null;
+    /** ISO-8601 creation timestamp. */
+    createdAt: string;
+    /** ISO-8601 last-updated timestamp. */
+    updatedAt: string;
+    /**
+     * Azure DevOps mirror fields. Present when this work item is sourced
+     * from AzDO (`source='azdo'`). Consumers MUST treat this as the source
+     * of truth for AzDO-owned fields and never write to it.
+     */
+    azdoFields?: AzdoFields;
+    /** Active operator lane for this session root. Populated by scheduler on activation; optional for non-session items. */
+    operatorLane?: OperatorLane;
+    /** Optional external board identifier (AzDo workItemId, GitHub issue, etc). Not required for runtime. */
+    externalWorkItemId?: string;
+}
+//# sourceMappingURL=workItemPayload.d.ts.map

package/dist/core/workItemPayload.d.ts.map

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

package/dist/core/workItemPayload.js

@@ -0,0 +1,24 @@
+// ============================================
+// EnactFactory - Canonical Work-Item Payload Contract (Wave 4)
+// Wire shape returned by GET /api/factory/workitems
+// Composed from Wave 1 (workItemModel), Wave 2 (agentLifecycle),
+// Wave 3 (devopsModel, prSidecar) types.
+// ============================================
+/** Ordered tuple of all ReviewState values. */
+export const REVIEW_STATES = [
+    'none',
+    'pending',
+    'approved',
+    'rejected',
+    'revision',
+];
+/** Ordered tuple of all Resolution values. */
+export const RESOLUTIONS = [
+    'unresolved',
+    'succeeded',
+    'failed',
+    'halted',
+    'cancelled',
+    'duplicate',
+];
+//# sourceMappingURL=workItemPayload.js.map

package/dist/core/workItemPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItemPayload.js","sourceRoot":"","sources":["../../src/core/workItemPayload.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+DAA+D;AAC/D,oDAAoD;AACpD,iEAAiE;AACjE,yCAAyC;AACzC,+CAA+C;AAuB/C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,MAAM;IACN,SAAS;IACT,UAAU;IACV,UAAU;IACV,UAAU;CACF,CAAC;AAwBX,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,WAAW;CACH,CAAC"}

package/dist/core/workspaceConfig.d.ts

@@ -0,0 +1,57 @@
+export interface DeclaredPathValue {
+    value: string;
+    sourceDir: string;
+}
+export interface WorkspaceRootConfig {
+    factory?: Record<string, unknown>;
+    postgres?: Record<string, unknown>;
+    gateway?: Record<string, unknown>;
+    agent?: Record<string, unknown>;
+    watchdog?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    operator?: Record<string, unknown>;
+    paths?: {
+        use_global?: boolean;
+        project?: string;
+        global?: string;
+    };
+}
+/** Factory's global config: ~/.enact/factory/config.toml (the merge base). */
+export declare function globalFactoryConfigPath(): string;
+export declare function readWorkspaceRootConfig(startDir?: string): WorkspaceRootConfig | null;
+/**
+ * Resolve a path-typed field honoring per-key provenance: returns the value
+ * and the directory of the config.toml that declared it (so callers can
+ * resolve relative values against the correct base).
+ * Searches in workspace→global precedence order; first declarer wins.
+ */
+export declare function resolveDeclaredFactoryPath(pick: (cfg: WorkspaceRootConfig) => unknown, startDir?: string): DeclaredPathValue | null;
+export declare function expandFactoryPath(value: string, sourceDir: string): string;
+export declare function getWorkspaceConfigPath(startDir?: string): string | null;
+export declare function getWorkspaceRootDir(startDir?: string): string;
+export declare function getWorkspaceFactoryPort(startDir?: string): number | null;
+export declare function getWorkspaceFactoryDashPort(startDir?: string): number | null;
+export declare function requireWorkspaceFactoryPort(startDir?: string): number;
+export declare function requireWorkspaceFactoryDashPort(startDir?: string): number;
+/**
+ * The single canonical UI port for the dashboard web server (43206 dev / 53206 prod).
+ *
+ * Both `enact-factory dash` and `enact-factory start` (the daemon) bind this port
+ * via `startWebServer`, and every client that talks to the dashboard over HTTP (the
+ * CLI exec handler, the chat TUI) connects to it.
+ *
+ * Resolution order (workspace-merged config wins):
+ *   1. `[factory].port`      — the canonical factory port (preferred)
+ *   2. `[factory].dash_port` — legacy key retained as fallback for old configs only
+ *   3. 43206                 — built-in default matching the enact-docs port registry
+ *
+ * `dash_port` is no longer written to new configs; it is only read as a fallback so
+ * that existing installations with only `dash_port` set keep working without changes.
+ */
+export declare function getWorkspaceUiPort(startDir?: string): number | null;
+export declare function requireWorkspaceUiPort(startDir?: string): number;
+export declare function requireWorkspaceFactoryWorkItemStateFile(startDir?: string): string;
+export declare function requireWorkspaceFactoryStorage(startDir?: string): string;
+export declare function requireWorkspaceOperatorStorage(startDir?: string): string;
+export declare function requireWorkspaceContextBin(): string;
+//# sourceMappingURL=workspaceConfig.d.ts.map

package/dist/core/workspaceConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceConfig.d.ts","sourceRoot":"","sources":["../../src/core/workspaceConfig.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAMD,8EAA8E;AAC9E,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAeD,wBAAgB,uBAAuB,CAAC,QAAQ,SAAgB,GAAG,mBAAmB,GAAG,IAAI,CAQ5F;AAwBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,EAC3C,QAAQ,SAAgB,GACvB,iBAAiB,GAAG,IAAI,CAQ1B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAQ9E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAMpE;AAOD,wBAAgB,uBAAuB,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAI/E;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAInF;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAE5E;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAEvE;AAED,wBAAgB,wCAAwC,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAMzF;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAM/E;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,SAAgB,GAAG,MAAM,CAMhF;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD"}

package/dist/core/workspaceConfig.js

@@ -0,0 +1,184 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import TOML from '@iarna/toml';
+function configFileName() {
+    return process.env.NODE_ENV === 'production' ? 'config.prd.toml' : 'config.toml';
+}
+/** Factory's global config: ~/.enact/factory/config.toml (the merge base). */
+export function globalFactoryConfigPath() {
+    return resolve(homedir(), '.enact', 'factory', configFileName());
+}
+function candidateConfigPaths(startDir = process.cwd()) {
+    const fileName = configFileName();
+    const workspacePaths = [];
+    let current = resolve(startDir);
+    while (true) {
+        workspacePaths.push(resolve(current, fileName));
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return [...new Set([...workspacePaths, globalFactoryConfigPath()])];
+}
+export function readWorkspaceRootConfig(startDir = process.cwd()) {
+    const configs = readWorkspaceRootConfigs(startDir);
+    if (configs.length === 0)
+        return null;
+    let merged = {};
+    for (const cfg of configs) {
+        merged = deepMerge(merged, cfg);
+    }
+    return merged;
+}
+function readLoadedConfigs(startDir = process.cwd()) {
+    const loaded = [];
+    for (const candidate of candidateConfigPaths(startDir)) {
+        if (!existsSync(candidate)) {
+            continue;
+        }
+        try {
+            const parsed = TOML.parse(readFileSync(candidate, 'utf8'));
+            loaded.push({ path: candidate, config: parsed });
+        }
+        catch {
+            // Skip malformed configs and continue to the next candidate.
+        }
+    }
+    return loaded;
+}
+function readWorkspaceRootConfigs(startDir = process.cwd()) {
+    // Returned in merge order: global/lowest precedence first, workspace last,
+    // so that callers can fold-merge with workspace overrides winning.
+    return readLoadedConfigs(startDir).map((loaded) => loaded.config).reverse();
+}
+/**
+ * Resolve a path-typed field honoring per-key provenance: returns the value
+ * and the directory of the config.toml that declared it (so callers can
+ * resolve relative values against the correct base).
+ * Searches in workspace→global precedence order; first declarer wins.
+ */
+export function resolveDeclaredFactoryPath(pick, startDir = process.cwd()) {
+    for (const loaded of readLoadedConfigs(startDir)) {
+        const raw = pick(loaded.config);
+        if (typeof raw === 'string' && raw.trim()) {
+            return { value: raw, sourceDir: dirname(loaded.path) };
+        }
+    }
+    return null;
+}
+export function expandFactoryPath(value, sourceDir) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return trimmed;
+    if (trimmed === '~')
+        return homedir();
+    if (trimmed.startsWith('~/'))
+        return join(homedir(), trimmed.slice(2));
+    if (isAbsolute(trimmed))
+        return trimmed;
+    return resolve(sourceDir, trimmed);
+}
+export function getWorkspaceConfigPath(startDir = process.cwd()) {
+    const globalPrefix = `${resolve(homedir(), '.enact')}/`;
+    for (const candidate of candidateConfigPaths(startDir)) {
+        if (existsSync(candidate) && !candidate.startsWith(globalPrefix)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+export function getWorkspaceRootDir(startDir = process.cwd()) {
+    const configPath = getWorkspaceConfigPath(startDir);
+    if (!configPath) {
+        throw new Error('Workspace config.toml not found');
+    }
+    return dirname(configPath);
+}
+function resolveWorkspaceRootOrFallback(startDir = process.cwd()) {
+    const configPath = getWorkspaceConfigPath(startDir);
+    return configPath ? dirname(configPath) : resolve(startDir);
+}
+export function getWorkspaceFactoryPort(startDir = process.cwd()) {
+    // Read from the merged config so a local config.toml overrides the global base.
+    const port = readWorkspaceRootConfig(startDir)?.factory?.['port'];
+    return typeof port === 'number' ? port : null;
+}
+export function getWorkspaceFactoryDashPort(startDir = process.cwd()) {
+    // Read from the merged config so a local config.toml overrides the global base.
+    const port = readWorkspaceRootConfig(startDir)?.factory?.['dash_port'];
+    return typeof port === 'number' ? port : null;
+}
+export function requireWorkspaceFactoryPort(startDir = process.cwd()) {
+    return getWorkspaceFactoryPort(startDir) ?? 43210;
+}
+export function requireWorkspaceFactoryDashPort(startDir = process.cwd()) {
+    return getWorkspaceFactoryDashPort(startDir) ?? 43211;
+}
+/**
+ * The single canonical UI port for the dashboard web server (43206 dev / 53206 prod).
+ *
+ * Both `enact-factory dash` and `enact-factory start` (the daemon) bind this port
+ * via `startWebServer`, and every client that talks to the dashboard over HTTP (the
+ * CLI exec handler, the chat TUI) connects to it.
+ *
+ * Resolution order (workspace-merged config wins):
+ *   1. `[factory].port`      — the canonical factory port (preferred)
+ *   2. `[factory].dash_port` — legacy key retained as fallback for old configs only
+ *   3. 43206                 — built-in default matching the enact-docs port registry
+ *
+ * `dash_port` is no longer written to new configs; it is only read as a fallback so
+ * that existing installations with only `dash_port` set keep working without changes.
+ */
+export function getWorkspaceUiPort(startDir = process.cwd()) {
+    return getWorkspaceFactoryPort(startDir) ?? getWorkspaceFactoryDashPort(startDir);
+}
+export function requireWorkspaceUiPort(startDir = process.cwd()) {
+    return getWorkspaceUiPort(startDir) ?? 43206;
+}
+export function requireWorkspaceFactoryWorkItemStateFile(startDir = process.cwd()) {
+    const declared = resolveDeclaredFactoryPath((cfg) => cfg.factory?.['workitem_state_file'], startDir);
+    if (!declared) {
+        return join(resolveWorkspaceRootOrFallback(startDir), '.enact', 'factory', 'state', 'workitem-state.json');
+    }
+    return expandFactoryPath(declared.value, declared.sourceDir);
+}
+export function requireWorkspaceFactoryStorage(startDir = process.cwd()) {
+    const declared = resolveDeclaredFactoryPath((cfg) => cfg.factory?.['storage'], startDir);
+    if (!declared) {
+        throw new Error('Missing [factory].storage in workspace config.toml');
+    }
+    return expandFactoryPath(declared.value, declared.sourceDir);
+}
+export function requireWorkspaceOperatorStorage(startDir = process.cwd()) {
+    const declared = resolveDeclaredFactoryPath((cfg) => cfg.operator?.['storage'], startDir);
+    if (!declared) {
+        throw new Error('Missing [operator].storage in workspace config.toml');
+    }
+    return expandFactoryPath(declared.value, declared.sourceDir);
+}
+export function requireWorkspaceContextBin() {
+    const value = readWorkspaceRootConfig()?.context?.['bin'];
+    if (typeof value === 'string' && value.trim()) {
+        return value;
+    }
+    throw new Error('Missing [context].bin in workspace config.toml');
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function deepMerge(base, overlay) {
+    const out = { ...base };
+    for (const [key, value] of Object.entries(overlay)) {
+        const existing = out[key];
+        if (isRecord(existing) && isRecord(value)) {
+            out[key] = deepMerge(existing, value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=workspaceConfig.js.map

package/dist/core/workspaceConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceConfig.js","sourceRoot":"","sources":["../../src/core/workspaceConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,aAAa,CAAC;AA2B/B,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC;AACnF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACpD,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,IAAI,EAAE,CAAC;QACZ,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,cAAc,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,OAAO,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,MAAM,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,GAAyC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAA6B,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACjD,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAwB,CAAC;YAClF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACxD,2EAA2E;IAC3E,mEAAmE;IACnE,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAA2C,EAC3C,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAExB,KAAK,MAAM,MAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,SAAiB;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,YAAY,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC;IACxD,KAAK,MAAM,SAAS,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,8BAA8B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9D,gFAAgF;IAChF,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAClE,gFAAgF;IAChF,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC;IACvE,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAClE,OAAO,uBAAuB,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACtE,OAAO,2BAA2B,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACzD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,IAAI,2BAA2B,CAAC,QAAQ,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC7D,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IAC/E,MAAM,QAAQ,GAAG,0BAA0B,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,8BAA8B,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACrE,MAAM,QAAQ,GAAG,0BAA0B,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;IACtE,MAAM,QAAQ,GAAG,0BAA0B,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,KAAK,GAAG,uBAAuB,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAAoC,IAAO,EAAE,OAAU;IACvE,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,18 @@
+export interface DoctorCheck {
+    id: string;
+    ok: boolean;
+    detail: string;
+}
+export interface FactoryDoctorReport {
+    ok: boolean;
+    root: string;
+    checks: DoctorCheck[];
+    advisories: string[];
+}
+export declare class MissingComponentError extends Error {
+    components: string[];
+    constructor(components: string[]);
+}
+export declare function runDoctor(root?: string): FactoryDoctorReport;
+export declare function assertDoctorHealthy(root?: string): FactoryDoctorReport;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,UAAU,EAAE,MAAM,EAAE,CAAC;gBAET,UAAU,EAAE,MAAM,EAAE;CAKjC;AAED,wBAAgB,SAAS,CAAC,IAAI,SAAuB,GAAG,mBAAmB,CAe1E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,SAAuB,GAAG,mBAAmB,CAMpF"}

package/dist/doctor.js

@@ -0,0 +1,34 @@
+import { resolveFactoryRoot } from './factory/paths.js';
+import { readFactoryHookStatus } from './hooks.js';
+export class MissingComponentError extends Error {
+    components;
+    constructor(components) {
+        super(`MissingComponent: ${components.join(', ')}`);
+        this.name = 'MissingComponent';
+        this.components = components;
+    }
+}
+export function runDoctor(root = resolveFactoryRoot()) {
+    const hookStatus = readFactoryHookStatus(root);
+    const checks = [
+        { id: 'repo-hook-config', ok: hookStatus.hookInstalled, detail: hookStatus.configPath },
+        { id: 'hook-registry', ok: hookStatus.registryInstalled, detail: hookStatus.registryPath },
+    ];
+    const advisories = [
+        'Host plugin delivery is owned by enact-extensions. Install with `enact-extensions install enact-factory --platform codex|claude|cursor|all` as needed.',
+    ];
+    return {
+        ok: checks.every((check) => check.ok),
+        root,
+        checks,
+        advisories,
+    };
+}
+export function assertDoctorHealthy(root = resolveFactoryRoot()) {
+    const report = runDoctor(root);
+    if (!report.ok) {
+        throw new MissingComponentError(report.checks.filter((check) => !check.ok).map((check) => check.id));
+    }
+    return report;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAenD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,UAAU,CAAW;IAErB,YAAY,UAAoB;QAC9B,KAAK,CAAC,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,IAAI,GAAG,kBAAkB,EAAE;IACnD,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAkB;QAC5B,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE;QACvF,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,CAAC,YAAY,EAAE;KAC3F,CAAC;IACF,MAAM,UAAU,GAAG;QACjB,wJAAwJ;KACzJ,CAAC;IACF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI;QACJ,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAI,GAAG,kBAAkB,EAAE;IAC7D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACvG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/factory/activeSkill.d.ts

@@ -0,0 +1,11 @@
+export interface FactoryActiveSkillState {
+    activeSkill: string | null;
+    activatedAt: string | null;
+    activatedBy: string | null;
+}
+export declare function factoryActiveSkillFile(root: string): string;
+export declare function readFactoryActiveSkill(root: string): FactoryActiveSkillState;
+export declare function writeFactoryActiveSkill(root: string, state: FactoryActiveSkillState): FactoryActiveSkillState;
+export declare function activateFactorySkill(root: string, skill: string, activatedBy: string): FactoryActiveSkillState;
+export declare function deactivateFactorySkill(root: string): FactoryActiveSkillState;
+//# sourceMappingURL=activeSkill.d.ts.map

package/dist/factory/activeSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeSkill.d.ts","sourceRoot":"","sources":["../../src/factory/activeSkill.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAQD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAa5E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,uBAAuB,CAK7G;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAM9G;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAE5E"}

package/dist/factory/activeSkill.js

@@ -0,0 +1,44 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { factoryPath } from '../factory/paths.js';
+const DEFAULT_STATE = {
+    activeSkill: null,
+    activatedAt: null,
+    activatedBy: null,
+};
+export function factoryActiveSkillFile(root) {
+    return factoryPath(root, 'state', 'factory-active-skill.json');
+}
+export function readFactoryActiveSkill(root) {
+    const path = factoryActiveSkillFile(root);
+    if (!existsSync(path))
+        return { ...DEFAULT_STATE };
+    try {
+        const raw = JSON.parse(readFileSync(path, 'utf8'));
+        return {
+            activeSkill: typeof raw.activeSkill === 'string' ? raw.activeSkill : null,
+            activatedAt: typeof raw.activatedAt === 'string' ? raw.activatedAt : null,
+            activatedBy: typeof raw.activatedBy === 'string' ? raw.activatedBy : null,
+        };
+    }
+    catch {
+        return { ...DEFAULT_STATE };
+    }
+}
+export function writeFactoryActiveSkill(root, state) {
+    const path = factoryActiveSkillFile(root);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(state, null, 2), 'utf8');
+    return state;
+}
+export function activateFactorySkill(root, skill, activatedBy) {
+    return writeFactoryActiveSkill(root, {
+        activeSkill: skill,
+        activatedAt: new Date().toISOString(),
+        activatedBy,
+    });
+}
+export function deactivateFactorySkill(root) {
+    return writeFactoryActiveSkill(root, { ...DEFAULT_STATE });
+}
+//# sourceMappingURL=activeSkill.js.map

package/dist/factory/activeSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeSkill.js","sourceRoot":"","sources":["../../src/factory/activeSkill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjD,MAAM,aAAa,GAA4B;IAC7C,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,2BAA2B,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAqC,CAAC;QACvF,OAAO;YACL,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;YACzE,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;YACzE,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;SAC1E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,KAA8B;IAClF,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa,EAAE,WAAmB;IACnF,OAAO,uBAAuB,CAAC,IAAI,EAAE;QACnC,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,WAAW;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,uBAAuB,CAAC,IAAI,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;AAC7D,CAAC"}