@jterrats/open-orchestra 0.4.2-beta.1 → 0.5.0-beta.0

package/dist/skills-catalog.js

@@ -0,0 +1,389 @@
+export const defaultSkills = [
+    {
+        id: "proactive-orchestra",
+        name: "Proactive Orchestra",
+        summary: "Self-bootstrap Open Orchestra workflow checks before implementation and record accepted bypasses.",
+        triggers: [
+            "orchestra",
+            "workflow",
+            "task loop",
+            "bootstrap",
+            "pre-run",
+            "handoff",
+            "evidence",
+        ],
+        roles: ["parent", "architect", "developer", "qa", "release_manager"],
+        capabilities: ["workflow-discipline", "pre-run-validation", "auditability"],
+        riskAreas: ["governance", "quality"],
+        sourceGroups: ["project-instructions", "agent-memory"],
+        entry: "skills/proactive-orchestra/SKILL.md",
+        assets: [],
+        evidence: ["command", "report", "file"],
+        loadBudget: "small",
+        instructions: [
+            "Start with health and task list before implementation when .agent-workflow exists.",
+            "Run pre-run validation before coding and resolve missing estimate, workflow, evidence, or review checks.",
+            "Record user-accepted deviations as decisions instead of silently skipping workflow steps.",
+        ],
+    },
+    {
+        id: "prompt-registry",
+        name: "Prompt Registry",
+        summary: "Read and update .generated-prompts registers for substantial AI-generated artifacts.",
+        triggers: [
+            "prompt",
+            "generated",
+            "artifact",
+            "code",
+            "ui",
+            "docs",
+            "diagram",
+            "eval",
+        ],
+        roles: [
+            "parent",
+            "developer",
+            "tech_lead",
+            "frontend_specialist",
+            "backend_specialist",
+            "mobile_specialist",
+            "sdet",
+            "qa",
+            "technical_writer",
+            "ai_evaluation_engineer",
+        ],
+        capabilities: [
+            "prompt-memory",
+            "artifact-traceability",
+            "context-continuity",
+        ],
+        riskAreas: ["maintainability", "governance"],
+        sourceGroups: ["agent-memory", "codebase"],
+        entry: "skills/prompt-registry/SKILL.md",
+        assets: [],
+        evidence: ["file"],
+        loadBudget: "small",
+        instructions: [
+            "Before substantial generation, read the relevant .generated-prompts register.",
+            "After substantial changes, update one entry with task, role, decisions, evidence, and prompt summary.",
+            "Do not update the register for typo-only, formatting-only, or single-line mechanical fixes.",
+        ],
+    },
+    {
+        id: "diagram-export",
+        name: "Diagram Export",
+        summary: "Create, validate, and export architecture, workflow, and sequence diagrams.",
+        triggers: [
+            "diagram",
+            "mermaid",
+            "architecture",
+            "flow",
+            "sequence",
+            "draw.io",
+            "lucid",
+        ],
+        roles: [
+            "architect",
+            "business_analyst",
+            "product_manager",
+            "tech_lead",
+            "technical_writer",
+        ],
+        capabilities: ["diagramming", "architecture-communication"],
+        riskAreas: ["architecture", "documentation"],
+        sourceGroups: ["architecture", "product-backlog", "agent-memory"],
+        entry: "skills/diagram-export/SKILL.md",
+        assets: [],
+        evidence: ["file", "report"],
+        loadBudget: "normal",
+        instructions: [
+            "Identify the diagram purpose and authoritative architecture sources before drawing.",
+            "Choose the diagram style from the decision matrix before drafting.",
+            "Prefer text-native diagrams such as Mermaid unless the project requires another format.",
+            "Run orchestra diagrams lint --file <diagram.mmd> before sharing Mermaid diagrams.",
+            "Attach lint evidence to the workflow when the diagram supports delivery.",
+        ],
+    },
+    {
+        id: "static-analysis",
+        name: "Static Analysis",
+        summary: "Run and interpret local quality, type, dependency, secret, and security checks.",
+        triggers: [
+            "lint",
+            "typecheck",
+            "secret",
+            "sast",
+            "precommit",
+            "dependency",
+            "scan",
+            "eslint",
+            "test",
+        ],
+        roles: [
+            "developer",
+            "tech_lead",
+            "qa",
+            "sdet",
+            "security",
+            "devops",
+            "platform_engineer",
+        ],
+        capabilities: ["quality-gate", "security-review", "commit-readiness"],
+        riskAreas: ["security", "release", "maintainability"],
+        sourceGroups: ["codebase", "quality-security", "agent-memory"],
+        entry: "skills/static-analysis/SKILL.md",
+        assets: ["skills/static-analysis/checklist.md"],
+        evidence: ["command", "report"],
+        loadBudget: "normal",
+        instructions: [
+            "Inspect configured local checks before inventing commands.",
+            "Run the smallest relevant check first, then the full gate before handoff or commit.",
+            "Record command evidence and treat failed required checks as blockers unless explicitly deferred.",
+        ],
+    },
+    {
+        id: "pr-review",
+        name: "PR Review",
+        summary: "Produce review findings, PR summaries, risks, rollout notes, and missing-test gaps.",
+        triggers: [
+            "pr",
+            "pull request",
+            "review",
+            "diff",
+            "merge",
+            "release summary",
+        ],
+        roles: [
+            "reviewer_critic",
+            "tech_lead",
+            "qa",
+            "security",
+            "release_manager",
+            "architect",
+        ],
+        capabilities: ["review", "risk-summary", "change-summary"],
+        riskAreas: ["release", "security", "maintainability"],
+        sourceGroups: [
+            "codebase",
+            "quality-security",
+            "product-backlog",
+            "agent-memory",
+        ],
+        entry: "skills/pr-review/SKILL.md",
+        assets: [],
+        evidence: ["file", "report"],
+        loadBudget: "normal",
+        instructions: [
+            "Review behavior, tests, risks, rollout, rollback, and missing evidence before summaries.",
+            "Lead with findings and blockers, then summarize changes.",
+            "Reference local files, task context, reviews, and evidence rather than generated claims.",
+        ],
+    },
+    {
+        id: "playwright-evidence",
+        name: "Playwright Evidence",
+        summary: "Plan browser automation and attach screenshots, traces, videos, and reports.",
+        triggers: [
+            "playwright",
+            "browser",
+            "e2e",
+            "screenshot",
+            "trace",
+            "video",
+            "responsive",
+            "web",
+            "ui",
+        ],
+        roles: [
+            "qa",
+            "sdet",
+            "frontend_specialist",
+            "ux_ui_designer",
+            "ux_researcher_accessibility",
+        ],
+        capabilities: ["e2e-testing", "browser-evidence", "accessibility-check"],
+        riskAreas: ["ux", "release"],
+        sourceGroups: [
+            "quality-security",
+            "codebase",
+            "product-backlog",
+            "agent-memory",
+        ],
+        entry: "skills/playwright-evidence/SKILL.md",
+        assets: [],
+        evidence: ["screenshot", "trace", "video", "report"],
+        loadBudget: "normal",
+        instructions: [
+            "Plan user-value scenarios from acceptance criteria before writing tests.",
+            "Use resilient locators and page objects for repeated flows.",
+            "Attach screenshots, traces, videos, or reports as evidence for release decisions.",
+        ],
+    },
+    {
+        id: "backlog-sync",
+        name: "Backlog Sync",
+        summary: "Keep GitHub issues, local stories, and workflow tasks aligned.",
+        triggers: [
+            "backlog",
+            "issue",
+            "story",
+            "epic",
+            "github",
+            "acceptance criteria",
+            "refine",
+        ],
+        roles: [
+            "product_manager",
+            "product_owner",
+            "business_analyst",
+            "planner",
+            "parent",
+        ],
+        capabilities: ["backlog-management", "story-refinement", "scope-control"],
+        riskAreas: ["governance", "scope"],
+        sourceGroups: ["product-backlog", "project-instructions", "agent-memory"],
+        entry: "skills/backlog-sync/SKILL.md",
+        assets: [],
+        evidence: ["file", "report"],
+        loadBudget: "small",
+        instructions: [
+            "Confirm backlog IDs and acceptance criteria before implementation.",
+            "Keep local tasks, docs, and GitHub issues aligned when one changes.",
+            "Surface missing refinement as a blocker instead of guessing scope.",
+        ],
+    },
+    {
+        id: "release-readiness",
+        name: "Release Readiness",
+        summary: "Validate gates, rollback, observability, support, and customer-impact evidence.",
+        triggers: [
+            "release",
+            "deploy",
+            "rollback",
+            "go-live",
+            "readiness",
+            "downtime",
+            "observability",
+        ],
+        roles: [
+            "release_manager",
+            "devops",
+            "sre",
+            "platform_engineer",
+            "support_customer_ops",
+            "security",
+        ],
+        capabilities: ["release-gate", "rollback-review", "operational-readiness"],
+        riskAreas: ["release", "sre", "devops", "security"],
+        sourceGroups: ["devops-runtime", "quality-security", "agent-memory"],
+        entry: "skills/release-readiness/SKILL.md",
+        assets: [],
+        evidence: ["command", "report", "file"],
+        loadBudget: "normal",
+        instructions: [
+            "Validate gates, evidence, locks, reviews, rollback, observability, and support readiness.",
+            "Treat missing rollback or unresolved critical QA/security/SRE findings as blockers.",
+            "Record release evidence and accepted residual risks explicitly.",
+        ],
+    },
+    {
+        id: "model-evaluation",
+        name: "Model Evaluation",
+        summary: "Run prompt, model, provider-routing, fallback, and rubric evaluations.",
+        triggers: [
+            "model",
+            "llm",
+            "prompt",
+            "provider",
+            "fallback",
+            "eval",
+            "rubric",
+            "routing",
+        ],
+        roles: ["ai_evaluation_engineer", "toolsmith", "architect", "parent"],
+        capabilities: ["llm-evaluation", "provider-routing", "prompt-quality"],
+        riskAreas: ["governance", "quality"],
+        sourceGroups: ["vendor-docs", "agent-memory", "quality-security"],
+        entry: "skills/model-evaluation/SKILL.md",
+        assets: [],
+        evidence: ["report", "file"],
+        loadBudget: "normal",
+        instructions: [
+            "Define eval objectives, cases, rubric, and expected behavior before changing prompts or routing.",
+            "Compare model/provider behavior for material changes and record disagreements.",
+            "Avoid storing raw sensitive prompts or responses in provenance artifacts.",
+        ],
+    },
+    {
+        id: "source-of-truth",
+        name: "Source of Truth",
+        summary: "Select authoritative project, vendor, and workflow sources before acting.",
+        triggers: [
+            "source",
+            "documentation",
+            "docs",
+            "official",
+            "verify",
+            "truth",
+            "context",
+        ],
+        roles: [
+            "parent",
+            "planner",
+            "context_curator",
+            "architect",
+            "developer",
+            "qa",
+            "security",
+            "devops",
+        ],
+        capabilities: ["context-selection", "provenance", "source-resolution"],
+        riskAreas: ["governance", "accuracy"],
+        sourceGroups: [
+            "project-instructions",
+            "product-backlog",
+            "architecture",
+            "codebase",
+            "vendor-docs",
+            "agent-memory",
+        ],
+        entry: "skills/source-of-truth/SKILL.md",
+        assets: [],
+        evidence: ["file", "report"],
+        loadBudget: "small",
+        instructions: [
+            "Select source groups before acting and load only sources relevant to the task.",
+            "Prefer local project sources first and official vendor docs for current APIs or tools.",
+            "If sources conflict, record the conflict as a blocker or decision.",
+        ],
+    },
+    {
+        id: "agent-learning",
+        name: "Agent Learning",
+        summary: "Record reusable failure lessons and promote repeated lessons into skills or rules.",
+        triggers: [
+            "failure",
+            "failed",
+            "error",
+            "syntax",
+            "escaping",
+            "permission",
+            "lesson",
+            "learn",
+        ],
+        roles: ["parent", "context_curator", "toolsmith", "developer", "qa"],
+        capabilities: ["failure-learning", "memory-hygiene", "repeat-prevention"],
+        riskAreas: ["maintainability", "governance"],
+        sourceGroups: ["agent-memory", "codebase"],
+        entry: "skills/agent-learning/SKILL.md",
+        assets: [],
+        evidence: ["file"],
+        loadBudget: "small",
+        instructions: [
+            "Search relevant lessons before repeating risky operations.",
+            "After reusable failures, record operation, error signature, root cause, fix, prevention, and verification.",
+            "Promote repeated lessons into versioned skills or rules after review.",
+        ],
+    },
+];
+//# sourceMappingURL=skills-catalog.js.map

