@pi-orca/core 0.0.2-dev.20260413162335

package/dist/types/lock.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lock file types.
+ * Spec: §3.4 — Lock File Schema
+ */
+/**
+ * Lock file schema.
+ * Spec: §3.4 — Lock File Schema
+ */
+export interface LockInfo {
+    sessionId: string;
+    sessionPath: string;
+    pid: number;
+    acquiredAt: string;
+    agentTemplate?: string;
+}
+//# sourceMappingURL=lock.d.ts.map

package/dist/types/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/types/lock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types/lock.js

@@ -0,0 +1,6 @@
+/**
+ * Lock file types.
+ * Spec: §3.4 — Lock File Schema
+ */
+export {};
+//# sourceMappingURL=lock.js.map

package/dist/types/lock.js.map

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

package/dist/types/message.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Message types.
+ * Spec: §4 — pi-orca-messages Extension
+ */
+import { Labels } from "./labels.js";
+import { Archivable } from "./archivable.js";
+/**
+ * Message file schema (YAML frontmatter).
+ * Spec: §4.4 — Message File Schema
+ */
+export interface Message extends Archivable {
+    id: string;
+    title: string;
+    from: string;
+    to: string;
+    sentAt: string;
+    labels: Labels;
+    archivable: boolean;
+    completedAt: string;
+}
+/**
+ * Inbox reference file schema.
+ * Spec: §4.5 — Inbox Reference File Schema
+ */
+export interface InboxRef {
+    source: string;
+    sentAt: string;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,OAAQ,SAAQ,UAAU;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/message.js

@@ -0,0 +1,6 @@
+/**
+ * Message types.
+ * Spec: §4 — pi-orca-messages Extension
+ */
+export {};
+//# sourceMappingURL=message.js.map

package/dist/types/message.js.map

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

package/dist/types/task.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Task types and state machine.
+ * Spec: §3 — pi-orca-tasks Extension
+ */
+import { Labels } from "./labels.js";
+import { Archivable } from "./archivable.js";
+/**
+ * Task status values.
+ * Spec: §3.2 — Task State Machine
+ */
+export type TaskStatus = "pending" | "in_progress" | "completed" | "failed" | "abandoned" | "blocked";
+/**
+ * Task file schema (YAML frontmatter).
+ * Spec: §3.3 — Task File Schema
+ */
+export interface Task extends Archivable {
+    id: string;
+    title: string;
+    status: TaskStatus;
+    createdAt: string;
+    updatedAt: string;
+    completedAt: string;
+    assignedTo: string;
+    assignedSessionPath: string;
+    dependencies: string[];
+    dependents: string[];
+    blockedReason: string;
+    retryCount: number;
+    labels: Labels;
+    archivable: boolean;
+}
+/**
+ * Valid state transitions for task state machine.
+ * Spec: §3.2
+ */
+export declare const TASK_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;
+/**
+ * Check if a state transition is valid.
+ *
+ * @param from - Current status
+ * @param to - Target status
+ * @returns true if transition is allowed
+ */
+export declare function isValidTransition(from: TaskStatus, to: TaskStatus): boolean;
+//# sourceMappingURL=task.d.ts.map

package/dist/types/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,aAAa,GACb,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,CAAC;AAEd;;;GAGG;AACH,MAAM,WAAW,IAAK,SAAQ,UAAU;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAO7D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAE3E"}

package/dist/types/task.js

@@ -0,0 +1,27 @@
+/**
+ * Task types and state machine.
+ * Spec: §3 — pi-orca-tasks Extension
+ */
+/**
+ * Valid state transitions for task state machine.
+ * Spec: §3.2
+ */
+export const TASK_TRANSITIONS = {
+    pending: ["in_progress", "blocked"],
+    in_progress: ["completed", "failed", "abandoned", "pending"],
+    completed: [],
+    failed: ["pending"],
+    abandoned: ["pending"],
+    blocked: ["pending"],
+};
+/**
+ * Check if a state transition is valid.
+ *
+ * @param from - Current status
+ * @param to - Target status
+ * @returns true if transition is allowed
+ */
+export function isValidTransition(from, to) {
+    return TASK_TRANSITIONS[from].includes(to);
+}
+//# sourceMappingURL=task.js.map

package/dist/types/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsCH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,OAAO,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;IACnC,WAAW,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC;IAC5D,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,OAAO,EAAE,CAAC,SAAS,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,EAAc;IAChE,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/types/team.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Team types and templates.
+ * Spec: §6 — pi-orca-teams Extension
+ */
+import { Labels } from "./labels.js";
+/**
+ * Agent definition within a team template.
+ * Spec: §6.3 — Team Template Schema
+ */
+export interface TeamAgent {
+    template: string;
+    count: number;
+    labels: Labels;
+}
+/**
+ * Task definition within a team template.
+ * Spec: §6.3
+ */
+export interface TeamTask {
+    title: string;
+    labels: Labels;
+    dependencies?: string[];
+    assignTo?: string;
+}
+/**
+ * Team template schema (YAML).
+ * Spec: §6.3 — Team Template Schema
+ */
+export interface TeamTemplate {
+    name: string;
+    description: string;
+    maxDepth: number;
+    maxReplicas: number;
+    agents: TeamAgent[];
+    tasks?: TeamTask[];
+    startupOrder?: ("agents" | "register" | "tasks")[];
+}
+//# sourceMappingURL=team.d.ts.map

package/dist/types/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../src/types/team.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;CACpD"}

package/dist/types/team.js

@@ -0,0 +1,6 @@
+/**
+ * Team types and templates.
+ * Spec: §6 — pi-orca-teams Extension
+ */
+export {};
+//# sourceMappingURL=team.js.map

package/dist/types/team.js.map

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

package/dist/utils/autocomplete.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tree-walking completion resolver for Pi extension commands.
+ *
+ * Pi's `getArgumentCompletions(prefix)` passes the full argument text as
+ * `prefix`, and the selected item's `value` replaces that entire prefix.
+ * This helper reconstructs full-prefix values so preceding tokens are
+ * preserved, and auto-appends trailing spaces when the completed token
+ * has completable children.
+ *
+ * Known Pi TUI limitation: after applying a completion, Pi does not
+ * re-trigger `getArgumentCompletions`. The user must press backspace+space
+ * to reset Pi's autocomplete state and trigger the next completion level.
+ * The trailing space saves one keystroke vs. omitting it (backspace+space
+ * instead of space+backspace+space).
+ */
+export interface CompletionItem {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface CompletionNode {
+    /** Static items at this position. */
+    items?: CompletionItem[];
+    /** Dynamic items via closure (for cached data that changes). */
+    dynamicItems?: () => CompletionItem[];
+    /** If true, this position is free-text — return null (no completions). */
+    freeform?: boolean;
+    /** Child nodes keyed by token value. Use "*" for wildcard (any token). */
+    children?: Record<string, CompletionNode>;
+}
+/**
+ * Resolve completions for a Pi command argument prefix.
+ *
+ * @param prefix - The full argument text after the command name
+ *                 (e.g. `"set fast c"` for `/models set fast c`)
+ * @param tree   - The root CompletionNode describing the command's
+ *                 argument structure
+ * @returns Matching CompletionItem[] with fully-reconstructed values,
+ *          or null when no completions are available
+ */
+export declare function resolveCompletions(prefix: string, tree: CompletionNode): CompletionItem[] | null;
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/utils/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../src/utils/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,cAAc,EAAE,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,cAAc,EAAE,GAAG,IAAI,CAuEzB"}

package/dist/utils/autocomplete.js

@@ -0,0 +1,111 @@
+/**
+ * Tree-walking completion resolver for Pi extension commands.
+ *
+ * Pi's `getArgumentCompletions(prefix)` passes the full argument text as
+ * `prefix`, and the selected item's `value` replaces that entire prefix.
+ * This helper reconstructs full-prefix values so preceding tokens are
+ * preserved, and auto-appends trailing spaces when the completed token
+ * has completable children.
+ *
+ * Known Pi TUI limitation: after applying a completion, Pi does not
+ * re-trigger `getArgumentCompletions`. The user must press backspace+space
+ * to reset Pi's autocomplete state and trigger the next completion level.
+ * The trailing space saves one keystroke vs. omitting it (backspace+space
+ * instead of space+backspace+space).
+ */
+// ─── helpers ────────────────────────────────────────────────────────────────
+/**
+ * Returns true when a node has completable content — items, dynamicItems,
+ * or non-freeform children.
+ */
+function isCompletable(node) {
+    if (node.freeform)
+        return false;
+    if (node.items && node.items.length > 0)
+        return true;
+    if (node.dynamicItems)
+        return true;
+    if (node.children)
+        return true;
+    return false;
+}
+/**
+ * Look up a child node: exact match first, then wildcard "*".
+ */
+function findChild(node, token) {
+    return node.children?.[token] ?? node.children?.["*"];
+}
+// ─── core ───────────────────────────────────────────────────────────────────
+/**
+ * Resolve completions for a Pi command argument prefix.
+ *
+ * @param prefix - The full argument text after the command name
+ *                 (e.g. `"set fast c"` for `/models set fast c`)
+ * @param tree   - The root CompletionNode describing the command's
+ *                 argument structure
+ * @returns Matching CompletionItem[] with fully-reconstructed values,
+ *          or null when no completions are available
+ */
+export function resolveCompletions(prefix, tree) {
+    const trimmed = prefix.trimStart();
+    const tokens = trimmed
+        ? trimmed.split(/\s+/).filter((t) => t.length > 0)
+        : [];
+    // Trailing space means the last token is fully typed — all tokens are
+    // "completed" and we're starting a new (empty) position.
+    const hasTrailingSpace = trimmed.length > 0 && prefix.endsWith(" ");
+    // Split into completed tokens and the partial filter token
+    let completedTokens;
+    let filter;
+    if (hasTrailingSpace) {
+        completedTokens = tokens;
+        filter = "";
+    }
+    else if (tokens.length === 0) {
+        completedTokens = [];
+        filter = "";
+    }
+    else {
+        completedTokens = tokens.slice(0, -1);
+        filter = tokens[tokens.length - 1];
+    }
+    // Walk completed tokens through the tree
+    let current = tree;
+    const resolvedTokens = [];
+    for (const token of completedTokens) {
+        const child = findChild(current, token);
+        if (!child)
+            return null; // unknown path
+        resolvedTokens.push(token);
+        current = child;
+    }
+    // At the current node, check for freeform
+    if (current.freeform)
+        return null;
+    // Gather items from dynamicItems or static items
+    const rawItems = current.dynamicItems?.() ?? current.items ?? [];
+    if (rawItems.length === 0)
+        return null;
+    // Substring filter across value, label, and description
+    const lowerFilter = filter.toLowerCase();
+    const filtered = lowerFilter
+        ? rawItems.filter((item) => item.value.toLowerCase().includes(lowerFilter) ||
+            item.label.toLowerCase().includes(lowerFilter) ||
+            (item.description?.toLowerCase().includes(lowerFilter) ?? false))
+        : rawItems;
+    if (filtered.length === 0)
+        return null;
+    // Reconstruct values with full prefix and optional trailing space
+    const tokenPrefix = resolvedTokens.length > 0 ? resolvedTokens.join(" ") + " " : "";
+    return filtered.map((item) => {
+        // Append trailing space when the item has a completable child node
+        const childNode = findChild(current, item.value);
+        const trailingSpace = childNode && isCompletable(childNode) ? " " : "";
+        return {
+            value: tokenPrefix + item.value + trailingSpace,
+            label: item.label,
+            description: item.description,
+        };
+    });
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/utils/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../src/utils/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAqBH,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAoB;IACzC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAChB,IAAoB,EACpB,KAAa;IAEb,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,IAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO;QACpB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAClD,CAAC,CAAC,EAAE,CAAC;IAEP,sEAAsE;IACtE,yDAAyD;IACzD,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEpE,2DAA2D;IAC3D,IAAI,eAAyB,CAAC;IAC9B,IAAI,MAAc,CAAC;IAEnB,IAAI,gBAAgB,EAAE,CAAC;QACrB,eAAe,GAAG,MAAM,CAAC;QACzB,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,eAAe,GAAG,EAAE,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;SAAM,CAAC;QACN,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,yCAAyC;IACzC,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,CAAC,eAAe;QACxC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAElC,iDAAiD;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,wDAAwD;IACxD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,WAAW;QAC1B,CAAC,CAAC,QAAQ,CAAC,MAAM,CACb,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC9C,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,CACnE;QACH,CAAC,CAAC,QAAQ,CAAC;IAEb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,kEAAkE;IAClE,MAAM,WAAW,GACf,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,mEAAmE;QACnE,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAEvE,OAAO;YACL,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC,KAAK,GAAG,aAAa;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared Orca configuration loader with bootstrap support.
+ * Spec: §2.2 — Shared Configuration
+ */
+import { OrcaConfig } from "../types/config.js";
+/**
+ * Load and merge the Orca shared configuration.
+ * Reads user-level and project-level config.yaml, merges them (project overrides user).
+ * On first access, creates user-level config.yaml with defaults.
+ * Spec: §2.2
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @param notify - Whether to emit console notification on bootstrap
+ * @returns Merged OrcaConfig
+ */
+export declare function loadOrcaConfig(projectRoot?: string, notify?: boolean): Promise<OrcaConfig>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,UAAU,EAA+B,MAAM,oBAAoB,CAAC;AAwC7E;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,UAAO,GACZ,OAAO,CAAC,UAAU,CAAC,CA6BrB"}

package/dist/utils/config-loader.js

@@ -0,0 +1,81 @@
+/**
+ * Shared Orca configuration loader with bootstrap support.
+ * Spec: §2.2 — Shared Configuration
+ */
+import { readFile, writeFile } from "fs/promises";
+import { existsSync } from "fs";
+import { join } from "path";
+import YAML from "yaml";
+import { DEFAULT_CONFIG, mergeConfig } from "../types/config.js";
+import { ensureDir } from "./filesystem.js";
+import { getUserOrcaDir, getProjectOrcaDir } from "./path.js";
+/**
+ * Read a YAML config file, returning null if not found.
+ */
+async function readConfigFile(filePath) {
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(filePath, "utf-8");
+        return YAML.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Append missing sections with defaults to a config file.
+ */
+async function appendMissingDefaults(filePath, existing) {
+    let changed = false;
+    const merged = { ...existing };
+    if (!merged.polling) {
+        merged.polling = { ...DEFAULT_CONFIG.polling };
+        changed = true;
+    }
+    if (!merged.parentLiveness) {
+        merged.parentLiveness = { ...DEFAULT_CONFIG.parentLiveness };
+        changed = true;
+    }
+    if (changed) {
+        await writeFile(filePath, YAML.stringify(merged), "utf-8");
+    }
+}
+/**
+ * Load and merge the Orca shared configuration.
+ * Reads user-level and project-level config.yaml, merges them (project overrides user).
+ * On first access, creates user-level config.yaml with defaults.
+ * Spec: §2.2
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @param notify - Whether to emit console notification on bootstrap
+ * @returns Merged OrcaConfig
+ */
+export async function loadOrcaConfig(projectRoot, notify = true) {
+    const userConfigPath = join(getUserOrcaDir(), "config.yaml");
+    const projectConfigPath = join(getProjectOrcaDir(projectRoot), "config.yaml");
+    // Bootstrap user config if missing
+    let userConfig = {};
+    if (!existsSync(userConfigPath)) {
+        await ensureDir(getUserOrcaDir());
+        const defaultContent = YAML.stringify(DEFAULT_CONFIG);
+        await writeFile(userConfigPath, defaultContent, "utf-8");
+        userConfig = { ...DEFAULT_CONFIG };
+        if (notify) {
+            console.log(`Created default config at ${userConfigPath} — edit to customize.`);
+        }
+    }
+    else {
+        const loaded = await readConfigFile(userConfigPath);
+        if (loaded) {
+            // Append missing sections
+            await appendMissingDefaults(userConfigPath, loaded);
+            userConfig = loaded;
+        }
+    }
+    // Load project config if it exists (not bootstrapped)
+    const projectConfig = await readConfigFile(projectConfigPath);
+    return mergeConfig(userConfig, projectConfig ?? undefined);
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/utils/config-loader.js.map

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

package/dist/utils/dag.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DAG and topological sort utilities.
+ * Spec: §3.5 — Dependency Validation
+ */
+/**
+ * Detect if adding a dependency would create a cycle.
+ * Uses DFS to detect cycles.
+ * Spec: §3.5 — Cycle Detection
+ *
+ * @param taskId - Task that would receive the new dependency
+ * @param newDependency - Task ID to add as dependency
+ * @param allDependencies - Current dependency graph (task -> dependencies)
+ * @returns Cycle path if cycle detected, null otherwise
+ */
+export declare function detectCycle(taskId: string, newDependency: string, allDependencies: Map<string, string[]>): string[] | null;
+/**
+ * Get all transitive dependents of a task (tasks that depend on it, directly or indirectly).
+ * Spec: §3.5 — Transitive Dependency Walking
+ *
+ * @param taskId - Task ID
+ * @param allDependents - Dependency graph (task -> dependents)
+ * @returns Set of transitive dependent task IDs
+ */
+export declare function getTransitiveDependents(taskId: string, allDependents: Map<string, string[]>): string[];
+/**
+ * Get all transitive dependencies of a task (tasks it depends on, directly or indirectly).
+ * Spec: §3.5 — Transitive Dependency Walking
+ *
+ * @param taskId - Task ID
+ * @param allDependencies - Dependency graph (task -> dependencies)
+ * @returns Set of transitive dependency task IDs
+ */
+export declare function getTransitiveDependencies(taskId: string, allDependencies: Map<string, string[]>): string[];
+//# sourceMappingURL=dag.d.ts.map

package/dist/utils/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/utils/dag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,MAAM,EAAE,GAAG,IAAI,CAuCjB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,MAAM,EAAE,CAiBV;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,MAAM,EAAE,CAiBV"}

package/dist/utils/dag.js

@@ -0,0 +1,96 @@
+/**
+ * DAG and topological sort utilities.
+ * Spec: §3.5 — Dependency Validation
+ */
+/**
+ * Detect if adding a dependency would create a cycle.
+ * Uses DFS to detect cycles.
+ * Spec: §3.5 — Cycle Detection
+ *
+ * @param taskId - Task that would receive the new dependency
+ * @param newDependency - Task ID to add as dependency
+ * @param allDependencies - Current dependency graph (task -> dependencies)
+ * @returns Cycle path if cycle detected, null otherwise
+ */
+export function detectCycle(taskId, newDependency, allDependencies) {
+    // Create a temporary graph with the new edge
+    const tempGraph = new Map(allDependencies);
+    const currentDeps = tempGraph.get(taskId) || [];
+    tempGraph.set(taskId, [...currentDeps, newDependency]);
+    // DFS to detect cycle starting from newDependency
+    const visited = new Set();
+    const recStack = new Set();
+    const path = [];
+    function dfs(node) {
+        visited.add(node);
+        recStack.add(node);
+        path.push(node);
+        const deps = tempGraph.get(node) || [];
+        for (const dep of deps) {
+            if (!visited.has(dep)) {
+                if (dfs(dep)) {
+                    return true;
+                }
+            }
+            else if (recStack.has(dep)) {
+                // Cycle detected
+                path.push(dep);
+                return true;
+            }
+        }
+        recStack.delete(node);
+        path.pop();
+        return false;
+    }
+    if (dfs(taskId)) {
+        return path;
+    }
+    return null;
+}
+/**
+ * Get all transitive dependents of a task (tasks that depend on it, directly or indirectly).
+ * Spec: §3.5 — Transitive Dependency Walking
+ *
+ * @param taskId - Task ID
+ * @param allDependents - Dependency graph (task -> dependents)
+ * @returns Set of transitive dependent task IDs
+ */
+export function getTransitiveDependents(taskId, allDependents) {
+    const result = new Set();
+    const queue = [taskId];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const dependents = allDependents.get(current) || [];
+        for (const dependent of dependents) {
+            if (!result.has(dependent)) {
+                result.add(dependent);
+                queue.push(dependent);
+            }
+        }
+    }
+    return Array.from(result);
+}
+/**
+ * Get all transitive dependencies of a task (tasks it depends on, directly or indirectly).
+ * Spec: §3.5 — Transitive Dependency Walking
+ *
+ * @param taskId - Task ID
+ * @param allDependencies - Dependency graph (task -> dependencies)
+ * @returns Set of transitive dependency task IDs
+ */
+export function getTransitiveDependencies(taskId, allDependencies) {
+    const result = new Set();
+    const queue = [taskId];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const dependencies = allDependencies.get(current) || [];
+        for (const dependency of dependencies) {
+            if (!result.has(dependency)) {
+                result.add(dependency);
+                queue.push(dependency);
+            }
+        }
+    }
+    return Array.from(result);
+}
+//# sourceMappingURL=dag.js.map

package/dist/utils/dag.js.map

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

package/dist/utils/duration.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Duration parsing utilities.
+ * Spec: §3.7 — Duration Parsing
+ */
+/**
+ * Parse a duration string to milliseconds.
+ * Supports: 30s, 5m, 2h, 7d, 14d
+ *
+ * @param input - Duration string
+ * @returns Milliseconds
+ * @throws Error if format is invalid
+ */
+export declare function parseDuration(input: string): number;
+/**
+ * Format milliseconds to a human-readable duration string.
+ *
+ * @param ms - Milliseconds
+ * @returns Human-readable duration (e.g., "5m", "2h", "7d")
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=duration.d.ts.map

package/dist/utils/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/utils/duration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUjD"}