aura-code 0.3.0

package/dist/orchestration/executor.js.map

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

package/dist/orchestration/index.d.ts

@@ -0,0 +1,20 @@
+export { routeTask } from './router.js';
+export { createPlan } from './orchestrator.js';
+export { executePlan, synthesise } from './executor.js';
+export { runSpecialist, runResearcher, runReviewer, runCoder } from './specialists.js';
+import type { ExecutionPlan, OrchestrationMemory } from './types.js';
+export declare const savePlan: (plan: ExecutionPlan) => Promise<void>;
+export declare const loadPlan: (id: string) => Promise<ExecutionPlan | null>;
+export declare const listPlans: () => Promise<ExecutionPlan[]>;
+export declare const deletePlan: (id: string) => Promise<void>;
+export declare const saveMemory: (projectRoot: string, entry: OrchestrationMemory) => Promise<void>;
+export declare const getMemory: (projectRoot: string, key: string) => Promise<OrchestrationMemory | null>;
+export declare const listMemory: (projectRoot: string) => Promise<OrchestrationMemory[]>;
+export type { ExecutionPlan, PlanStep, OrchestrationMemory, RouterDecision, } from './types.js';
+export type { OrchestratorOptions } from './orchestrator.js';
+export type { ExecutorOptions } from './executor.js';
+export type { SpecialistOptions, SpecialistResult } from './specialists.js';
+export type { RubyFramework, RubyTestFramework, RubyProjectContext, RubyDiamondSurface, RubyDiamondEnvelope, } from './ruby-types.js';
+export { detectRubyProject } from './ruby-detect.js';
+export type { SpecialistRole, CompetenceDomain, CompetenceScore, ProjectCompetence, StepOutcome, } from './competence.js';
+export { PRIMARY_DOMAIN, defaultCompetenceMatrix, recommendSpecialist, applyOutcome, competenceStore, } from './competence.js';

