@jterrats/open-orchestra 0.1.0 → 0.2.1

package/dist/fs-utils.js

@@ -1,6 +1,8 @@
-import { access, mkdir, readFile, writeFile, appendFile, } from "node:fs/promises";
+import { access, appendFile, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
 import { constants as fsConstants } from "node:fs";
 import path from "node:path";
+const FILE_LOCK_RETRY_MS = 25;
+const FILE_LOCK_TIMEOUT_MS = 5000;
 export async function exists(filePath) {
     try {
         await access(filePath, fsConstants.F_OK);
@@ -21,15 +23,82 @@ export async function readJson(filePath, fallback) {
     return JSON.parse(content);
 }
 export async function writeJson(filePath, value, { overwrite = true } = {}) {
-    if (!overwrite && (await exists(filePath))) {
-        throw new Error(`${filePath} already exists`);
-    }
-    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    await withFileLock(filePath, async () => {
+        if (!overwrite && (await exists(filePath))) {
+            throw new Error(`${filePath} already exists`);
+        }
+        await writeJsonAtomic(filePath, value);
+    });
+}
+export async function updateJsonFile(filePath, fallback, update) {
+    return withFileLock(filePath, async () => {
+        const current = await readJson(filePath, fallback);
+        const next = await update(current);
+        await writeJsonAtomic(filePath, next);
+        return next;
+    });
 }
 export async function appendJsonLine(filePath, value) {
-    await appendFile(filePath, `${JSON.stringify(value)}\n`, "utf8");
+    await withFileLock(filePath, async () => {
+        await appendFile(filePath, `${JSON.stringify(value)}\n`, "utf8");
+    });
 }
 export function resolveWorkflowPath(root, ...segments) {
     return path.join(root, ".agent-workflow", ...segments);
 }
+export function resolveWorkspaceWritePath(root, relativePath) {
+    if (path.isAbsolute(relativePath)) {
+        throw new Error("workspace write path must be relative");
+    }
+    const normalizedRoot = path.resolve(root);
+    const resolvedPath = path.resolve(normalizedRoot, relativePath);
+    const relativeToRoot = path.relative(normalizedRoot, resolvedPath);
+    if (relativeToRoot === "" || relativeToRoot.startsWith("..")) {
+        throw new Error("workspace write path must stay inside the workspace");
+    }
+    return resolvedPath;
+}
+async function writeJsonAtomic(filePath, value) {
+    const tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    await rename(tempPath, filePath);
+}
+async function withFileLock(filePath, operation) {
+    await ensureDir(path.dirname(filePath));
+    const lockPath = `${filePath}.lock`;
+    const startedAt = Date.now();
+    while (true) {
+        try {
+            await mkdir(lockPath);
+            break;
+        }
+        catch (error) {
+            if (!isAlreadyExistsError(error)) {
+                throw error;
+            }
+            if (Date.now() - startedAt >= FILE_LOCK_TIMEOUT_MS) {
+                throw new Error(`timed out waiting for file lock: ${filePath}`, {
+                    cause: error,
+                });
+            }
+            await delay(FILE_LOCK_RETRY_MS);
+        }
+    }
+    try {
+        return await operation();
+    }
+    finally {
+        await rm(lockPath, { recursive: true, force: true });
+    }
+}
+function isAlreadyExistsError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        error.code === "EEXIST");
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, milliseconds);
+    });
+}
 //# sourceMappingURL=fs-utils.js.map

package/dist/fs-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,EACL,QAAQ,EACR,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,QAAgB,EAAE,QAAW;IAC7D,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,KAAc,EACd,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,EAAE;IAEzB,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,iBAAiB,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,KAAc;IAEd,MAAM,UAAU,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,GAAG,QAAkB;IAErB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"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"}

package/dist/health-checks.d.ts

@@ -0,0 +1,28 @@
+import type { WorkspaceClassification } from "./types.js";
+export type HealthStatus = "pass" | "warn" | "fail" | "not_checked";
+export interface HealthCheckItem {
+    id: string;
+    label: string;
+    status: HealthStatus;
+    message: string;
+    remediation?: string;
+    details?: Record<string, unknown>;
+}
+export interface HealthCheckReport {
+    generatedAt: string;
+    packageRoot: string;
+    overallStatus: "healthy" | "degraded" | "unhealthy";
+    workspaceClassification: WorkspaceClassification;
+    checks: HealthCheckItem[];
+}
+export interface CommandResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export type HealthCommandRunner = (command: string, args: string[]) => Promise<CommandResult>;
+export declare function getLocalHealthReport({ root, includeNetwork, runner, }?: {
+    root?: string;
+    includeNetwork?: boolean;
+    runner?: HealthCommandRunner;
+}): Promise<HealthCheckReport>;