package/dist/skills-catalog.js.map

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

package/dist/skills-commands.js

@@ -1,6 +1,5 @@
 import { requireArg } from "./args.js";
-import { parseCsv, removeUndefined, stringOption } from "./command-utils.js";
-import { parseRuntimeTarget } from "./runtime-adapters.js";
+import { parseCsv, parsePromotionTarget, parseSkillRenderTarget, removeUndefined, stringOption, } from "./command-utils.js";
 import { addAgentLesson, deleteAgentLesson, listAgentLessons, listSkills, planSkillsForTask, promoteAgentLessons, readSourceOfTruth, recordSkillPlan, recordSkillRender, renderSkills, validateSkills, } from "./skills.js";
 export async function skillsValidateCommand(options, io) {
     const report = await validateSkills();
@@ -126,13 +125,4 @@ export async function skillsRenderCommand(options, io) {
     }
     io.log(rendered.content);
 }
-function parsePromotionTarget(value) {
-    if (["skill", "rule", "doc"].includes(value)) {
-        return value;
-    }
-    throw new Error(`unknown promotion target: ${value}`);
-}
-function parseSkillRenderTarget(value) {
-    return parseRuntimeTarget(value);
-}
 //# sourceMappingURL=skills-commands.js.map

package/dist/skills-commands.js.map

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