package/dist/orchestration/index.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.competenceStore = exports.applyOutcome = exports.recommendSpecialist = exports.defaultCompetenceMatrix = exports.PRIMARY_DOMAIN = exports.detectRubyProject = exports.listMemory = exports.getMemory = exports.saveMemory = exports.deletePlan = exports.listPlans = exports.loadPlan = exports.savePlan = exports.runCoder = exports.runReviewer = exports.runResearcher = exports.runSpecialist = exports.synthesise = exports.executePlan = exports.createPlan = exports.routeTask = void 0;
+var router_js_1 = require("./router.js");
+Object.defineProperty(exports, "routeTask", { enumerable: true, get: function () { return router_js_1.routeTask; } });
+var orchestrator_js_1 = require("./orchestrator.js");
+Object.defineProperty(exports, "createPlan", { enumerable: true, get: function () { return orchestrator_js_1.createPlan; } });
+var executor_js_1 = require("./executor.js");
+Object.defineProperty(exports, "executePlan", { enumerable: true, get: function () { return executor_js_1.executePlan; } });
+Object.defineProperty(exports, "synthesise", { enumerable: true, get: function () { return executor_js_1.synthesise; } });
+var specialists_js_1 = require("./specialists.js");
+Object.defineProperty(exports, "runSpecialist", { enumerable: true, get: function () { return specialists_js_1.runSpecialist; } });
+Object.defineProperty(exports, "runResearcher", { enumerable: true, get: function () { return specialists_js_1.runResearcher; } });
+Object.defineProperty(exports, "runReviewer", { enumerable: true, get: function () { return specialists_js_1.runReviewer; } });
+Object.defineProperty(exports, "runCoder", { enumerable: true, get: function () { return specialists_js_1.runCoder; } });
+const plan_store_js_1 = require("./plan-store.js");
+const savePlan = (plan) => plan_store_js_1.planStore.save(plan);
+exports.savePlan = savePlan;
+const loadPlan = (id) => plan_store_js_1.planStore.load(id);
+exports.loadPlan = loadPlan;
+const listPlans = () => plan_store_js_1.planStore.list();
+exports.listPlans = listPlans;
+const deletePlan = (id) => plan_store_js_1.planStore.delete(id);
+exports.deletePlan = deletePlan;
+const saveMemory = (projectRoot, entry) => plan_store_js_1.planStore.saveMemory(projectRoot, entry);
+exports.saveMemory = saveMemory;
+const getMemory = (projectRoot, key) => plan_store_js_1.planStore.getMemory(projectRoot, key);
+exports.getMemory = getMemory;
+const listMemory = (projectRoot) => plan_store_js_1.planStore.listMemory(projectRoot);
+exports.listMemory = listMemory;
+var ruby_detect_js_1 = require("./ruby-detect.js");
+Object.defineProperty(exports, "detectRubyProject", { enumerable: true, get: function () { return ruby_detect_js_1.detectRubyProject; } });
+var competence_js_1 = require("./competence.js");
+Object.defineProperty(exports, "PRIMARY_DOMAIN", { enumerable: true, get: function () { return competence_js_1.PRIMARY_DOMAIN; } });
+Object.defineProperty(exports, "defaultCompetenceMatrix", { enumerable: true, get: function () { return competence_js_1.defaultCompetenceMatrix; } });
+Object.defineProperty(exports, "recommendSpecialist", { enumerable: true, get: function () { return competence_js_1.recommendSpecialist; } });
+Object.defineProperty(exports, "applyOutcome", { enumerable: true, get: function () { return competence_js_1.applyOutcome; } });
+Object.defineProperty(exports, "competenceStore", { enumerable: true, get: function () { return competence_js_1.competenceStore; } });
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":";;;AAAA,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,qDAA+C;AAAtC,6GAAA,UAAU,OAAA;AACnB,6CAAwD;AAA/C,0GAAA,WAAW,OAAA;AAAE,yGAAA,UAAU,OAAA;AAChC,mDAAuF;AAA9E,+GAAA,aAAa,OAAA;AAAE,+GAAA,aAAa,OAAA;AAAE,6GAAA,WAAW,OAAA;AAAE,0GAAA,QAAQ,OAAA;AAC5D,mDAA4C;AAErC,MAAM,QAAQ,GAAK,CAAC,IAAmB,EAAuC,EAAE,CAAC,yBAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAhG,QAAA,QAAQ,YAAwF;AACtG,MAAM,QAAQ,GAAK,CAAC,EAAU,EAAgD,EAAE,CAAC,yBAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAA9F,QAAA,QAAQ,YAAsF;AACpG,MAAM,SAAS,GAAI,GAA4D,EAAE,CAAC,yBAAS,CAAC,IAAI,EAAE,CAAC;AAA7F,QAAA,SAAS,aAAoF;AACnG,MAAM,UAAU,GAAG,CAAC,EAAU,EAAgD,EAAE,CAAC,yBAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAAhG,QAAA,UAAU,cAAsF;AACtG,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,KAA0B,EAAW,EAAE,CAAC,yBAAS,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAApH,QAAA,UAAU,cAA0G;AAC1H,MAAM,SAAS,GAAI,CAAC,WAAmB,EAAE,GAAW,EAA0B,EAAE,CAAC,yBAAS,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAAjH,QAAA,SAAS,aAAwG;AACvH,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAuC,EAAE,CAAC,yBAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAA7G,QAAA,UAAU,cAAmG;AAiB1H,mDAAqD;AAA5C,mHAAA,iBAAiB,OAAA;AAQ1B,iDAMyB;AALvB,+GAAA,cAAc,OAAA;AACd,wHAAA,uBAAuB,OAAA;AACvB,oHAAA,mBAAmB,OAAA;AACnB,6GAAA,YAAY,OAAA;AACZ,gHAAA,eAAe,OAAA"}

package/dist/orchestration/orchestrator-prompts.d.ts

@@ -0,0 +1,11 @@
+import type { ProjectContext } from '../agent/context.js';
+import type { ProjectPerception } from '../perception/types.js';
+/**
+ * Builds the system prompt injected when the orchestrator asks a model to
+ * decompose a task into a multi-step execution plan.
+ *
+ * Includes project context and, when available, perception risk areas so the
+ * model can make informed decisions about specialist assignments.
+ * The model must respond with a single JSON object and nothing else.
+ */
+export declare function ORCHESTRATOR_SYSTEM_PROMPT(context: ProjectContext, perception?: ProjectPerception): string;

