@jterrats/open-orchestra 0.1.0 → 0.2.1

package/dist/delegation-decision.js

@@ -0,0 +1,391 @@
+import path from "node:path";
+import { appendEvent, loadWorkspace, readEvents } from "./workspace.js";
+const REVIEW_STATUSES = new Set(["review", "approved"]);
+const COMPLETE_STATUSES = new Set(["done", "canceled"]);
+export function decideDelegation(input) {
+    const taskEvents = input.events.filter((event) => event.taskId === input.task.id);
+    const roleIds = new Set(input.roles.map((role) => role.id));
+    const complexityScore = taskComplexityScore(input.task);
+    const urgency = taskUrgency(input.task);
+    const taskLocks = locksForTask(input.task, input.locks);
+    const blockingConditions = delegationBlockingConditions(input.task, input.dependencies, taskLocks);
+    const contextBundle = requiredContextBundle(input, taskEvents);
+    const rationale = delegationRationale(input.task, complexityScore, urgency);
+    if (blockingConditions.length > 0) {
+        return buildDecision({
+            task: input.task,
+            recommendation: "no_delegation",
+            complexityScore,
+            urgency,
+            rationale: rationale.concat("Delegation is blocked until preconditions are resolved."),
+            blockingConditions,
+            contextBundle,
+            delegates: [],
+            expectedOutputs: [
+                "Resolve blocking conditions before assigning subagents.",
+            ],
+        });
+    }
+    if (needsReviewDelegation(input.task, taskEvents)) {
+        const reviewRole = roleIds.has("qa") ? "qa" : "reviewer_critic";
+        return buildDecision({
+            task: input.task,
+            recommendation: "review_delegate",
+            complexityScore,
+            urgency,
+            rationale: rationale.concat("Task is in a review or evidence-bearing state."),
+            blockingConditions,
+            contextBundle,
+            delegates: [
+                assignment(reviewRole, "review", ["Review readiness or evidence exists."], input.task.paths ?? []),
+            ],
+            expectedOutputs: [
+                "Review findings with approve/block/changes result.",
+                "Updated evidence or explicit residual risk notes.",
+            ],
+        });
+    }
+    const candidates = candidateAssignments(input.task, roleIds);
+    if (candidates.length >= 2 && scopesAreDisjoint(candidates)) {
+        return buildDecision({
+            task: input.task,
+            recommendation: "parallel_delegate",
+            complexityScore,
+            urgency,
+            rationale: rationale.concat("Multiple role-fit delegates have disjoint write scopes."),
+            blockingConditions,
+            contextBundle,
+            delegates: candidates,
+            expectedOutputs: [
+                "Role-specific implementation or review artifacts.",
+                "Integration handoff summarizing touched scopes and residual risks.",
+            ],
+        });
+    }
+    const preferredCandidate = candidates[0];
+    if (preferredCandidate && shouldDelegateSingle(input.task, complexityScore)) {
+        return buildDecision({
+            task: input.task,
+            recommendation: "single_delegate",
+            complexityScore,
+            urgency,
+            rationale: rationale.concat("Task has enough complexity or risk for a role-fit delegate."),
+            blockingConditions,
+            contextBundle,
+            delegates: [preferredCandidate],
+            expectedOutputs: [
+                "Role-scoped work artifact or handoff.",
+                "Unit tests, checks, or review evidence appropriate to the role.",
+            ],
+        });
+    }
+    return buildDecision({
+        task: input.task,
+        recommendation: "local",
+        complexityScore,
+        urgency,
+        rationale: rationale.concat("Task is small enough for the parent/current agent to handle locally."),
+        blockingConditions,
+        contextBundle,
+        delegates: [],
+        expectedOutputs: [
+            "Local implementation with focused tests and final summary.",
+        ],
+    });
+}
+export async function decideTaskDelegation(taskId, root = process.cwd(), { record = true } = {}) {
+    const workspace = await loadWorkspace(root);
+    const task = workspace.tasks.find((candidate) => candidate.id === taskId);
+    if (!task) {
+        throw new Error("unknown task: " + taskId);
+    }
+    const dependencies = dependencyReportForTask(task, workspace.tasks);
+    const decision = decideDelegation({
+        task,
+        dependencies,
+        locks: workspace.locks,
+        roles: workspace.roles,
+        events: await readEvents(root),
+    });
+    if (record) {
+        await appendEvent(root, {
+            type: "DELEGATION_DECIDED",
+            taskId,
+            actor: "parent",
+            summary: "Delegation decision: " + decision.recommendation,
+            metadata: { decision },
+        });
+    }
+    return decision;
+}
+export function latestDelegationDecision(events) {
+    const event = [...events]
+        .reverse()
+        .find((candidate) => candidate.type === "DELEGATION_DECIDED");
+    return event?.metadata.decision;
+}
+function buildDecision(input) {
+    return {
+        taskId: input.task.id,
+        recommendation: input.recommendation,
+        complexityScore: input.complexityScore,
+        urgency: input.urgency,
+        rationale: input.rationale,
+        blockingConditions: input.blockingConditions,
+        contextBundle: input.contextBundle,
+        expectedOutputs: input.expectedOutputs,
+        delegates: input.delegates,
+        disjointWriteScopes: scopesAreDisjoint(input.delegates),
+    };
+}
+function taskComplexityScore(task) {
+    return [
+        (task.acceptanceCriteria ?? []).length >= 3,
+        (task.paths ?? []).length >= 2,
+        (task.risks ?? []).length > 0,
+        (task.dependencies ?? []).length > 0,
+        Boolean(task.scope),
+        Boolean(task.testStrategy),
+        Boolean(task.architectureApproval?.proposal),
+        Boolean(task.riskGate?.impactAreas?.length),
+    ].filter(Boolean).length;
+}
+function taskUrgency(task) {
+    const text = [task.title, task.goal, task.scope, ...(task.risks ?? [])]
+        .filter(Boolean)
+        .join(" ")
+        .toLowerCase();
+    return /urgent|hotfix|incident|production|critical/.test(text)
+        ? "high"
+        : "normal";
+}
+function delegationBlockingConditions(task, dependencies, taskLocks) {
+    const blockers = [];
+    if (COMPLETE_STATUSES.has(task.status)) {
+        blockers.push("task is already complete or canceled");
+    }
+    if (!hasSufficientContext(task)) {
+        blockers.push("task is missing goal, scope, or acceptance criteria");
+    }
+    if (!dependencies.isSatisfied) {
+        blockers.push("incomplete dependencies: " +
+            dependencies.incomplete.map((dependency) => dependency.id).join(", "));
+    }
+    if (taskLocks.length > 0) {
+        blockers.push("active locks: " + taskLocks.map((lock) => lock.id).join(", "));
+    }
+    return blockers;
+}
+function hasSufficientContext(task) {
+    return Boolean(task.goal ||
+        task.scope ||
+        task.backlogItem ||
+        (task.acceptanceCriteria && task.acceptanceCriteria.length > 0));
+}
+function requiredContextBundle(input, events) {
+    const bundle = [
+        "task brief",
+        "owner role",
+        "dependencies",
+        "locks",
+        "acceptance criteria",
+        "paths",
+        "risks",
+    ];
+    if (events.some((event) => event.type === "DECISION_RECORDED")) {
+        bundle.push("decisions");
+    }
+    if (events.some((event) => event.type === "HANDOFF_READY")) {
+        bundle.push("handoffs");
+    }
+    if (events.some((event) => event.type === "EVIDENCE_ADDED")) {
+        bundle.push("evidence");
+    }
+    if (input.skills?.selected.length) {
+        bundle.push("selected skills");
+    }
+    return bundle;
+}
+function delegationRationale(task, complexityScore, urgency) {
+    return [
+        "Complexity score: " + complexityScore,
+        "Urgency: " + urgency,
+        "Owner role: " + task.ownerRole,
+    ];
+}
+function needsReviewDelegation(task, events) {
+    return (REVIEW_STATUSES.has(task.status) ||
+        events.some((event) => ["HANDOFF_READY", "EVIDENCE_ADDED", "REVIEW_RECORDED"].includes(event.type)));
+}
+function candidateAssignments(task, roleIds) {
+    const assignments = new Map();
+    const add = (role, rationale, scopes) => {
+        if (!roleIds.has(role)) {
+            return;
+        }
+        const existing = assignments.get(role);
+        assignments.set(role, existing
+            ? {
+                ...existing,
+                rationale: unique(existing.rationale.concat(rationale)),
+                writeScopes: unique(existing.writeScopes.concat(scopes)),
+            }
+            : assignment(role, "execute", rationale, scopes));
+    };
+    if (task.ownerRole !== "parent") {
+        add(task.ownerRole, ["Task owner role matches delivery responsibility."], task.paths ?? []);
+    }
+    for (const area of task.riskGate?.impactAreas ?? []) {
+        const role = riskAreaRole(area);
+        if (role) {
+            add(role, ["Risk impact area requires specialist review: " + area], task.paths ?? []);
+        }
+    }
+    for (const risk of task.risks ?? []) {
+        const role = riskTextRole(risk);
+        if (role) {
+            add(role, ["Risk text indicates specialist: " + risk], task.paths ?? []);
+        }
+    }
+    for (const filePath of task.paths ?? []) {
+        const role = pathRole(filePath);
+        if (role) {
+            add(role, ["Path signal matches role: " + filePath], [filePath]);
+        }
+    }
+    return [...assignments.values()].sort((left, right) => left.role.localeCompare(right.role));
+}
+function assignment(role, mode, rationale, writeScopes) {
+    return {
+        role,
+        mode,
+        rationale,
+        writeScopes: unique(writeScopes),
+        expectedOutputs: mode === "review"
+            ? ["review findings", "approval or blocking recommendation"]
+            : ["role-scoped artifact", "tests or evidence", "handoff summary"],
+    };
+}
+function shouldDelegateSingle(task, complexityScore) {
+    return complexityScore >= 2 || Boolean(task.risks?.length);
+}
+function scopesAreDisjoint(assignments) {
+    const scopes = assignments.flatMap((assignment) => assignment.writeScopes);
+    if (scopes.length === 0) {
+        return assignments.length <= 1;
+    }
+    for (let index = 0; index < scopes.length; index += 1) {
+        const current = scopes[index];
+        if (!current) {
+            continue;
+        }
+        for (const other of scopes.slice(index + 1)) {
+            if (pathsConflict(current, other)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+function locksForTask(task, locks) {
+    return locks.filter((lock) => {
+        if (lock.taskId === task.id) {
+            return true;
+        }
+        return (task.paths ?? []).some((filePath) => pathsConflict(filePath, lock.path));
+    });
+}
+function dependencyReportForTask(task, tasks) {
+    const dependencies = (task.dependencies ?? []).map((dependencyId) => {
+        const dependency = tasks.find((candidate) => candidate.id === dependencyId);
+        if (!dependency) {
+            throw new Error("task " + task.id + " has unknown dependency: " + dependencyId);
+        }
+        return {
+            id: dependency.id,
+            status: dependency.status,
+            isComplete: ["approved", "done"].includes(dependency.status),
+        };
+    });
+    const incomplete = dependencies.filter((dependency) => !dependency.isComplete);
+    return {
+        taskId: task.id,
+        isSatisfied: incomplete.length === 0,
+        dependencies,
+        incomplete,
+    };
+}
+function riskAreaRole(area) {
+    return {
+        security: "security",
+        sre: "sre",
+        dba: "dba",
+        data: "data_engineer",
+        devops: "devops",
+        compliance: "compliance_privacy",
+        accessibility: "accessibility_reviewer",
+        ux: "ux_ui_designer",
+    }[area];
+}
+function riskTextRole(risk) {
+    const value = risk.toLowerCase();
+    if (/security|auth|secret|token/.test(value))
+        return "security";
+    if (/database|migration|query|schema/.test(value))
+        return "dba";
+    if (/data pipeline|data contract|analytics|lineage|backfill|etl/.test(value))
+        return "data_engineer";
+    if (/deploy|pipeline|infra|rollback/.test(value))
+        return "devops";
+    if (/availability|slo|latency|incident/.test(value))
+        return "sre";
+    if (/privacy|compliance|pii|retention/.test(value))
+        return "compliance_privacy";
+    if (/accessibility|screen reader|keyboard|focus|wcag/.test(value))
+        return "accessibility_reviewer";
+    if (/ux|responsive|mobile/.test(value))
+        return "ux_ui_designer";
+    return undefined;
+}
+function pathRole(filePath) {
+    const normalized = normalizePath(filePath);
+    if (/^(web|frontend|client|app)\//.test(normalized) ||
+        /\.(css|tsx|jsx)$/.test(normalized)) {
+        return "frontend_specialist";
+    }
+    if (/^(api|backend|server|services?)\//.test(normalized)) {
+        return "backend_specialist";
+    }
+    if (/^(mobile|ios|android)\//.test(normalized)) {
+        return "mobile_specialist";
+    }
+    if (/^(infra|terraform|k8s|\.github)\//.test(normalized) ||
+        /docker/.test(normalized)) {
+        return "devops";
+    }
+    if (/^(db|database|migrations)\//.test(normalized) ||
+        /\.sql$/.test(normalized)) {
+        return "dba";
+    }
+    if (/^(test|tests|e2e)\//.test(normalized) || /playwright/.test(normalized)) {
+        return "sdet";
+    }
+    if (/^(docs|documentation)\//.test(normalized) || /readme/.test(normalized)) {
+        return "technical_writer";
+    }
+    return undefined;
+}
+function pathsConflict(left, right) {
+    const normalizedLeft = normalizePath(left);
+    const normalizedRight = normalizePath(right);
+    return (normalizedLeft === normalizedRight ||
+        normalizedLeft.startsWith(normalizedRight + "/") ||
+        normalizedRight.startsWith(normalizedLeft + "/"));
+}
+function normalizePath(value) {
+    return value.split(path.sep).join("/").replace(/^\.\//, "");
+}
+function unique(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+//# sourceMappingURL=delegation-decision.js.map

package/dist/delegation-decision.js.map

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

package/dist/detect-commands.d.ts

@@ -0,0 +1,3 @@
+import type { CliIo, CliOptions } from "./types.js";
+export declare function detectProfileCommand(options: CliOptions, io: CliIo): Promise<void>;
+export declare function detectAcceptCommand(options: CliOptions, io: CliIo): Promise<void>;

package/dist/detect-commands.js

@@ -0,0 +1,28 @@
+import { acceptDetectedProjectProfile, detectProjectProfile, } from "./project-detection.js";
+export async function detectProfileCommand(options, io) {
+    const report = await detectProjectProfile();
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    io.log("Detected project profile signals: " + report.signals.length);
+    for (const signal of report.signals) {
+        io.log("- " + signal.id + ": " + signal.evidence.join(", "));
+    }
+    io.log("Recommended roles: " + report.recommendedRoles.join(", "));
+    io.log("Recommended skills: " + report.recommendedSkills.join(", "));
+}
+export async function detectAcceptCommand(options, io) {
+    const report = await acceptDetectedProjectProfile({
+        outputPath: stringOption(options.output) ?? ".agent-workflow/detected-profile.json",
+    });
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    io.log("Accepted detected profile with " + report.signals.length + " signal(s)");
+}
+function stringOption(value) {
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=detect-commands.js.map

package/dist/detect-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-commands.js","sourceRoot":"","sources":["../src/detect-commands.ts"],"names":[],"mappings":"AACA,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC5C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,oCAAoC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,qBAAqB,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,EAAE,CAAC,GAAG,CAAC,sBAAsB,GAAG,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAAC;QAChD,UAAU,EACR,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,uCAAuC;KAC1E,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CACJ,iCAAiC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,YAAY,CACzE,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,KAA8C;IAE9C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC"}

package/dist/diagram-validation.d.ts

@@ -0,0 +1,36 @@
+export interface CommandRunResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface DiagramCommandRunner {
+    run(command: string, args: string[]): Promise<CommandRunResult>;
+}
+export interface DiagramLintResult {
+    valid: boolean;
+    tool: "mmdc";
+    command: string;
+    args: string[];
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    missingTool: boolean;
+    installHint?: string;
+}
+export interface DiagramEvidenceResult {
+    artifact: string;
+    content: string;
+}
+export type DiagramQuestionDomain = "architecture" | "workflow" | "integration" | "data" | "deployment";
+export declare const diagramTypeDecisionMatrix: Record<DiagramQuestionDomain, string>;
+export declare function recommendDiagramType(domain: DiagramQuestionDomain): string;
+export declare function lintMermaidDiagram({ content, filePath, runner, }: {
+    content?: string;
+    filePath?: string;
+    runner?: DiagramCommandRunner;
+}): Promise<DiagramLintResult>;
+export declare function recordDiagramLintEvidence({ taskId, result, root, }: {
+    taskId: string;
+    result: DiagramLintResult;
+    root?: string;
+}): Promise<DiagramEvidenceResult>;

package/dist/diagram-validation.js

@@ -0,0 +1,118 @@
+import { execFile } from "node:child_process";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { appendEvent, writeArtifact } from "./workspace.js";
+const MERMAID_CLI_INSTALL_HINT = "Install Mermaid CLI with npm install -D @mermaid-js/mermaid-cli or provide mmdc on PATH.";
+export const diagramTypeDecisionMatrix = {
+    architecture: "C4/container or component diagram",
+    workflow: "flowchart or state diagram",
+    integration: "sequence diagram",
+    data: "entity relationship diagram",
+    deployment: "deployment or infrastructure diagram",
+};
+export function recommendDiagramType(domain) {
+    return diagramTypeDecisionMatrix[domain];
+}
+export async function lintMermaidDiagram({ content, filePath, runner = defaultDiagramCommandRunner, }) {
+    const tempDir = await mkdtemp(path.join(os.tmpdir(), "orchestra-mermaid-"));
+    const inputPath = path.join(tempDir, "diagram.mmd");
+    const outputPath = path.join(tempDir, "diagram.svg");
+    const diagramContent = content ?? (filePath ? await readFile(filePath, "utf8") : "");
+    if (diagramContent.trim() === "") {
+        throw new Error("diagram content is required");
+    }
+    await writeFile(inputPath, diagramContent, "utf8");
+    const args = ["-i", inputPath, "-o", outputPath];
+    try {
+        const result = await runner.run("mmdc", args);
+        return {
+            valid: result.exitCode === 0,
+            tool: "mmdc",
+            command: "mmdc",
+            args,
+            exitCode: result.exitCode,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            missingTool: false,
+        };
+    }
+    catch (error) {
+        if (isMissingToolError(error)) {
+            return {
+                valid: false,
+                tool: "mmdc",
+                command: "mmdc",
+                args,
+                exitCode: null,
+                stdout: "",
+                stderr: String(error.message || error),
+                missingTool: true,
+                installHint: MERMAID_CLI_INSTALL_HINT,
+            };
+        }
+        throw error;
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+export async function recordDiagramLintEvidence({ taskId, result, root = process.cwd(), }) {
+    const fileName = `${taskId}-${Date.now()}-diagram-lint.md`;
+    const content = [
+        `# Mermaid Diagram Lint Evidence ${taskId}`,
+        "",
+        `- Tool: ${result.tool}`,
+        `- Command: ${result.command} ${result.args.join(" ")}`,
+        `- Exit code: ${result.exitCode ?? "missing-tool"}`,
+        `- Valid: ${result.valid}`,
+        `- Missing tool: ${result.missingTool}`,
+        result.installHint ? `- Install hint: ${result.installHint}` : "",
+        "",
+        "## stderr",
+        "",
+        result.stderr || "not applicable",
+        "",
+    ]
+        .filter((line) => line !== "")
+        .join("\n");
+    const artifact = await writeArtifact(root, "evidence", fileName, content);
+    await appendEvent(root, {
+        type: "EVIDENCE_ADDED",
+        taskId,
+        actor: "architect",
+        summary: result.valid
+            ? "Mermaid diagram lint passed"
+            : "Mermaid diagram lint did not pass",
+        artifacts: [artifact],
+        metadata: {
+            type: "diagram-lint",
+            exitCode: result.exitCode,
+            missingTool: result.missingTool,
+        },
+    });
+    return { artifact, content };
+}
+const defaultDiagramCommandRunner = {
+    run(command, args) {
+        return new Promise((resolve, reject) => {
+            execFile(command, args, (error, stdout, stderr) => {
+                if (error?.code === "ENOENT") {
+                    reject(error);
+                    return;
+                }
+                const errorCode = error?.code;
+                const exitCode = typeof errorCode === "number" ? errorCode : 0;
+                resolve({
+                    exitCode,
+                    stdout: String(stdout),
+                    stderr: String(stderr),
+                });
+            });
+        });
+    },
+};
+function isMissingToolError(error) {
+    return error?.code === "ENOENT";
+}
+//# sourceMappingURL=diagram-validation.js.map

package/dist/diagram-validation.js.map

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

package/dist/fs-utils.d.ts

@@ -4,5 +4,7 @@ export declare function readJson<T>(filePath: string, fallback: T): Promise<T>;
 export declare function writeJson(filePath: string, value: unknown, { overwrite }?: {
     overwrite?: boolean | undefined;
 }): Promise<void>;
+export declare function updateJsonFile<T>(filePath: string, fallback: T, update: (current: T) => T | Promise<T>): Promise<T>;
 export declare function appendJsonLine(filePath: string, value: unknown): Promise<void>;
 export declare function resolveWorkflowPath(root: string, ...segments: string[]): string;
+export declare function resolveWorkspaceWritePath(root: string, relativePath: string): string;