package/dist/skills-events.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryPacket, Skill, SkillPlan, SkillRenderTarget } from "./types.js";
+export declare function recordSkillPlan(plan: SkillPlan, root?: string): Promise<void>;
+export declare function recordSkillRender(rendered: {
+    target: SkillRenderTarget;
+    taskId: string | undefined;
+    skills: Skill[];
+    sourceGroups: string[];
+    memory?: MemoryPacket;
+}, root?: string): Promise<void>;

package/dist/skills-events.js

@@ -0,0 +1,50 @@
+import { removeUndefined } from "./command-utils.js";
+import { FILES } from "./constants.js";
+import { exists, resolveWorkflowPath } from "./fs-utils.js";
+import { appendEvent } from "./workspace.js";
+export async function recordSkillPlan(plan, root = process.cwd()) {
+    if (!(await hasInitializedWorkflowState(root))) {
+        return;
+    }
+    await appendEvent(root, {
+        type: "SKILLS_PLANNED",
+        taskId: plan.taskId,
+        actor: "parent",
+        summary: `Selected ${plan.selected.length} skills for ${plan.taskId}`,
+        metadata: {
+            selectedSkillIds: plan.selected.map((item) => item.skill.id),
+            sourceGroups: plan.sourceGroups,
+            rationale: Object.fromEntries(plan.selected.map((item) => [item.skill.id, item.rationale])),
+        },
+    });
+}
+export async function recordSkillRender(rendered, root = process.cwd()) {
+    if (!rendered.taskId) {
+        return;
+    }
+    if (!(await hasInitializedWorkflowState(root))) {
+        return;
+    }
+    await appendEvent(root, removeUndefined({
+        type: "SKILLS_RENDERED",
+        taskId: rendered.taskId,
+        actor: "parent",
+        summary: `Rendered ${rendered.skills.length} skills for ${rendered.target}`,
+        metadata: {
+            target: rendered.target,
+            selectedSkillIds: rendered.skills.map((skill) => skill.id),
+            sourceGroups: rendered.sourceGroups,
+            memory: rendered.memory &&
+                removeUndefined({
+                    hook: rendered.memory.hook,
+                    estimatedTokens: rendered.memory.estimatedTokens,
+                    lessonCount: rendered.memory.lessons.length,
+                    promptCount: rendered.memory.prompts.length,
+                }),
+        },
+    }));
+}
+async function hasInitializedWorkflowState(root) {
+    return exists(resolveWorkflowPath(root, FILES.config));
+}
+//# sourceMappingURL=skills-events.js.map