package/dist/orchestration/orchestrator-prompts.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORCHESTRATOR_SYSTEM_PROMPT = ORCHESTRATOR_SYSTEM_PROMPT;
+// ─────────────────────────────────────────────────────────────────────────────
+// System prompts used by the orchestrator to build execution plans
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Builds the system prompt injected when the orchestrator asks a model to
+ * decompose a task into a multi-step execution plan.
+ *
+ * Includes project context and, when available, perception risk areas so the
+ * model can make informed decisions about specialist assignments.
+ * The model must respond with a single JSON object and nothing else.
+ */
+function ORCHESTRATOR_SYSTEM_PROMPT(context, perception) {
+    const riskSection = buildRiskSection(perception);
+    const graphSection = context.graphSummary
+        ? `\n## Codebase Knowledge Graph\n${context.graphSummary}\n`
+        : '';
+    return `You are the orchestration planner for Aura, a multi-agent coding system.
+
+Project: ${context.name}
+Language: ${context.language}
+Framework: ${context.framework}
+${riskSection}${graphSection}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+AVAILABLE SPECIALISTS
+
+  researcher — Reads and understands code, files, and documentation.
+               Has read-only tool access. Never writes or modifies files.
+               Use to gather context before implementation begins.
+
+  coder      — Implements changes. Has full tool access (read, write, shell).
+               Use for all file creation, modification, and execution tasks.
+
+  reviewer   — Checks correctness, style, test coverage, and constraint compliance.
+               Has read-only tool access. Never writes or modifies files.
+               Use as a final gate after implementation.
+
+  planner    — Decomposes complex or ambiguous subtasks into smaller steps.
+               Use only when a sub-goal is genuinely too large for one specialist.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+PLANNING RULES
+
+  • Prefer 3–5 steps. Stop decomposing the moment a step is clear and actionable.
+  • Only split work that genuinely benefits from specialisation or sequencing.
+  • A researcher step makes sense only when the coder truly needs gathered context
+    first — not as a reflexive first step on every task.
+  • A reviewer step makes sense only when the implementation is non-trivial and
+    an independent correctness check adds real value.
+  • Never create a planner step unless a sub-goal is genuinely ambiguous and
+    cannot be expressed as a direct researcher/coder/reviewer sequence.
+  • dependsOn must be acyclic. A step may only depend on steps listed before it.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+OUTPUT FORMAT — respond with ONLY valid JSON, no prose, no markdown fences:
+
+{
+  "goal": string,
+  "steps": [
+    {
+      "id": string,
+      "specialist": "researcher" | "coder" | "reviewer" | "planner",
+      "task": string,
+      "context": string,
+      "dependsOn": string[]
+    }
+  ]
+}
+
+Field rules:
+  • "goal"       — restate the task in one clear sentence.
+  • "id"         — short kebab-case slug, e.g. "step-1", "step-2".
+  • "specialist" — exactly one of: researcher, coder, reviewer, planner.
+  • "task"       — specific, actionable description of what this step must do.
+  • "context"    — what this specialist needs to know (relevant files, constraints,
+                   prior step results to incorporate).
+  • "dependsOn"  — array of step ids that must complete before this step starts;
+                   use an empty array [] for the first step.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+GOOD EXAMPLE — 3-step plan for "Add rate limiting to the API":
+
+{
+  "goal": "Add per-IP rate limiting middleware to the Express API.",
+  "steps": [
+    {
+      "id": "step-1",
+      "specialist": "researcher",
+      "task": "Read src/server/index.ts and all middleware files. Identify where new middleware should be inserted and whether any rate-limit library is already installed.",
+      "context": "We are adding rate limiting to a Node.js API project. Need to understand current middleware stack before writing code.",
+      "dependsOn": []
+    },
+    {
+      "id": "step-2",
+      "specialist": "coder",
+      "task": "Implement a rate-limiting middleware using the existing dependencies (or install express-rate-limit if absent). Insert it before route handlers in src/server/index.ts. Add a unit test in tests/middleware/rate-limit.test.ts.",
+      "context": "Researcher found: middleware is applied in src/server/index.ts around line 40. No rate-limit library currently installed.",
+      "dependsOn": ["step-1"]
+    },
+    {
+      "id": "step-3",
+      "specialist": "reviewer",
+      "task": "Read the implemented middleware and its test. Verify the limiter is correctly scoped to API routes, that the test covers the reject path, and that no existing tests are broken.",
+      "context": "Coder added express-rate-limit in src/server/index.ts and tests/middleware/rate-limit.test.ts.",
+      "dependsOn": ["step-2"]
+    }
+  ]
+}
+
+BAD EXAMPLE — over-decomposed 8-step plan for the same task (do NOT do this):
+
+{
+  "goal": "Add rate limiting to the API.",
+  "steps": [
+    { "id": "step-1", "specialist": "researcher", "task": "Read the project README.", "context": "", "dependsOn": [] },
+    { "id": "step-2", "specialist": "researcher", "task": "List all files in src/server/.", "context": "", "dependsOn": ["step-1"] },
+    { "id": "step-3", "specialist": "researcher", "task": "Read src/server/index.ts.", "context": "", "dependsOn": ["step-2"] },
+    { "id": "step-4", "specialist": "planner",    "task": "Decide which rate-limit library to use.", "context": "", "dependsOn": ["step-3"] },
+    { "id": "step-5", "specialist": "coder",      "task": "Install the library.", "context": "", "dependsOn": ["step-4"] },
+    { "id": "step-6", "specialist": "coder",      "task": "Write the middleware.", "context": "", "dependsOn": ["step-5"] },
+    { "id": "step-7", "specialist": "coder",      "task": "Write the test.", "context": "", "dependsOn": ["step-6"] },
+    { "id": "step-8", "specialist": "reviewer",   "task": "Review everything.", "context": "", "dependsOn": ["step-7"] }
+  ]
+}
+
+The bad example splits trivially sequential work into micro-steps, uses planner
+where a researcher note would suffice, and separates implementation from testing
+unnecessarily. Combine related actions into single, well-contextualised steps.
+
+Do NOT include any text, explanation, or formatting outside the JSON object.`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function buildRiskSection(perception) {
+    if (!perception)
+        return '';
+    const { riskAreas, strictRules, readOnly } = perception.constraints;
+    const lines = [];
+    if (riskAreas.length > 0) {
+        lines.push(`Risk areas (high-fragility, handle with care): ${riskAreas.join(', ')}`);
+    }
+    if (strictRules.length > 0) {
+        lines.push(`Strict rules that must not be violated: ${strictRules.join('; ')}`);
+    }
+    if (readOnly.length > 0) {
+        lines.push(`Read-only paths (never modify): ${readOnly.join(', ')}`);
+    }
+    return lines.length > 0 ? lines.join('\n') + '\n' : '';
+}
+//# sourceMappingURL=orchestrator-prompts.js.map

package/dist/orchestration/orchestrator-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-prompts.js","sourceRoot":"","sources":["../../src/orchestration/orchestrator-prompts.ts"],"names":[],"mappings":";;AAeA,gEA0HC;AAtID,gFAAgF;AAChF,mEAAmE;AACnE,gFAAgF;AAEhF;;;;;;;GAOG;AACH,SAAgB,0BAA0B,CACxC,OAAuB,EACvB,UAA8B;IAE9B,MAAM,WAAW,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY;QACvC,CAAC,CAAC,kCAAkC,OAAO,CAAC,YAAY,IAAI;QAC5D,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;WAEE,OAAO,CAAC,IAAI;YACX,OAAO,CAAC,QAAQ;aACf,OAAO,CAAC,SAAS;EAC5B,WAAW,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EA2GiD,CAAC;AAC9E,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,SAAS,gBAAgB,CAAC,UAAyC;IACjE,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC;IAEpE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,kDAAkD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,2CAA2C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,mCAAmC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/dist/orchestration/orchestrator.d.ts

@@ -0,0 +1,27 @@
+import type { LLMProvider } from '../providers/types.js';
+import type { ProjectContext } from '../agent/context.js';
+import type { ProjectPerception } from '../perception/types.js';
+import type { ExecutionPlan, OrchestrationMemory } from './types.js';
+/** Inputs required to produce an execution plan. */
+export interface OrchestratorOptions {
+    /** Provider used to call the planning model. */
+    provider: LLMProvider;
+    /** Loaded project context (name, language, framework, tree, …). */
+    context: ProjectContext;
+    /** The raw user task to be decomposed. */
+    task: string;
+    /** Optional perception snapshot; surfaced to the planner for risk-aware step design. */
+    perception?: ProjectPerception;
+    /** Previously persisted memory entries to inject as additional context. */
+    memory?: OrchestrationMemory[];
+}
+/**
+ * Calls the planning model and returns a fully initialised `ExecutionPlan`.
+ *
+ * Steps are assigned fresh UUIDs, statuses are set to `'waiting'`, and the
+ * plan status is set to `'pending'`.  If the model response cannot be parsed
+ * or fails validation, a safe single-step fallback plan is returned instead.
+ *
+ * Never throws — always returns an `ExecutionPlan`.
+ */
+export declare function createPlan(opts: OrchestratorOptions): Promise<ExecutionPlan>;

package/dist/orchestration/orchestrator.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlan = createPlan;
+const crypto_1 = require("crypto");
+const orchestrator_prompts_js_1 = require("./orchestrator-prompts.js");
+/**
+ * Calls the planning model and returns a fully initialised `ExecutionPlan`.
+ *
+ * Steps are assigned fresh UUIDs, statuses are set to `'waiting'`, and the
+ * plan status is set to `'pending'`.  If the model response cannot be parsed
+ * or fails validation, a safe single-step fallback plan is returned instead.
+ *
+ * Never throws — always returns an `ExecutionPlan`.
+ */
+async function createPlan(opts) {
+    const { provider, context, task, perception, memory } = opts;
+    const system = (0, orchestrator_prompts_js_1.ORCHESTRATOR_SYSTEM_PROMPT)(context, perception);
+    const userMessage = buildUserMessage(task, memory);
+    const history = [{ role: 'user', content: userMessage }];
+    let rawText = '';
+    try {
+        const response = await provider.complete(system, history, []);
+        rawText = response.text.trim();
+    }
+    catch {
+        return fallbackPlan(task);
+    }
+    return parsePlan(rawText, task);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function buildUserMessage(task, memory) {
+    const lines = [`Task: ${task}`];
+    if (memory && memory.length > 0) {
+        lines.push('', 'Relevant memory from previous steps:');
+        for (const entry of memory) {
+            lines.push(`  [${entry.key}] ${entry.value}`);
+        }
+    }
+    return lines.join('\n');
+}
+const VALID_SPECIALISTS = new Set(['researcher', 'coder', 'reviewer', 'planner']);
+function parsePlan(raw, originalTask) {
+    let parsed;
+    try {
+        const cleaned = raw.replace(/^```(?:json)?\s*/i, '').replace(/\s*```\s*$/, '').trim();
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        return fallbackPlan(originalTask);
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return fallbackPlan(originalTask);
+    }
+    const r = parsed;
+    const goal = typeof r.goal === 'string' && r.goal.length > 0 ? r.goal : originalTask;
+    if (!Array.isArray(r.steps) || r.steps.length === 0) {
+        return fallbackPlan(originalTask);
+    }
+    // BUG 5: reject absurdly large plans that are almost certainly model hallucinations
+    if (r.steps.length > 20)
+        return fallbackPlan(originalTask);
+    // BUG 3: reject plans where the model reused a step id
+    const rawIds = r.steps
+        .map(s => (typeof s === 'object' && s !== null ? s.id : undefined));
+    if (rawIds.some(id => typeof id !== 'string'))
+        return fallbackPlan(originalTask);
+    if (new Set(rawIds).size !== rawIds.length)
+        return fallbackPlan(originalTask);
+    // Validate each step shape and collect id → uuid mapping
+    const idMap = new Map();
+    const validatedRaw = [];
+    for (const s of r.steps) {
+        if (typeof s !== 'object' || s === null)
+            return fallbackPlan(originalTask);
+        const step = s;
+        if (typeof step.id !== 'string' || step.id.length === 0)
+            return fallbackPlan(originalTask);
+        if (typeof step.specialist !== 'string' || !VALID_SPECIALISTS.has(step.specialist))
+            return fallbackPlan(originalTask);
+        if (typeof step.task !== 'string' || step.task.length === 0)
+            return fallbackPlan(originalTask);
+        if (typeof step.context !== 'string')
+            return fallbackPlan(originalTask);
+        if (!Array.isArray(step.dependsOn))
+            return fallbackPlan(originalTask);
+        idMap.set(step.id, (0, crypto_1.randomUUID)());
+        validatedRaw.push(step);
+    }
+    // Validate dependsOn references and check for cycles
+    const knownIds = new Set(idMap.keys());
+    for (const step of validatedRaw) {
+        for (const dep of step.dependsOn) {
+            if (typeof dep !== 'string' || !knownIds.has(dep))
+                return fallbackPlan(originalTask);
+        }
+    }
+    if (hasCycle(validatedRaw))
+        return fallbackPlan(originalTask);
+    // Build final steps with UUIDs and runtime-only fields
+    const steps = validatedRaw.map(s => ({
+        id: idMap.get(s.id) ?? (0, crypto_1.randomUUID)(),
+        specialist: s.specialist,
+        task: s.task,
+        context: s.context,
+        dependsOn: s.dependsOn.map(dep => idMap.get(dep) ?? dep),
+        status: 'waiting',
+    }));
+    return {
+        id: (0, crypto_1.randomUUID)(),
+        goal,
+        steps,
+        status: 'pending',
+        created: Date.now(),
+    };
+}
+/**
+ * Topological cycle check using DFS with three-colour marking.
+ * Returns true if any cycle is detected among step dependencies.
+ */
+function hasCycle(steps) {
+    const WHITE = 0, GRAY = 1, BLACK = 2;
+    const colour = new Map();
+    const adj = new Map();
+    for (const s of steps) {
+        colour.set(s.id, WHITE);
+        adj.set(s.id, s.dependsOn);
+    }
+    function dfs(id) {
+        colour.set(id, GRAY);
+        for (const dep of adj.get(id) ?? []) {
+            const c = colour.get(dep) ?? WHITE;
+            if (c === GRAY)
+                return true;
+            if (c === WHITE && dfs(dep))
+                return true;
+        }
+        colour.set(id, BLACK);
+        return false;
+    }
+    for (const s of steps) {
+        if ((colour.get(s.id) ?? WHITE) === WHITE) {
+            if (dfs(s.id))
+                return true;
+        }
+    }
+    return false;
+}
+/** Single-step fallback used whenever parsing or validation fails. */
+function fallbackPlan(task) {
+    return {
+        id: (0, crypto_1.randomUUID)(),
+        goal: task,
+        steps: [
+            {
+                id: (0, crypto_1.randomUUID)(),
+                specialist: 'coder',
+                task,
+                context: 'Fallback single-step plan — orchestrator could not parse a structured plan.',
+                dependsOn: [],
+                status: 'waiting',
+            },
+        ],
+        status: 'pending',
+        created: Date.now(),
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestration/orchestrator.js.map

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

package/dist/orchestration/plan-store.d.ts

@@ -0,0 +1,53 @@
+import type { ExecutionPlan, OrchestrationMemory } from './types.js';
+/**
+ * On-disk persistence for execution plans and orchestration memory.
+ *
+ * Plans are stored as individual JSON files under ~/.aura/plans/{id}.json
+ * so they survive process restarts and can be inspected or replayed.
+ *
+ * Per-project memory is appended to {projectRoot}/.aura/memory.json and
+ * keyed by a string so specialists can share facts across steps.
+ */
+export declare const planStore: {
+    /** Returns the directory where plan files are stored. */
+    plansDir(): string;
+    /**
+     * Persists an execution plan to ~/.aura/plans/{id}.json.
+     * Uses a .tmp rename to avoid corrupt files on crash.
+     */
+    save(plan: ExecutionPlan): Promise<void>;
+    /**
+     * Loads a plan by id.
+     * Returns `null` if the file does not exist or cannot be parsed.
+     */
+    load(id: string): Promise<ExecutionPlan | null>;
+    /**
+     * Returns all saved plans, most recently created first.
+     * Silently skips files that cannot be parsed.
+     */
+    list(): Promise<ExecutionPlan[]>;
+    /**
+     * Removes a plan file from disk.
+     * Resolves silently if the file does not exist.
+     */
+    delete(id: string): Promise<void>;
+    /** Returns the path to the memory file for a given project root. */
+    memoryPath(projectRoot: string): string;
+    /**
+     * Appends a memory entry to {projectRoot}/.aura/memory.json.
+     * Creates the file (and parent directory) if they do not yet exist.
+     * Uses a .tmp rename to avoid corrupt files on crash.
+     */
+    saveMemory(projectRoot: string, entry: OrchestrationMemory): Promise<void>;
+    /**
+     * Returns the most recent memory entry matching `key`, or `null` if none
+     * exists.  When multiple entries share the same key, the latest timestamp
+     * wins.
+     */
+    getMemory(projectRoot: string, key: string): Promise<OrchestrationMemory | null>;
+    /**
+     * Returns all memory entries for a project, sorted newest-first.
+     * Returns an empty array if the memory file does not exist.
+     */
+    listMemory(projectRoot: string): Promise<OrchestrationMemory[]>;
+};