package/dist/health-checks.js

@@ -0,0 +1,219 @@
+import { execFile } from "node:child_process";
+import { access, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { validateWorkspace } from "./workspace-validator.js";
+import { classifyWorkspace } from "./workspace-classification.js";
+const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+const COMMAND_TIMEOUT_MS = 3000;
+export async function getLocalHealthReport({ root = process.cwd(), includeNetwork = false, runner = runCommand, } = {}) {
+    const packageJson = await readPackageJson();
+    const workspaceClassification = await classifyWorkspace({ root });
+    const checks = [
+        packageCheck(packageJson),
+        workspaceClassificationCheck(workspaceClassification),
+        await commandVersionCheck("node", "Node.js", ["--version"], runner),
+        await commandVersionCheck("npm", "npm", ["--version"], runner),
+        await commandVersionCheck("git", "Git", ["--version"], runner),
+        await githubAuthCheck(includeNetwork, runner),
+        await playwrightAvailabilityCheck(packageJson),
+        await workflowValidationCheck(root),
+    ];
+    return {
+        generatedAt: new Date().toISOString(),
+        packageRoot: PACKAGE_ROOT,
+        workspaceClassification,
+        overallStatus: overallHealthStatus(checks),
+        checks,
+    };
+}
+async function readPackageJson() {
+    return JSON.parse(await readFile(join(PACKAGE_ROOT, "package.json"), "utf8"));
+}
+function packageCheck(packageJson) {
+    const name = typeof packageJson.name === "string" ? packageJson.name : "unknown";
+    const version = typeof packageJson.version === "string" ? packageJson.version : "unknown";
+    const item = {
+        id: "package",
+        label: "Open Orchestra package",
+        status: version === "unknown" ? "fail" : "pass",
+        message: name + "@" + version,
+        details: { name, version, packageRoot: PACKAGE_ROOT },
+    };
+    if (version === "unknown") {
+        item.remediation = "Verify package.json contains name and version.";
+    }
+    return item;
+}
+function workspaceClassificationCheck(classification) {
+    if (classification.writePolicy === "blocked") {
+        return {
+            id: "workspace-classification",
+            label: "Workspace classification",
+            status: "fail",
+            message: `Workspace is ${classification.kind}.`,
+            remediation: classification.recommendedAction,
+            details: { classification },
+        };
+    }
+    if (classification.writePolicy === "confirm_required") {
+        return {
+            id: "workspace-classification",
+            label: "Workspace classification",
+            status: "warn",
+            message: "Workspace requires explicit init confirmation.",
+            remediation: classification.recommendedAction,
+            details: { classification },
+        };
+    }
+    return {
+        id: "workspace-classification",
+        label: "Workspace classification",
+        status: "pass",
+        message: `Workspace is ${classification.kind}.`,
+        details: { classification },
+    };
+}
+async function commandVersionCheck(command, label, args, runner) {
+    const result = await runner(command, args).catch((error) => ({
+        exitCode: 127,
+        stdout: "",
+        stderr: error instanceof Error ? error.message : String(error),
+    }));
+    if (result.exitCode !== 0) {
+        return {
+            id: command,
+            label,
+            status: "fail",
+            message: label + " is not available.",
+            remediation: "Install " + command + " and ensure it is on PATH.",
+            details: { stderr: result.stderr },
+        };
+    }
+    return {
+        id: command,
+        label,
+        status: "pass",
+        message: result.stdout.trim() || label + " command succeeded.",
+    };
+}
+async function githubAuthCheck(includeNetwork, runner) {
+    const ghVersion = await runner("gh", ["--version"]).catch(() => null);
+    if (!ghVersion || ghVersion.exitCode !== 0) {
+        return {
+            id: "github-auth",
+            label: "GitHub auth",
+            status: "warn",
+            message: "GitHub CLI is not available.",
+            remediation: "Install gh and run gh auth login when GitHub integration is needed.",
+        };
+    }
+    if (!includeNetwork) {
+        return {
+            id: "github-auth",
+            label: "GitHub auth",
+            status: "not_checked",
+            message: "Skipped to avoid network calls.",
+            remediation: "Run orchestra health --network to check gh auth status.",
+        };
+    }
+    const auth = await runner("gh", ["auth", "status"]).catch((error) => ({
+        exitCode: 1,
+        stdout: "",
+        stderr: error instanceof Error ? error.message : String(error),
+    }));
+    return auth.exitCode === 0
+        ? {
+            id: "github-auth",
+            label: "GitHub auth",
+            status: "pass",
+            message: "gh auth status passed.",
+        }
+        : {
+            id: "github-auth",
+            label: "GitHub auth",
+            status: "warn",
+            message: "gh auth status failed.",
+            remediation: "Run gh auth login or verify token scopes.",
+            details: { stderr: auth.stderr },
+        };
+}
+async function playwrightAvailabilityCheck(packageJson) {
+    const dependencyNames = packageDependencyNames(packageJson);
+    const hasPlaywrightDependency = dependencyNames.has("@playwright/test") ||
+        dependencyNames.has("playwright");
+    const hasLocalBinary = await fileExists(join(PACKAGE_ROOT, "node_modules", ".bin", "playwright"));
+    if (hasPlaywrightDependency || hasLocalBinary) {
+        return {
+            id: "playwright",
+            label: "Playwright/browser tooling",
+            status: "pass",
+            message: "Playwright tooling is available locally.",
+            details: {
+                dependency: hasPlaywrightDependency,
+                localBinary: hasLocalBinary,
+            },
+        };
+    }
+    return {
+        id: "playwright",
+        label: "Playwright/browser tooling",
+        status: "warn",
+        message: "Playwright is not installed in this package.",
+        remediation: "Install @playwright/test and run npx playwright install when browser evidence is required.",
+    };
+}
+async function workflowValidationCheck(root) {
+    const report = await validateWorkspace(root).catch((error) => ({
+        valid: false,
+        errors: [
+            { message: error instanceof Error ? error.message : String(error) },
+        ],
+    }));
+    if (report.valid) {
+        return {
+            id: "workflow",
+            label: "Workflow readiness",
+            status: "pass",
+            message: "Workspace valid.",
+        };
+    }
+    return {
+        id: "workflow",
+        label: "Workflow readiness",
+        status: "fail",
+        message: "Workspace validation failed.",
+        remediation: "Run orchestra validate --json and fix reported workflow errors.",
+        details: { errors: report.errors },
+    };
+}
+function packageDependencyNames(packageJson) {
+    return new Set([
+        ...Object.keys(packageJson.dependencies ?? {}),
+        ...Object.keys(packageJson.devDependencies ?? {}),
+    ]);
+}
+async function fileExists(filePath) {
+    return access(filePath).then(() => true, () => false);
+}
+function overallHealthStatus(checks) {
+    if (checks.some((check) => check.status === "fail")) {
+        return "unhealthy";
+    }
+    if (checks.some((check) => check.status === "warn" || check.status === "not_checked")) {
+        return "degraded";
+    }
+    return "healthy";
+}
+function runCommand(command, args) {
+    return new Promise((resolve) => {
+        execFile(command, args, { timeout: COMMAND_TIMEOUT_MS }, (error, stdout, stderr) => {
+            resolve({
+                exitCode: typeof error?.code === "number" ? error.code : error ? 1 : 0,
+                stdout,
+                stderr,
+            });
+        });
+    });
+}
+//# sourceMappingURL=health-checks.js.map

package/dist/health-checks.js.map

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

package/dist/health-commands.d.ts

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

package/dist/health-commands.js

@@ -0,0 +1,18 @@
+import { getLocalHealthReport } from "./health-checks.js";
+export async function healthCommand(options, io) {
+    const report = await getLocalHealthReport({
+        includeNetwork: Boolean(options.network),
+    });
+    if (options.json) {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    io.log("Open Orchestra health: " + report.overallStatus);
+    for (const check of report.checks) {
+        io.log("- " + check.id + " [" + check.status + "]: " + check.message);
+        if (check.remediation) {
+            io.log("  fix: " + check.remediation);
+        }
+    }
+}
+//# sourceMappingURL=health-commands.js.map

package/dist/health-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-commands.js","sourceRoot":"","sources":["../src/health-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;QACxC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;KACzC,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,CAAC,yBAAyB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,EAAE,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/instruction-apply.d.ts

@@ -0,0 +1,34 @@
+import { type InstructionFileSpec } from "./instruction-updates.js";
+export interface InstructionUpdateManifest {
+    files?: InstructionUpdateManifestFile[];
+}
+export type InstructionUpdateMode = "apply" | "check" | "dry-run";
+export interface InstructionUpdateManifestFile extends Omit<InstructionFileSpec, "content"> {
+    content?: string;
+    contentPath?: string;
+}
+export interface InstructionApplyItem {
+    filePath: string;
+    blockId: string;
+    status: "changed" | "unchanged" | "blocked";
+    changed: boolean;
+    drift: boolean;
+    missing: boolean;
+    mode: InstructionUpdateMode;
+    hash: string;
+    existingHash?: string;
+    reason: string;
+}
+export interface InstructionApplyReport {
+    items: InstructionApplyItem[];
+    totals: Record<InstructionApplyItem["status"], number>;
+    mode: InstructionUpdateMode;
+    force: boolean;
+}
+export declare function applyInstructionUpdatesFromManifest({ root, manifestPath, check, dryRun, force, }: {
+    root?: string;
+    manifestPath: string;
+    check?: boolean;
+    dryRun?: boolean;
+    force?: boolean;
+}): Promise<InstructionApplyReport>;

package/dist/instruction-apply.js

@@ -0,0 +1,150 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { ensureDir, resolveWorkspaceWritePath } from "./fs-utils.js";
+import { checkManagedInstructionBlock, upsertManagedInstructionBlock, } from "./instruction-updates.js";
+export async function applyInstructionUpdatesFromManifest({ root = process.cwd(), manifestPath, check = false, dryRun = false, force = false, }) {
+    const manifest = await readInstructionUpdateManifest(manifestPath);
+    const mode = instructionUpdateMode({ check, dryRun });
+    const items = [];
+    for (const manifestFile of manifest.files ?? []) {
+        items.push(await applyInstructionUpdateFile(root, manifestFile, {
+            mode,
+            force,
+        }));
+    }
+    return { items, totals: summarizeInstructionApplyItems(items), mode, force };
+}
+async function applyInstructionUpdateFile(root, manifestFile, options) {
+    const filePath = resolveWorkspaceWritePath(root, manifestFile.filePath);
+    const existingContent = await readFile(filePath, "utf8").catch(() => "");
+    const generatedContent = await resolveGeneratedInstructionContent(root, manifestFile);
+    const blockInput = { ...manifestFile, content: generatedContent };
+    const result = options.mode === "check"
+        ? checkManagedInstructionBlock(existingContent, blockInput)
+        : upsertManagedInstructionBlock(existingContent, blockInput, {
+            force: options.force,
+        });
+    const isBlocked = result.drift && !options.force;
+    const nextContent = isBlocked
+        ? existingContent
+        : applyTargetCompatibleMetadata(result.content, manifestFile, result.hash);
+    const changed = nextContent !== existingContent;
+    if (options.mode === "apply" && !isBlocked && changed) {
+        await ensureDir(path.dirname(filePath));
+        await writeFile(filePath, nextContent);
+    }
+    return removeUndefinedApplyItem({
+        filePath: manifestFile.filePath,
+        blockId: manifestFile.blockId,
+        status: isBlocked ? "blocked" : result.changed ? "changed" : "unchanged",
+        changed,
+        drift: result.drift,
+        missing: result.missing,
+        mode: options.mode,
+        hash: result.hash,
+        existingHash: result.existingHash,
+        reason: applyInstructionReason(changed, isBlocked),
+    });
+}
+async function readInstructionUpdateManifest(manifestPath) {
+    return JSON.parse(await readFile(manifestPath, "utf8"));
+}
+async function resolveGeneratedInstructionContent(root, manifestFile) {
+    if (manifestFile.content !== undefined) {
+        return manifestFile.content;
+    }
+    if (manifestFile.contentPath !== undefined) {
+        return readFile(resolveWorkspaceWritePath(root, manifestFile.contentPath), "utf8");
+    }
+    throw new Error("instruction manifest file is missing content: " + manifestFile.filePath);
+}
+function instructionUpdateMode(input) {
+    if (input.check) {
+        return "check";
+    }
+    if (input.dryRun) {
+        return "dry-run";
+    }
+    return "apply";
+}
+function applyTargetCompatibleMetadata(content, manifestFile, contentHash) {
+    if (manifestFile.target !== "cursor" &&
+        !manifestFile.filePath.endsWith(".mdc")) {
+        return content;
+    }
+    return upsertCursorMdcFrontmatter(content, {
+        blockId: manifestFile.blockId,
+        generator: manifestFile.generator,
+        version: manifestFile.version,
+        target: manifestFile.target,
+        sourceManifest: manifestFile.sourceManifest,
+        contentHash,
+        updatedAt: readManagedBlockUpdatedAt(content),
+    });
+}
+function upsertCursorMdcFrontmatter(content, metadata) {
+    const metadataLines = [
+        "open_orchestra:",
+        "  block_id: " + metadata.blockId,
+        "  generator: " + metadata.generator,
+        "  version: " + metadata.version,
+        "  target: " + metadata.target,
+        "  source_manifest: " + metadata.sourceManifest,
+        "  content_sha256: " + metadata.contentHash,
+        "  updated_at: " + metadata.updatedAt,
+    ];
+    if (!content.startsWith("---\n")) {
+        return ["---", ...metadataLines, "---", content].join("\n");
+    }
+    const closingIndex = content.indexOf("\n---", 4);
+    if (closingIndex === -1) {
+        return content;
+    }
+    const frontmatter = content.slice(4, closingIndex).split("\n");
+    const preservedFrontmatter = removeExistingOpenOrchestraFrontmatter(frontmatter);
+    const body = content.slice(closingIndex + "\n---".length);
+    return (["---", ...preservedFrontmatter, ...metadataLines, "---"].join("\n") + body);
+}
+function removeExistingOpenOrchestraFrontmatter(lines) {
+    const result = [];
+    let skippingOpenOrchestra = false;
+    for (const line of lines) {
+        if (line === "open_orchestra:") {
+            skippingOpenOrchestra = true;
+            continue;
+        }
+        if (skippingOpenOrchestra && line.startsWith("  ")) {
+            continue;
+        }
+        skippingOpenOrchestra = false;
+        result.push(line);
+    }
+    return result.filter((line) => line.trim() !== "");
+}
+function readManagedBlockUpdatedAt(content) {
+    const match = content.match(/updated-at="([^"]+)"/);
+    return match?.[1] ?? new Date().toISOString();
+}
+function applyInstructionReason(changed, blocked) {
+    if (blocked) {
+        return "managed block drifted; rerun with force to overwrite";
+    }
+    return changed
+        ? "managed block can be updated"
+        : "managed block already matches source";
+}
+function summarizeInstructionApplyItems(items) {
+    const totals = {
+        changed: 0,
+        unchanged: 0,
+        blocked: 0,
+    };
+    for (const item of items) {
+        totals[item.status] += 1;
+    }
+    return totals;
+}
+function removeUndefinedApplyItem(value) {
+    return Object.fromEntries(Object.entries(value).filter((entry) => entry[1] !== undefined));
+}
+//# sourceMappingURL=instruction-apply.js.map

package/dist/instruction-apply.js.map

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

package/dist/instruction-blocks.d.ts

@@ -0,0 +1,22 @@
+import type { ManagedInstructionBlockInput, ManagedInstructionBlockResult } from "./instruction-types.js";
+export declare function renderManagedInstructionBlock(input: ManagedInstructionBlockInput): string;
+export declare function upsertManagedInstructionBlock(existing: string, input: ManagedInstructionBlockInput, options?: {
+    force?: boolean;
+}): ManagedInstructionBlockResult;
+export declare function checkManagedInstructionBlock(existing: string, input: ManagedInstructionBlockInput): ManagedInstructionBlockResult;
+export declare function updateManagedInstructionFile({ filePath, contentPath, input, check, dryRun, force, }: {
+    filePath: string;
+    contentPath: string;
+    input: Omit<ManagedInstructionBlockInput, "content">;
+    check?: boolean;
+    dryRun?: boolean;
+    force?: boolean;
+}): Promise<ManagedInstructionBlockResult>;
+export declare function findManagedBlock(existing: string, blockId: string): {
+    start: number;
+    end: number;
+    metadataHash: string;
+    actualHash: string;
+    attributes: Map<string, string>;
+} | null;
+export declare function hashContent(content: string): string;