package/dist/skills-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-events.js","sourceRoot":"","sources":["../src/skills-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQ7C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAe,EACf,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IAEpB,IAAI,CAAC,CAAC,MAAM,2BAA2B,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,MAAM,WAAW,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,gBAAgB;QACtB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,YAAY,IAAI,CAAC,QAAQ,CAAC,MAAM,eAAe,IAAI,CAAC,MAAM,EAAE;QACrE,QAAQ,EAAE;YACR,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,MAAM,CAAC,WAAW,CAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAC7D;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAMC,EACD,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IAEpB,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,2BAA2B,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,MAAM,WAAW,CACf,IAAI,EACJ,eAAe,CAAC;QACd,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,YAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,eAAe,QAAQ,CAAC,MAAM,EAAE;QAC3E,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,MAAM,EACJ,QAAQ,CAAC,MAAM;gBACf,eAAe,CAAC;oBACd,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAC1B,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe;oBAChD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;oBAC3C,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;iBAC5C,CAAC;SACL;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,IAAY;IACrD,OAAO,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/skills-memory.d.ts

@@ -0,0 +1,18 @@
+import type { AgentLesson, AgentLessonInput } from "./types.js";
+export declare function readAgentLessons(root?: string): Promise<string[]>;
+export declare function readSourceOfTruth(root?: string): Promise<unknown[]>;
+export declare function addAgentLesson(input: AgentLessonInput, root?: string): Promise<AgentLesson>;
+export declare function listAgentLessons(root?: string): Promise<AgentLesson[]>;
+export declare function deleteAgentLesson(id: string, root?: string): Promise<{
+    deleted: true;
+    id: string;
+}>;
+export declare function promoteAgentLessons({ to, filter, root, }: {
+    to: "skill" | "rule" | "doc";
+    filter?: string;
+    root?: string;
+}): Promise<{
+    artifact: string;
+    lessons: AgentLesson[];
+}>;
+export declare function writeSourceOfTruth(entries: unknown[], root?: string): Promise<void>;

