@amsterdamdatalabs/enact-factory 0.1.1

package/dist/core/laneExecutionState.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare const ActiveOperatorLaneSchema: z.ZodEnum<{
+    team: "team";
+    autopilot: "autopilot";
+    ralph: "ralph";
+    ultrawork: "ultrawork";
+}>;
+export type ActiveOperatorLane = z.infer<typeof ActiveOperatorLaneSchema>;
+/**
+ * Canonical runtime shape for an active operator lane session.
+ *
+ * externalWorkItemId is optional — a manually-started lane with no AzDo
+ * linkage is fully valid. taskId is always present for active sessions, and
+ * subtaskIds captures lane-owned decomposition beneath that active task.
+ */
+export declare const LaneExecutionStateSchema: z.ZodObject<{
+    operatorLane: z.ZodEnum<{
+        team: "team";
+        autopilot: "autopilot";
+        ralph: "ralph";
+        ultrawork: "ultrawork";
+    }>;
+    sessionId: z.ZodString;
+    externalWorkItemId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodString;
+    subtaskIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type LaneExecutionState = z.infer<typeof LaneExecutionStateSchema>;
+//# sourceMappingURL=laneExecutionState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"laneExecutionState.d.ts","sourceRoot":"","sources":["../../src/core/laneExecutionState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,wBAAwB;;;;;EAA0D,CAAA;AAC/F,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAMnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/core/laneExecutionState.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { OperatorLaneSchema } from '../workItems/schema.js';
+export const ActiveOperatorLaneSchema = OperatorLaneSchema.exclude(['manual', 'none']);
+/**
+ * Canonical runtime shape for an active operator lane session.
+ *
+ * externalWorkItemId is optional — a manually-started lane with no AzDo
+ * linkage is fully valid. taskId is always present for active sessions, and
+ * subtaskIds captures lane-owned decomposition beneath that active task.
+ */
+export const LaneExecutionStateSchema = z.object({
+    operatorLane: ActiveOperatorLaneSchema,
+    sessionId: z.string(),
+    externalWorkItemId: z.string().optional(),
+    taskId: z.string(),
+    subtaskIds: z.array(z.string()),
+});
+//# sourceMappingURL=laneExecutionState.js.map

package/dist/core/laneExecutionState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"laneExecutionState.js","sourceRoot":"","sources":["../../src/core/laneExecutionState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAU,CAAC,CAAA;AAG/F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,YAAY,EAAE,wBAAwB;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAChC,CAAC,CAAA"}

package/dist/core/laneStatus.d.ts

@@ -0,0 +1,49 @@
+import { type FactoryAssignment } from '../factory/assignment.js';
+export interface LaneStatusEntry {
+    workItemId: string;
+    workItemIdentifier?: string;
+    title?: string;
+    operatorLane?: string;
+    executionStatus?: string;
+    assignmentStatus?: FactoryAssignment['status'];
+    host?: FactoryAssignment['host'];
+    repoRoot?: string;
+    projectId?: string;
+    projectName?: string;
+    branchName?: string;
+    worktreePath?: string;
+    ownerAgent?: string;
+    sessionId?: string;
+    pid?: number;
+    dispatcher?: FactoryAssignment['dispatcher'];
+    paseoAgentId?: string;
+    paseoProvider?: string;
+    paseoMode?: string;
+    paseoCwd?: string;
+    paseoWorktree?: string;
+    paseoStatus?: FactoryAssignment['paseoStatus'];
+    paseoLastCheckedAt?: string;
+    paseoSummary?: string;
+    updatedAt?: string;
+}
+export interface LaneStatusTerminalSession {
+    sessionId: string;
+    cwd: string;
+    shell: string;
+    cols: number;
+    rows: number;
+    clientCount: number;
+    exited: boolean;
+}
+export interface LaneStatusSummary {
+    totalLanes: number;
+    activeAssignments: number;
+    activeTerminalSessions: number;
+}
+export interface LaneStatusResponse {
+    lanes: LaneStatusEntry[];
+    terminalSessions: LaneStatusTerminalSession[];
+    summary: LaneStatusSummary;
+}
+export declare function getLaneStatusSnapshot(): LaneStatusResponse;
+//# sourceMappingURL=laneStatus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"laneStatus.d.ts","sourceRoot":"","sources":["../../src/core/laneStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIlF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,gBAAgB,EAAE,yBAAyB,EAAE,CAAC;IAC9C,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AA4FD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAgE1D"}

package/dist/core/laneStatus.js

@@ -0,0 +1,153 @@
+import { resolveFactoryRoot } from '../factory/paths.js';
+import { listAssignments } from '../factory/assignment.js';
+import { listWorkItemStates } from '../workItemState/store.js';
+import { getTerminalSessionInfo } from '../support/terminalBridge.js';
+function isActiveExecutionStatus(status) {
+    return !['backlog', 'done'].includes(status);
+}
+function isActiveAssignmentStatus(status) {
+    return status === 'active' || status === 'stuck';
+}
+function isAssignmentRelevant(status) {
+    return status === 'active' || status === 'stuck';
+}
+function toTerminalSession(session) {
+    return {
+        sessionId: session.sessionId,
+        cwd: session.cwd,
+        shell: session.shell,
+        cols: session.cols,
+        rows: session.rows,
+        clientCount: session.clientCount,
+        exited: session.exited,
+    };
+}
+function fromState(state) {
+    const executionStatus = state.execution.status;
+    const updatedAt = state.updatedAt;
+    return {
+        workItemId: state.workItemId,
+        workItemIdentifier: state.workItemIdentifier,
+        title: state.title,
+        operatorLane: state.operatorLane,
+        executionStatus,
+        projectId: state.projectId,
+        projectName: state.projectName,
+        branchName: state.worktree.branchName,
+        worktreePath: state.worktree.worktreePath,
+        ownerAgent: state.worktree.ownerAgent,
+        sessionId: state.execution.lastSessionId,
+        updatedAt,
+    };
+}
+function enrichFromAssignment(target, assignment) {
+    target.assignmentStatus = assignment.status;
+    target.host = assignment.host;
+    target.repoRoot = assignment.repoRoot;
+    target.operatorLane = target.operatorLane ?? assignment.operatorLane;
+    target.sessionId = assignment.sessionId ?? target.sessionId;
+    target.pid = assignment.pid;
+    if (assignment.dispatcher)
+        target.dispatcher = assignment.dispatcher;
+    if (assignment.paseoAgentId)
+        target.paseoAgentId = assignment.paseoAgentId;
+    if (assignment.paseoProvider)
+        target.paseoProvider = assignment.paseoProvider;
+    if (assignment.paseoMode)
+        target.paseoMode = assignment.paseoMode;
+    if (assignment.paseoCwd)
+        target.paseoCwd = assignment.paseoCwd;
+    if (assignment.paseoWorktree)
+        target.paseoWorktree = assignment.paseoWorktree;
+    if (assignment.paseoStatus)
+        target.paseoStatus = assignment.paseoStatus;
+    if (assignment.paseoLastCheckedAt)
+        target.paseoLastCheckedAt = assignment.paseoLastCheckedAt;
+    if (assignment.paseoSummary)
+        target.paseoSummary = assignment.paseoSummary;
+    if (!target.updatedAt || target.updatedAt.localeCompare(assignment.startedAt) < 0) {
+        target.updatedAt = assignment.startedAt;
+    }
+}
+function safeListWorkItemStates() {
+    try {
+        return listWorkItemStates();
+    }
+    catch {
+        return [];
+    }
+}
+function safeListAssignments(factoryRoot) {
+    try {
+        return listAssignments(factoryRoot);
+    }
+    catch {
+        return [];
+    }
+}
+function safeGetTerminalSessions() {
+    try {
+        return getTerminalSessionInfo();
+    }
+    catch {
+        return [];
+    }
+}
+export function getLaneStatusSnapshot() {
+    const workItemStates = safeListWorkItemStates();
+    const terminalSessions = safeGetTerminalSessions().map(toTerminalSession);
+    const activeTerminalSessions = terminalSessions.filter((session) => !session.exited).length;
+    const lanesByWorkItem = new Map();
+    for (const state of workItemStates) {
+        if (!isActiveExecutionStatus(state.execution.status)) {
+            continue;
+        }
+        lanesByWorkItem.set(state.workItemId, fromState(state));
+    }
+    let factoryRoot = '';
+    try {
+        factoryRoot = resolveFactoryRoot();
+    }
+    catch {
+        factoryRoot = '';
+    }
+    const assignments = factoryRoot ? safeListAssignments(factoryRoot) : [];
+    const relevantAssignments = assignments
+        .filter((assignment) => isAssignmentRelevant(assignment.status))
+        .sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+    for (const assignment of relevantAssignments) {
+        const existing = lanesByWorkItem.get(assignment.workItemId);
+        if (existing) {
+            enrichFromAssignment(existing, assignment);
+            continue;
+        }
+        const entry = {
+            workItemId: assignment.workItemId,
+            operatorLane: assignment.operatorLane,
+            assignmentStatus: assignment.status,
+            host: assignment.host,
+            repoRoot: assignment.repoRoot,
+            sessionId: assignment.sessionId,
+            pid: assignment.pid,
+            updatedAt: assignment.startedAt,
+        };
+        enrichFromAssignment(entry, assignment);
+        lanesByWorkItem.set(assignment.workItemId, entry);
+    }
+    const lanes = Array.from(lanesByWorkItem.values()).sort((a, b) => {
+        const aTs = Date.parse(a.updatedAt ?? '') || 0;
+        const bTs = Date.parse(b.updatedAt ?? '') || 0;
+        return bTs - aTs;
+    });
+    const activeAssignments = lanes.filter((lane) => isActiveAssignmentStatus(lane.assignmentStatus ?? 'completed')).length;
+    return {
+        lanes,
+        terminalSessions,
+        summary: {
+            totalLanes: lanes.length,
+            activeAssignments,
+            activeTerminalSessions,
+        },
+    };
+}
+//# sourceMappingURL=laneStatus.js.map

package/dist/core/laneStatus.js.map

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

package/dist/core/prSidecar.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Tracks the state of the PR sidecar process for a single work item.
+ *
+ * The sidecar state is **independent** of `ExecutionPhase`.
+ * A work item can be in the `done` execution phase while the sidecar is
+ * still `none` (no PR ever opened), or `pending` (PR creation scheduled
+ * but not yet triggered).  These two state machines never gate each other:
+ *
+ * - Execution can complete (`done`) with `PrSidecarState.status === 'none'`.
+ * - A PR can be `opened` or `merged` while execution is in any phase.
+ * - PR failure (`failed`) does not block the work item from reaching `done`.
+ *
+ * Status progression:
+ * - `none`    → no PR has been requested or created
+ * - `pending` → PR creation has been queued (sidecar trigger fired, not yet opened)
+ * - `opened`  → PR is open in the SCM provider
+ * - `merged`  → PR has been merged into the target branch
+ * - `closed`  → PR was closed without merging (abandoned or superseded)
+ * - `failed`  → PR creation or automation step failed; needs operator attention
+ */
+export interface PrSidecarState {
+    /** Current PR sidecar status. */
+    status: 'none' | 'pending' | 'opened' | 'merged' | 'closed' | 'failed';
+    /**
+     * Target branch for this PR (e.g. `"develop"` or `"main"`).
+     *
+     * Note: `"main"` is an allowed target for the sidecar (operator-triggered
+     * promotion) even though Wave 3 inner-loop merges target `develop` only.
+     */
+    target: 'develop' | 'main' | string;
+    /**
+     * URL of the opened or merged PR.
+     * Present when `status` is `opened`, `merged`, or `closed`.
+     * Absent when `status` is `none`, `pending`, or `failed`.
+     */
+    prUrl?: string;
+}
+/**
+ * Policy that governs when and how the PR sidecar may activate.
+ *
+ * - `triggeredBy: 'manual'`     → operator explicitly requests PR creation
+ * - `triggeredBy: 'phase:done'` → sidecar fires automatically when the work
+ *   item's `ExecutionPhase` transitions to `done`
+ *
+ * `allowedTargets` restricts which target branches the sidecar may open a PR
+ * against.  Requests targeting a branch not in this list must be rejected.
+ * An empty array means the policy is effectively disabled.
+ *
+ * @example
+ * // Manual-only policy — operator must request PR explicitly:
+ * const policy: PrSidecarPolicy = {
+ *   triggeredBy: 'manual',
+ *   allowedTargets: ['develop'],
+ * };
+ *
+ * // Auto-trigger on done, allow promotion to both develop and main:
+ * const policy: PrSidecarPolicy = {
+ *   triggeredBy: 'phase:done',
+ *   allowedTargets: ['develop', 'main'],
+ * };
+ */
+export interface PrSidecarPolicy {
+    /**
+     * What causes the sidecar to activate.
+     *
+     * - `'manual'`     → only activates on explicit operator instruction
+     * - `'phase:done'` → activates automatically when execution phase reaches `done`
+     */
+    triggeredBy: 'manual' | 'phase:done';
+    /**
+     * List of branch names the sidecar is allowed to target.
+     * Must be non-empty for the sidecar to be usable.
+     */
+    allowedTargets: string[];
+}
+/**
+ * Return `true` when a `PrSidecarState` represents an active PR
+ * (i.e., the PR exists in the SCM system and is not yet closed or failed).
+ *
+ * @example
+ * isPrActive({ status: 'opened', target: 'develop' }) // true
+ * isPrActive({ status: 'merged', target: 'develop' }) // false
+ * isPrActive({ status: 'none',   target: 'develop' }) // false
+ */
+export declare function isPrActive(state: PrSidecarState): boolean;
+/**
+ * Return `true` when the sidecar policy allows opening a PR against
+ * the given `targetBranch`.
+ *
+ * @example
+ * const policy: PrSidecarPolicy = { triggeredBy: 'manual', allowedTargets: ['develop'] };
+ * isPrTargetAllowed(policy, 'develop') // true
+ * isPrTargetAllowed(policy, 'main')    // false
+ */
+export declare function isPrTargetAllowed(policy: PrSidecarPolicy, targetBranch: string): boolean;
+//# sourceMappingURL=prSidecar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prSidecar.d.ts","sourceRoot":"","sources":["../../src/core/prSidecar.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvE;;;;;OAKG;IACH,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,WAAW,EAAE,QAAQ,GAAG,YAAY,CAAC;IACrC;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAExF"}

package/dist/core/prSidecar.js

@@ -0,0 +1,33 @@
+// ============================================
+// EnactFactory - PR Sidecar Contract (Wave 3)
+// State and policy types for pull-request sidecar
+// behavior, decoupled from the core execution lifecycle.
+// ============================================
+// ---------------------------------------------------------------------------
+// 3. HELPERS
+// ---------------------------------------------------------------------------
+/**
+ * Return `true` when a `PrSidecarState` represents an active PR
+ * (i.e., the PR exists in the SCM system and is not yet closed or failed).
+ *
+ * @example
+ * isPrActive({ status: 'opened', target: 'develop' }) // true
+ * isPrActive({ status: 'merged', target: 'develop' }) // false
+ * isPrActive({ status: 'none',   target: 'develop' }) // false
+ */
+export function isPrActive(state) {
+    return state.status === 'opened' || state.status === 'pending';
+}
+/**
+ * Return `true` when the sidecar policy allows opening a PR against
+ * the given `targetBranch`.
+ *
+ * @example
+ * const policy: PrSidecarPolicy = { triggeredBy: 'manual', allowedTargets: ['develop'] };
+ * isPrTargetAllowed(policy, 'develop') // true
+ * isPrTargetAllowed(policy, 'main')    // false
+ */
+export function isPrTargetAllowed(policy, targetBranch) {
+    return policy.allowedTargets.includes(targetBranch);
+}
+//# sourceMappingURL=prSidecar.js.map

package/dist/core/prSidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prSidecar.js","sourceRoot":"","sources":["../../src/core/prSidecar.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,8CAA8C;AAC9C,kDAAkD;AAClD,yDAAyD;AACzD,+CAA+C;AAuF/C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAuB,EAAE,YAAoB;IAC7E,OAAO,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/runtimeConfig.d.ts

@@ -0,0 +1,6 @@
+import type { BootstrapFactoryConfig, FactoryConfig, ProjectConfig } from '../core/types.js';
+import type { IWorkItemStore } from '../workItems/sqliteStore.js';
+export declare function resolveProjectConfigs(bootstrapConfig: BootstrapFactoryConfig, store?: IWorkItemStore): Promise<ProjectConfig[]>;
+export declare function resolveRuntimeConfig(bootstrapConfig: BootstrapFactoryConfig, store?: IWorkItemStore): Promise<FactoryConfig>;
+export declare function loadRuntimeConfig(customPath?: string): Promise<FactoryConfig>;
+//# sourceMappingURL=runtimeConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConfig.d.ts","sourceRoot":"","sources":["../../src/core/runtimeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,wBAAsB,qBAAqB,CACzC,eAAe,EAAE,sBAAsB,EACvC,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAa1B;AAED,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,sBAAsB,EACvC,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED,wBAAsB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGnF"}

package/dist/core/runtimeConfig.js

@@ -0,0 +1,24 @@
+import { loadConfig } from '../core/config.js';
+import { getWorkItemStore } from '../workItems/index.js';
+export async function resolveProjectConfigs(bootstrapConfig, store) {
+    if (bootstrapConfig.database.type !== 'postgres') {
+        return bootstrapConfig.projects;
+    }
+    const projectStore = store ?? await getWorkItemStore();
+    let projects = await projectStore.getProjectConfigs();
+    if (projects.length === 0 && bootstrapConfig.projects.length > 0) {
+        projects = await projectStore.seedProjectConfigsIfEmpty(bootstrapConfig.projects);
+    }
+    return projects;
+}
+export async function resolveRuntimeConfig(bootstrapConfig, store) {
+    return {
+        ...bootstrapConfig,
+        projects: await resolveProjectConfigs(bootstrapConfig, store),
+    };
+}
+export async function loadRuntimeConfig(customPath) {
+    const bootstrapConfig = loadConfig(customPath);
+    return resolveRuntimeConfig(bootstrapConfig);
+}
+//# sourceMappingURL=runtimeConfig.js.map

package/dist/core/runtimeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConfig.js","sourceRoot":"","sources":["../../src/core/runtimeConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,eAAuC,EACvC,KAAsB;IAEtB,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjD,OAAO,eAAe,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,IAAI,MAAM,gBAAgB,EAAE,CAAC;IACvD,IAAI,QAAQ,GAAG,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;IAEtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,QAAQ,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,eAAuC,EACvC,KAAsB;IAEtB,OAAO;QACL,GAAG,eAAe;QAClB,QAAQ,EAAE,MAAM,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAmB;IACzD,MAAM,eAAe,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,oBAAoB,CAAC,eAAe,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core/scmProvider.d.ts

@@ -0,0 +1,19 @@
+export interface ScmProvider {
+    kind: 'azureDevOps';
+    cloneUrl(repo: string): string;
+    branchUrl(repo: string, branch: string): string;
+    workItemUrl(repo: string, workItemId: number | string): string;
+    prSidecarSupported(): boolean;
+}
+export declare const azureDevOpsProvider: ScmProvider;
+export declare function azdoSshCloneUrl(repo: string): string;
+export interface AzureDevOpsPrIntent {
+    sourceBranch: string;
+    targetBranch: string;
+    title: string;
+    description: string;
+    workItemRefs: Array<{
+        id: number | string;
+    }>;
+}
+//# sourceMappingURL=scmProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scmProvider.d.ts","sourceRoot":"","sources":["../../src/core/scmProvider.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IAEpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAChD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/D,kBAAkB,IAAI,OAAO,CAAC;CAC/B;AAmBD,eAAO,MAAM,mBAAmB,EAAE,WAkBjC,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C"}

package/dist/core/scmProvider.js

@@ -0,0 +1,38 @@
+// ============================================
+// EnactFactory - SCM Provider Abstraction
+// Azure DevOps (`amsterdamdatalabs/Enact`) only.
+// ============================================
+import { readWorkspaceRootConfig } from '../core/workspaceConfig.js';
+function resolveAzdoBase() {
+    const cfg = readWorkspaceRootConfig();
+    const org = cfg?.factory?.['azdo_org'] ?? 'amsterdamdatalabs';
+    const project = cfg?.factory?.['azdo_project'] ?? 'Enact';
+    return `https://dev.azure.com/${org}/${project}`;
+}
+function resolveAzdoOrg() {
+    const cfg = readWorkspaceRootConfig();
+    return cfg?.factory?.['azdo_org'] ?? 'amsterdamdatalabs';
+}
+function resolveAzdoProject() {
+    const cfg = readWorkspaceRootConfig();
+    return cfg?.factory?.['azdo_project'] ?? 'Enact';
+}
+export const azureDevOpsProvider = {
+    kind: 'azureDevOps',
+    cloneUrl(repo) {
+        return `${resolveAzdoBase()}/_git/${repo}`;
+    },
+    branchUrl(repo, branch) {
+        return `${resolveAzdoBase()}/_git/${repo}?version=GB${branch}`;
+    },
+    workItemUrl(_repo, workItemId) {
+        return `${resolveAzdoBase()}/_workitems/edit/${workItemId}`;
+    },
+    prSidecarSupported() {
+        return true;
+    },
+};
+export function azdoSshCloneUrl(repo) {
+    return `git@ssh.dev.azure.com:v3/${resolveAzdoOrg()}/${resolveAzdoProject()}/${repo}`;
+}
+//# sourceMappingURL=scmProvider.js.map

package/dist/core/scmProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scmProvider.js","sourceRoot":"","sources":["../../src/core/scmProvider.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,0CAA0C;AAC1C,iDAAiD;AACjD,+CAA+C;AAE/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAWpE,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IACtC,MAAM,GAAG,GAAI,GAAG,EAAE,OAA+C,EAAE,CAAC,UAAU,CAAuB,IAAI,mBAAmB,CAAC;IAC7H,MAAM,OAAO,GAAI,GAAG,EAAE,OAA+C,EAAE,CAAC,cAAc,CAAuB,IAAI,OAAO,CAAC;IACzH,OAAO,yBAAyB,GAAG,IAAI,OAAO,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IACtC,OAAQ,GAAG,EAAE,OAA+C,EAAE,CAAC,UAAU,CAAuB,IAAI,mBAAmB,CAAC;AAC1H,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IACtC,OAAQ,GAAG,EAAE,OAA+C,EAAE,CAAC,cAAc,CAAuB,IAAI,OAAO,CAAC;AAClH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,aAAa;IAEnB,QAAQ,CAAC,IAAY;QACnB,OAAO,GAAG,eAAe,EAAE,SAAS,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,MAAc;QACpC,OAAO,GAAG,eAAe,EAAE,SAAS,IAAI,cAAc,MAAM,EAAE,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,UAA2B;QACpD,OAAO,GAAG,eAAe,EAAE,oBAAoB,UAAU,EAAE,CAAC;IAC9D,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,4BAA4B,cAAc,EAAE,IAAI,kBAAkB,EAAE,IAAI,IAAI,EAAE,CAAC;AACxF,CAAC"}

package/dist/core/service.d.ts

@@ -0,0 +1,10 @@
+import type { BootstrapFactoryConfig, AgentStatus } from '../core/types.js';
+/**
+ * Start the service
+ */
+export declare function startService(config: BootstrapFactoryConfig): Promise<void>;
+export declare function pauseAgent(name: string): void;
+export declare function resumeAgent(name: string): void;
+export declare function getAgentStatuses(name?: string): AgentStatus[];
+export declare function stopService(): Promise<void>;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/core/service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EAEtB,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAoCzB;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4NhF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM7C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM9C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAM7D;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAyCjD"}