package/dist/skills-memory.js

@@ -0,0 +1,127 @@
+import { createHash, randomUUID } from "node:crypto";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { removeUndefined } from "./command-utils.js";
+import { FILES } from "./constants.js";
+import { exists, readJson, resolveWorkflowPath, writeJson, } from "./fs-utils.js";
+import { appendEvent, writeArtifact } from "./workspace.js";
+export async function readAgentLessons(root = process.cwd()) {
+    const lessonsPath = resolveWorkflowPath(root, FILES.agentLessons);
+    if (!(await exists(lessonsPath))) {
+        return [];
+    }
+    return (await readFile(lessonsPath, "utf8"))
+        .split("\n")
+        .filter((line) => line.trim() !== "");
+}
+export async function readSourceOfTruth(root = process.cwd()) {
+    return readJson(path.join(root, ".agent-workflow", FILES.sourceOfTruth), []);
+}
+export async function addAgentLesson(input, root = process.cwd()) {
+    const lesson = {
+        id: `lesson-${randomUUID()}`,
+        timestamp: new Date().toISOString(),
+        ...input,
+    };
+    await writeFile(resolveWorkflowPath(root, FILES.agentLessons), `${JSON.stringify(lesson)}\n`, { flag: "a" });
+    await appendEvent(root, removeUndefined({
+        type: "LESSON_RECORDED",
+        taskId: lesson.taskId,
+        actor: lesson.actor,
+        summary: `Recorded lesson: ${lesson.errorSignature}`,
+        metadata: { operation: lesson.operation, appliesTo: lesson.appliesTo },
+    }));
+    return lesson;
+}
+export async function listAgentLessons(root = process.cwd()) {
+    const lines = await readAgentLessons(root);
+    return lines.map((line) => normalizeAgentLesson(JSON.parse(line)));
+}
+export async function deleteAgentLesson(id, root = process.cwd()) {
+    const lines = await readAgentLessons(root);
+    let deletedLesson;
+    const retained = [];
+    for (const line of lines) {
+        const parsed = JSON.parse(line);
+        const lesson = normalizeAgentLesson(parsed);
+        if (lesson.id === id) {
+            deletedLesson = lesson;
+        }
+        else {
+            retained.push(JSON.stringify(parsed));
+        }
+    }
+    if (!deletedLesson) {
+        throw new Error(`lesson not found: ${id}`);
+    }
+    await writeFile(resolveWorkflowPath(root, FILES.agentLessons), retained.length > 0 ? `${retained.join("\n")}\n` : "", "utf8");
+    await appendEvent(root, removeUndefined({
+        type: "LESSON_DELETED",
+        taskId: deletedLesson.taskId,
+        actor: "parent",
+        summary: `Deleted lesson ${id}`,
+        metadata: {
+            lessonId: id,
+            operation: deletedLesson.operation,
+            errorSignature: deletedLesson.errorSignature,
+        },
+    }));
+    return { deleted: true, id };
+}
+export async function promoteAgentLessons({ to, filter, root = process.cwd(), }) {
+    const lessons = (await listAgentLessons(root)).filter((lesson) => {
+        if (!filter) {
+            return true;
+        }
+        const text = JSON.stringify(lesson).toLowerCase();
+        return text.includes(filter.toLowerCase());
+    });
+    const content = [
+        `# Promoted Agent Lessons (${to})`,
+        "",
+        ...lessons.flatMap((lesson) => [
+            `## ${lesson.operation}`,
+            `- Error: ${lesson.errorSignature}`,
+            `- Root cause: ${lesson.rootCause}`,
+            `- Fix: ${lesson.fix}`,
+            `- Prevention: ${lesson.prevention}`,
+            "",
+        ]),
+    ].join("\n");
+    const artifact = await writeArtifact(root, "decisions", `promoted-lessons-${to}.md`, content);
+    await appendEvent(root, {
+        type: "LESSON_PROMOTED",
+        actor: "parent",
+        summary: `Promoted ${lessons.length} lessons to ${to}`,
+        artifacts: [artifact],
+        metadata: { to, filter, lessonCount: lessons.length },
+    });
+    return { artifact, lessons };
+}
+export async function writeSourceOfTruth(entries, root = process.cwd()) {
+    await writeJson(path.join(root, ".agent-workflow", FILES.sourceOfTruth), entries);
+}
+function normalizeAgentLesson(value) {
+    const lesson = value;
+    return {
+        ...lesson,
+        id: lesson.id ?? legacyLessonId(lesson),
+    };
+}
+function legacyLessonId(lesson) {
+    const stablePayload = JSON.stringify({
+        timestamp: lesson.timestamp,
+        actor: lesson.actor,
+        operation: lesson.operation,
+        failedAction: lesson.failedAction,
+        errorSignature: lesson.errorSignature,
+        rootCause: lesson.rootCause,
+        fix: lesson.fix,
+        prevention: lesson.prevention,
+        appliesTo: lesson.appliesTo,
+        verifiedBy: lesson.verifiedBy,
+        taskId: lesson.taskId,
+    });
+    return `legacy-${createHash("sha256").update(stablePayload).digest("hex").slice(0, 16)}`;
+}
+//# sourceMappingURL=skills-memory.js.map