@evalops/maestro 0.10.50 → 0.10.53

package/dist/agent/mission-artifacts.js

@@ -0,0 +1,438 @@
+import { existsSync, mkdirSync, realpathSync } from "node:fs";
+import { basename, dirname, join, normalize, resolve, sep } from "node:path";
+import YAML from "yaml";
+import { writeJsonFile, writeTextFileAtomic } from "../utils/fs.js";
+import { isRecord } from "../utils/json.js";
+import { isMissionFeature } from "./mission-manifest.js";
+import { MISSION_STORE_SCHEMA, getMissionDir, getMissionStoreRoot, sanitizeMissionId, } from "./mission-store.js";
+export const MISSION_ARTIFACT_VERSION = 1;
+const MISSION_ARTIFACT_ESCAPE_MESSAGE = "Mission artifact path resolves outside the mission store.";
+export function getMissionArtifactLayout(missionId, rootDir) {
+    const missionDir = getMissionDir(missionId, rootDir);
+    return {
+        missionDir,
+        missionMarkdown: join(missionDir, "mission.md"),
+        architectureMarkdown: join(missionDir, "architecture.md"),
+        validationContractMarkdown: join(missionDir, "validation-contract.md"),
+        validationStateJson: join(missionDir, "validation-state.json"),
+        featuresJson: join(missionDir, "features.json"),
+        agentsMarkdown: join(missionDir, "AGENTS.md"),
+        servicesYaml: join(missionDir, "services.yaml"),
+        handoffsDir: join(missionDir, "handoffs"),
+        libraryDir: join(missionDir, "library"),
+        skillsDir: join(missionDir, "skills"),
+        stateJson: join(missionDir, "state.json"),
+        progressLogJsonl: join(missionDir, "progress_log.jsonl"),
+        modelSettingsJson: join(missionDir, "model-settings.json"),
+    };
+}
+export function initializeMissionArtifacts(options) {
+    const now = options.now ?? new Date().toISOString();
+    const missionId = sanitizeMissionId(options.missionId);
+    const layout = getMissionArtifactLayout(missionId, options.rootDir);
+    mkdirSync(layout.handoffsDir, { recursive: true });
+    mkdirSync(layout.libraryDir, { recursive: true });
+    mkdirSync(layout.skillsDir, { recursive: true });
+    if (!existsSync(layout.missionMarkdown)) {
+        writeTextFileAtomic(layout.missionMarkdown, `# ${options.title ?? missionId}\n\nCreated: ${now}\n\n## Objective\n\nTBD\n`);
+    }
+    if (!existsSync(layout.architectureMarkdown)) {
+        writeTextFileAtomic(layout.architectureMarkdown, "# Architecture\n\nDocument system boundaries, responsibilities, and invariants here.\n");
+    }
+    if (!existsSync(layout.validationContractMarkdown)) {
+        writeTextFileAtomic(layout.validationContractMarkdown, "# Validation Contract\n\nAdd durable behavioral assertions before decomposing features.\n");
+    }
+    if (!existsSync(layout.validationStateJson)) {
+        writeJsonFile(layout.validationStateJson, {
+            version: MISSION_ARTIFACT_VERSION,
+            assertions: {},
+            updatedAt: now,
+        });
+    }
+    if (!existsSync(layout.featuresJson)) {
+        writeJsonFile(layout.featuresJson, {
+            version: MISSION_ARTIFACT_VERSION,
+            missionId,
+            milestones: [],
+            features: [],
+            createdAt: now,
+            updatedAt: now,
+        });
+    }
+    if (!existsSync(layout.agentsMarkdown)) {
+        writeTextFileAtomic(layout.agentsMarkdown, "# Mission Agent Guidance\n\nKeep worker guidance, known constraints, and validation notes here.\n");
+    }
+    if (!existsSync(layout.servicesYaml)) {
+        writeTextFileAtomic(layout.servicesYaml, "version: 1\ncommands: {}\nservices: {}\n");
+    }
+    return layout;
+}
+export function classifyMissionArtifactPath(filePath, rootDir) {
+    const resolved = resolveMissionArtifactPath(filePath, rootDir);
+    if (!resolved.isWithinMissionStore || resolved.escapesMissionStore) {
+        return null;
+    }
+    const afterRoot = resolved.realArtifactPath.slice(resolved.realMissionStoreRoot.length + 1);
+    const missionId = afterRoot.split(sep)[0];
+    if (!missionId)
+        return null;
+    const missionDir = join(resolved.realMissionStoreRoot, missionId);
+    const rel = resolved.realArtifactPath.slice(missionDir.length + 1);
+    const file = basename(resolved.realArtifactPath);
+    const nestedKind = rel.startsWith(`handoffs${sep}`)
+        ? "handoff"
+        : rel.startsWith(`library${sep}`)
+            ? "library"
+            : rel.startsWith(`skills${sep}`)
+                ? "skill"
+                : null;
+    if (nestedKind) {
+        return { kind: nestedKind, path: resolved.absolutePath, missionDir };
+    }
+    const kind = file === "mission.md"
+        ? "mission"
+        : file === "architecture.md"
+            ? "architecture"
+            : file === "validation-contract.md"
+                ? "validation-contract"
+                : file === "validation-state.json"
+                    ? "validation-state"
+                    : file === "features.json"
+                        ? "features"
+                        : file === "AGENTS.md"
+                            ? "agents"
+                            : file === "services.yaml" || file === "services.yml"
+                                ? "services"
+                                : file === "state.json"
+                                    ? "state"
+                                    : file === "progress_log.jsonl"
+                                        ? "progress-log"
+                                        : file === "model-settings.json"
+                                            ? "model-settings"
+                                            : null;
+    return kind ? { kind, path: resolved.absolutePath, missionDir } : null;
+}
+export function validateMissionArtifactContent(filePath, content, rootDir) {
+    const resolved = resolveMissionArtifactPath(filePath, rootDir);
+    if (resolved.escapesMissionStore) {
+        return { ok: false, message: MISSION_ARTIFACT_ESCAPE_MESSAGE };
+    }
+    const classified = classifyMissionArtifactPath(filePath, rootDir);
+    if (!classified)
+        return { ok: true };
+    try {
+        switch (classified.kind) {
+            case "features":
+                validateFeaturesJson(JSON.parse(content), basename(classified.missionDir));
+                return { ok: true };
+            case "validation-state":
+            case "model-settings":
+            case "handoff":
+                JSON.parse(content);
+                return { ok: true };
+            case "state":
+                validateMissionStateJson(JSON.parse(content), basename(classified.missionDir));
+                return { ok: true };
+            case "progress-log":
+                for (const [index, line] of content.split(/\r?\n/u).entries()) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        JSON.parse(line);
+                    }
+                    catch {
+                        return {
+                            ok: false,
+                            message: `Invalid JSONL at line ${index + 1}`,
+                        };
+                    }
+                }
+                return { ok: true };
+            case "services":
+                YAML.parse(content);
+                return { ok: true };
+            default:
+                return { ok: true };
+        }
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: error instanceof Error
+                ? error.message
+                : `Invalid mission artifact ${classified.kind}`,
+        };
+    }
+}
+export function validateMissionArtifactWrite(options) {
+    const resolved = resolveMissionArtifactPath(options.filePath, options.rootDir);
+    if (resolved.escapesMissionStore) {
+        return { ok: false, message: MISSION_ARTIFACT_ESCAPE_MESSAGE };
+    }
+    const classified = classifyMissionArtifactPath(options.filePath, options.rootDir);
+    if (!classified)
+        return { ok: true };
+    if (classified.kind === "state" ||
+        classified.kind === "progress-log" ||
+        classified.kind === "model-settings") {
+        return {
+            ok: false,
+            message: "Cannot write mission system files directly; use MissionStore APIs.",
+        };
+    }
+    if ((options.role === "worker" || options.role === "validator") &&
+        classified.kind === "features") {
+        return {
+            ok: false,
+            message: "Mission workers and validators cannot write features.json; return a handoff to the orchestrator.",
+        };
+    }
+    return validateMissionArtifactContent(options.filePath, options.content, options.rootDir);
+}
+export function validateMissionArtifactDelete(options) {
+    const resolved = resolveMissionArtifactPath(options.filePath, options.rootDir);
+    if (resolved.escapesMissionStore) {
+        return { ok: false, message: MISSION_ARTIFACT_ESCAPE_MESSAGE };
+    }
+    const classified = classifyMissionArtifactPath(options.filePath, options.rootDir);
+    if (!classified)
+        return { ok: true };
+    if (classified.kind === "handoff" ||
+        classified.kind === "library" ||
+        classified.kind === "skill") {
+        return { ok: true };
+    }
+    return {
+        ok: false,
+        message: `Cannot delete required mission artifact ${basename(classified.path)}.`,
+    };
+}
+export function detectMissionSessionRole(env = process.env) {
+    const raw = env.MAESTRO_MISSION_ROLE?.trim().toLowerCase();
+    if (raw === "orchestrator" || raw === "worker" || raw === "validator") {
+        return raw;
+    }
+    if (env.MAESTRO_MISSION_WORKER === "1")
+        return "worker";
+    if (env.MAESTRO_MISSION_VALIDATOR === "1")
+        return "validator";
+    return undefined;
+}
+export function summarizeMissionSnapshot(snapshot) {
+    const counts = snapshot.features.reduce((acc, feature) => {
+        acc.total += 1;
+        acc[feature.status] = (acc[feature.status] ?? 0) + 1;
+        return acc;
+    }, { total: 0 });
+    return [
+        `${snapshot.title ?? snapshot.missionId} (${snapshot.state})`,
+        `features: ${counts.total} total, ${counts.pending ?? 0} pending, ${counts["in-progress"] ?? 0} running, ${counts.passed ?? 0} passed, ${counts.failed ?? 0} failed`,
+        `workers: ${snapshot.workerSessionIds.length}`,
+    ].join("\n");
+}
+function validateFeaturesJson(value, expectedMissionId) {
+    if (!value || typeof value !== "object") {
+        throw new Error("features.json must be a JSON object");
+    }
+    const record = value;
+    if (typeof record.version !== "number") {
+        throw new Error("features.json requires numeric version");
+    }
+    if (typeof record.missionId !== "string" || !record.missionId.trim()) {
+        throw new Error("features.json requires missionId");
+    }
+    if (sanitizeMissionId(record.missionId) !== expectedMissionId) {
+        throw new Error(`features.json missionId ${record.missionId} does not match mission directory ${expectedMissionId}`);
+    }
+    if (typeof record.updatedAt !== "string" ||
+        Number.isNaN(Date.parse(record.updatedAt))) {
+        throw new Error("features.json requires valid updatedAt");
+    }
+    if (!Array.isArray(record.features)) {
+        throw new Error("features.json requires features array");
+    }
+    const featureIds = new Set();
+    for (const [index, feature] of record.features.entries()) {
+        if (!feature || typeof feature !== "object") {
+            throw new Error(`feature ${index} must be an object`);
+        }
+        if (!isMissionFeature(feature)) {
+            throw new Error(`feature ${index} must match MissionFeature schema`);
+        }
+        const featureId = feature.id;
+        if (featureIds.has(featureId)) {
+            throw new Error(`features.json contains duplicate feature id ${featureId}`);
+        }
+        featureIds.add(featureId);
+    }
+}
+function validateMissionStateJson(value, expectedMissionId) {
+    if (!value || typeof value !== "object") {
+        throw new Error("state.json must be a JSON object");
+    }
+    const record = value;
+    if (record.schemaVersion !== MISSION_STORE_SCHEMA) {
+        throw new Error("state.json requires mission store schemaVersion");
+    }
+    if (typeof record.missionId !== "string" || !record.missionId.trim()) {
+        throw new Error("state.json requires missionId");
+    }
+    if (sanitizeMissionId(record.missionId) !== expectedMissionId) {
+        throw new Error(`state.json missionId ${record.missionId} does not match mission directory ${expectedMissionId}`);
+    }
+    if (!isMissionState(record.state)) {
+        throw new Error("state.json requires valid state");
+    }
+    if (!Array.isArray(record.features) ||
+        !record.features.every(isMissionFeature)) {
+        throw new Error("state.json requires valid features array");
+    }
+    const featureIds = new Set();
+    for (const feature of record.features) {
+        const featureId = feature.id;
+        if (featureIds.has(featureId)) {
+            throw new Error(`state.json contains duplicate feature id ${featureId}`);
+        }
+        featureIds.add(featureId);
+    }
+    if (!Array.isArray(record.progressLog)) {
+        throw new Error("state.json requires progressLog array");
+    }
+    for (const [index, entry] of record.progressLog.entries()) {
+        if (!isMissionProgressEntry(entry)) {
+            throw new Error(`state.json progressLog ${index} must be valid`);
+        }
+    }
+    if (!Array.isArray(record.workerSessionIds)) {
+        throw new Error("state.json requires workerSessionIds array");
+    }
+    if (!isRecord(record.workerStates)) {
+        throw new Error("state.json requires workerStates object");
+    }
+    if (!isRecord(record.tokenUsageBySessionId)) {
+        throw new Error("state.json requires tokenUsageBySessionId object");
+    }
+    for (const [sessionId, usage] of Object.entries(record.tokenUsageBySessionId)) {
+        if (!isMissionTokenUsage(usage)) {
+            throw new Error(`state.json tokenUsageBySessionId ${sessionId} must be valid`);
+        }
+    }
+    if (record.tokenUsage !== undefined &&
+        !isMissionTokenUsage(record.tokenUsage)) {
+        throw new Error("state.json tokenUsage must be valid");
+    }
+    if (typeof record.createdAt !== "string" ||
+        Number.isNaN(Date.parse(record.createdAt)) ||
+        typeof record.updatedAt !== "string" ||
+        Number.isNaN(Date.parse(record.updatedAt))) {
+        throw new Error("state.json requires valid timestamps");
+    }
+}
+function isMissionState(value) {
+    return (value === "awaiting-input" ||
+        value === "ready" ||
+        value === "running" ||
+        value === "blocked" ||
+        value === "completed" ||
+        value === "failed");
+}
+function isMissionProgressEntry(value) {
+    if (!isRecord(value))
+        return false;
+    if (value.type !== "mission_created" &&
+        value.type !== "mission_started" &&
+        value.type !== "mission_blocked" &&
+        value.type !== "mission_completed" &&
+        value.type !== "worker_started" &&
+        value.type !== "worker_completed" &&
+        value.type !== "worker_failed" &&
+        value.type !== "note") {
+        return false;
+    }
+    if (typeof value.timestamp !== "string" ||
+        Number.isNaN(Date.parse(value.timestamp))) {
+        return false;
+    }
+    if (value.message !== undefined && typeof value.message !== "string") {
+        return false;
+    }
+    if (value.featureId !== undefined && typeof value.featureId !== "string") {
+        return false;
+    }
+    if (value.workerSessionId !== undefined &&
+        typeof value.workerSessionId !== "string") {
+        return false;
+    }
+    if (value.exitCode !== undefined && typeof value.exitCode !== "number") {
+        return false;
+    }
+    return true;
+}
+function isMissionTokenUsage(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.inputTokens !== "number" ||
+        typeof value.outputTokens !== "number") {
+        return false;
+    }
+    if (value.cacheCreationTokens !== undefined &&
+        typeof value.cacheCreationTokens !== "number") {
+        return false;
+    }
+    if (value.cacheReadTokens !== undefined &&
+        typeof value.cacheReadTokens !== "number") {
+        return false;
+    }
+    if (value.thinkingTokens !== undefined &&
+        typeof value.thinkingTokens !== "number") {
+        return false;
+    }
+    if (value.credits !== undefined && typeof value.credits !== "number") {
+        return false;
+    }
+    return true;
+}
+function resolveMissionArtifactPath(filePath, rootDir) {
+    const absolutePath = normalize(resolve(filePath));
+    const missionStoreRoot = normalize(resolve(getMissionStoreRoot(rootDir)));
+    const realMissionStoreRoot = resolveRealPathThroughExistingParents(missionStoreRoot) ?? missionStoreRoot;
+    const realArtifactPath = resolveRealPathThroughExistingParents(absolutePath) ?? absolutePath;
+    const isLexicallyWithinMissionStore = isPathInside(missionStoreRoot, absolutePath);
+    const isReallyWithinMissionStore = isPathInside(realMissionStoreRoot, realArtifactPath);
+    const isWithinMissionStore = isLexicallyWithinMissionStore || isReallyWithinMissionStore;
+    return {
+        absolutePath,
+        missionStoreRoot,
+        realMissionStoreRoot,
+        realArtifactPath,
+        isWithinMissionStore,
+        escapesMissionStore: isLexicallyWithinMissionStore && !isReallyWithinMissionStore,
+    };
+}
+function resolveRealPathThroughExistingParents(absolutePath) {
+    const suffix = [];
+    let current = absolutePath;
+    while (true) {
+        if (existsSync(current)) {
+            try {
+                const realCurrent = realpathSync(current);
+                return suffix.length === 0
+                    ? realCurrent
+                    : join(realCurrent, ...suffix.reverse());
+            }
+            catch {
+                return null;
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        suffix.push(basename(current));
+        current = parent;
+    }
+}
+function isPathInside(root, target) {
+    return target === root || target.startsWith(`${root}${sep}`);
+}
+//# sourceMappingURL=mission-artifacts.js.map

package/dist/agent/mission-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-artifacts.js","sourceRoot":"","sources":["../../src/agent/mission-artifacts.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, realpathSync } from \"node:fs\";\nimport { basename, dirname, join, normalize, resolve, sep } from \"node:path\";\nimport YAML from \"yaml\";\nimport { writeJsonFile, writeTextFileAtomic } from \"../utils/fs.js\";\nimport { isRecord } from \"../utils/json.js\";\nimport { isMissionFeature } from \"./mission-manifest.js\";\nimport {\n\tMISSION_STORE_SCHEMA,\n\ttype MissionStoreSnapshot,\n\tgetMissionDir,\n\tgetMissionStoreRoot,\n\tsanitizeMissionId,\n} from \"./mission-store.js\";\n\nexport const MISSION_ARTIFACT_VERSION = 1;\n\nexport type MissionSessionRole = \"orchestrator\" | \"worker\" | \"validator\";\n\nexport interface MissionArtifactLayout {\n\tmissionDir: string;\n\tmissionMarkdown: string;\n\tarchitectureMarkdown: string;\n\tvalidationContractMarkdown: string;\n\tvalidationStateJson: string;\n\tfeaturesJson: string;\n\tagentsMarkdown: string;\n\tservicesYaml: string;\n\thandoffsDir: string;\n\tlibraryDir: string;\n\tskillsDir: string;\n\tstateJson: string;\n\tprogressLogJsonl: string;\n\tmodelSettingsJson: string;\n}\n\nexport type MissionArtifactKind =\n\t| \"mission\"\n\t| \"architecture\"\n\t| \"validation-contract\"\n\t| \"validation-state\"\n\t| \"features\"\n\t| \"agents\"\n\t| \"services\"\n\t| \"state\"\n\t| \"progress-log\"\n\t| \"model-settings\"\n\t| \"handoff\"\n\t| \"library\"\n\t| \"skill\";\n\nexport interface MissionArtifactClassification {\n\tkind: MissionArtifactKind;\n\tpath: string;\n\tmissionDir: string;\n}\n\nconst MISSION_ARTIFACT_ESCAPE_MESSAGE =\n\t\"Mission artifact path resolves outside the mission store.\";\n\nexport function getMissionArtifactLayout(\n\tmissionId: string,\n\trootDir?: string,\n): MissionArtifactLayout {\n\tconst missionDir = getMissionDir(missionId, rootDir);\n\treturn {\n\t\tmissionDir,\n\t\tmissionMarkdown: join(missionDir, \"mission.md\"),\n\t\tarchitectureMarkdown: join(missionDir, \"architecture.md\"),\n\t\tvalidationContractMarkdown: join(missionDir, \"validation-contract.md\"),\n\t\tvalidationStateJson: join(missionDir, \"validation-state.json\"),\n\t\tfeaturesJson: join(missionDir, \"features.json\"),\n\t\tagentsMarkdown: join(missionDir, \"AGENTS.md\"),\n\t\tservicesYaml: join(missionDir, \"services.yaml\"),\n\t\thandoffsDir: join(missionDir, \"handoffs\"),\n\t\tlibraryDir: join(missionDir, \"library\"),\n\t\tskillsDir: join(missionDir, \"skills\"),\n\t\tstateJson: join(missionDir, \"state.json\"),\n\t\tprogressLogJsonl: join(missionDir, \"progress_log.jsonl\"),\n\t\tmodelSettingsJson: join(missionDir, \"model-settings.json\"),\n\t};\n}\n\nexport function initializeMissionArtifacts(options: {\n\tmissionId: string;\n\ttitle?: string;\n\trootDir?: string;\n\tnow?: string;\n}): MissionArtifactLayout {\n\tconst now = options.now ?? new Date().toISOString();\n\tconst missionId = sanitizeMissionId(options.missionId);\n\tconst layout = getMissionArtifactLayout(missionId, options.rootDir);\n\tmkdirSync(layout.handoffsDir, { recursive: true });\n\tmkdirSync(layout.libraryDir, { recursive: true });\n\tmkdirSync(layout.skillsDir, { recursive: true });\n\tif (!existsSync(layout.missionMarkdown)) {\n\t\twriteTextFileAtomic(\n\t\t\tlayout.missionMarkdown,\n\t\t\t`# ${options.title ?? missionId}\\n\\nCreated: ${now}\\n\\n## Objective\\n\\nTBD\\n`,\n\t\t);\n\t}\n\tif (!existsSync(layout.architectureMarkdown)) {\n\t\twriteTextFileAtomic(\n\t\t\tlayout.architectureMarkdown,\n\t\t\t\"# Architecture\\n\\nDocument system boundaries, responsibilities, and invariants here.\\n\",\n\t\t);\n\t}\n\tif (!existsSync(layout.validationContractMarkdown)) {\n\t\twriteTextFileAtomic(\n\t\t\tlayout.validationContractMarkdown,\n\t\t\t\"# Validation Contract\\n\\nAdd durable behavioral assertions before decomposing features.\\n\",\n\t\t);\n\t}\n\tif (!existsSync(layout.validationStateJson)) {\n\t\twriteJsonFile(layout.validationStateJson, {\n\t\t\tversion: MISSION_ARTIFACT_VERSION,\n\t\t\tassertions: {},\n\t\t\tupdatedAt: now,\n\t\t});\n\t}\n\tif (!existsSync(layout.featuresJson)) {\n\t\twriteJsonFile(layout.featuresJson, {\n\t\t\tversion: MISSION_ARTIFACT_VERSION,\n\t\t\tmissionId,\n\t\t\tmilestones: [],\n\t\t\tfeatures: [],\n\t\t\tcreatedAt: now,\n\t\t\tupdatedAt: now,\n\t\t});\n\t}\n\tif (!existsSync(layout.agentsMarkdown)) {\n\t\twriteTextFileAtomic(\n\t\t\tlayout.agentsMarkdown,\n\t\t\t\"# Mission Agent Guidance\\n\\nKeep worker guidance, known constraints, and validation notes here.\\n\",\n\t\t);\n\t}\n\tif (!existsSync(layout.servicesYaml)) {\n\t\twriteTextFileAtomic(\n\t\t\tlayout.servicesYaml,\n\t\t\t\"version: 1\\ncommands: {}\\nservices: {}\\n\",\n\t\t);\n\t}\n\treturn layout;\n}\n\nexport function classifyMissionArtifactPath(\n\tfilePath: string,\n\trootDir?: string,\n): MissionArtifactClassification | null {\n\tconst resolved = resolveMissionArtifactPath(filePath, rootDir);\n\tif (!resolved.isWithinMissionStore || resolved.escapesMissionStore) {\n\t\treturn null;\n\t}\n\tconst afterRoot = resolved.realArtifactPath.slice(\n\t\tresolved.realMissionStoreRoot.length + 1,\n\t);\n\tconst missionId = afterRoot.split(sep)[0];\n\tif (!missionId) return null;\n\tconst missionDir = join(resolved.realMissionStoreRoot, missionId);\n\tconst rel = resolved.realArtifactPath.slice(missionDir.length + 1);\n\tconst file = basename(resolved.realArtifactPath);\n\tconst nestedKind = rel.startsWith(`handoffs${sep}`)\n\t\t? \"handoff\"\n\t\t: rel.startsWith(`library${sep}`)\n\t\t\t? \"library\"\n\t\t\t: rel.startsWith(`skills${sep}`)\n\t\t\t\t? \"skill\"\n\t\t\t\t: null;\n\tif (nestedKind) {\n\t\treturn { kind: nestedKind, path: resolved.absolutePath, missionDir };\n\t}\n\tconst kind =\n\t\tfile === \"mission.md\"\n\t\t\t? \"mission\"\n\t\t\t: file === \"architecture.md\"\n\t\t\t\t? \"architecture\"\n\t\t\t\t: file === \"validation-contract.md\"\n\t\t\t\t\t? \"validation-contract\"\n\t\t\t\t\t: file === \"validation-state.json\"\n\t\t\t\t\t\t? \"validation-state\"\n\t\t\t\t\t\t: file === \"features.json\"\n\t\t\t\t\t\t\t? \"features\"\n\t\t\t\t\t\t\t: file === \"AGENTS.md\"\n\t\t\t\t\t\t\t\t? \"agents\"\n\t\t\t\t\t\t\t\t: file === \"services.yaml\" || file === \"services.yml\"\n\t\t\t\t\t\t\t\t\t? \"services\"\n\t\t\t\t\t\t\t\t\t: file === \"state.json\"\n\t\t\t\t\t\t\t\t\t\t? \"state\"\n\t\t\t\t\t\t\t\t\t\t: file === \"progress_log.jsonl\"\n\t\t\t\t\t\t\t\t\t\t\t? \"progress-log\"\n\t\t\t\t\t\t\t\t\t\t\t: file === \"model-settings.json\"\n\t\t\t\t\t\t\t\t\t\t\t\t? \"model-settings\"\n\t\t\t\t\t\t\t\t\t\t\t\t: null;\n\treturn kind ? { kind, path: resolved.absolutePath, missionDir } : null;\n}\n\nexport function validateMissionArtifactContent(\n\tfilePath: string,\n\tcontent: string,\n\trootDir?: string,\n): { ok: true } | { ok: false; message: string } {\n\tconst resolved = resolveMissionArtifactPath(filePath, rootDir);\n\tif (resolved.escapesMissionStore) {\n\t\treturn { ok: false, message: MISSION_ARTIFACT_ESCAPE_MESSAGE };\n\t}\n\tconst classified = classifyMissionArtifactPath(filePath, rootDir);\n\tif (!classified) return { ok: true };\n\ttry {\n\t\tswitch (classified.kind) {\n\t\t\tcase \"features\":\n\t\t\t\tvalidateFeaturesJson(\n\t\t\t\t\tJSON.parse(content),\n\t\t\t\t\tbasename(classified.missionDir),\n\t\t\t\t);\n\t\t\t\treturn { ok: true };\n\t\t\tcase \"validation-state\":\n\t\t\tcase \"model-settings\":\n\t\t\tcase \"handoff\":\n\t\t\t\tJSON.parse(content);\n\t\t\t\treturn { ok: true };\n\t\t\tcase \"state\":\n\t\t\t\tvalidateMissionStateJson(\n\t\t\t\t\tJSON.parse(content),\n\t\t\t\t\tbasename(classified.missionDir),\n\t\t\t\t);\n\t\t\t\treturn { ok: true };\n\t\t\tcase \"progress-log\":\n\t\t\t\tfor (const [index, line] of content.split(/\\r?\\n/u).entries()) {\n\t\t\t\t\tif (!line.trim()) continue;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tJSON.parse(line);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tok: false,\n\t\t\t\t\t\t\tmessage: `Invalid JSONL at line ${index + 1}`,\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { ok: true };\n\t\t\tcase \"services\":\n\t\t\t\tYAML.parse(content);\n\t\t\t\treturn { ok: true };\n\t\t\tdefault:\n\t\t\t\treturn { ok: true };\n\t\t}\n\t} catch (error) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tmessage:\n\t\t\t\terror instanceof Error\n\t\t\t\t\t? error.message\n\t\t\t\t\t: `Invalid mission artifact ${classified.kind}`,\n\t\t};\n\t}\n}\n\nexport function validateMissionArtifactWrite(options: {\n\tfilePath: string;\n\tcontent: string;\n\trole?: MissionSessionRole;\n\trootDir?: string;\n}): { ok: true } | { ok: false; message: string } {\n\tconst resolved = resolveMissionArtifactPath(\n\t\toptions.filePath,\n\t\toptions.rootDir,\n\t);\n\tif (resolved.escapesMissionStore) {\n\t\treturn { ok: false, message: MISSION_ARTIFACT_ESCAPE_MESSAGE };\n\t}\n\tconst classified = classifyMissionArtifactPath(\n\t\toptions.filePath,\n\t\toptions.rootDir,\n\t);\n\tif (!classified) return { ok: true };\n\tif (\n\t\tclassified.kind === \"state\" ||\n\t\tclassified.kind === \"progress-log\" ||\n\t\tclassified.kind === \"model-settings\"\n\t) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tmessage:\n\t\t\t\t\"Cannot write mission system files directly; use MissionStore APIs.\",\n\t\t};\n\t}\n\tif (\n\t\t(options.role === \"worker\" || options.role === \"validator\") &&\n\t\tclassified.kind === \"features\"\n\t) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tmessage:\n\t\t\t\t\"Mission workers and validators cannot write features.json; return a handoff to the orchestrator.\",\n\t\t};\n\t}\n\treturn validateMissionArtifactContent(\n\t\toptions.filePath,\n\t\toptions.content,\n\t\toptions.rootDir,\n\t);\n}\n\nexport function validateMissionArtifactDelete(options: {\n\tfilePath: string;\n\trootDir?: string;\n}): { ok: true } | { ok: false; message: string } {\n\tconst resolved = resolveMissionArtifactPath(\n\t\toptions.filePath,\n\t\toptions.rootDir,\n\t);\n\tif (resolved.escapesMissionStore) {\n\t\treturn { ok: false, message: MISSION_ARTIFACT_ESCAPE_MESSAGE };\n\t}\n\tconst classified = classifyMissionArtifactPath(\n\t\toptions.filePath,\n\t\toptions.rootDir,\n\t);\n\tif (!classified) return { ok: true };\n\tif (\n\t\tclassified.kind === \"handoff\" ||\n\t\tclassified.kind === \"library\" ||\n\t\tclassified.kind === \"skill\"\n\t) {\n\t\treturn { ok: true };\n\t}\n\treturn {\n\t\tok: false,\n\t\tmessage: `Cannot delete required mission artifact ${basename(classified.path)}.`,\n\t};\n}\n\nexport function detectMissionSessionRole(\n\tenv: NodeJS.ProcessEnv = process.env,\n): MissionSessionRole | undefined {\n\tconst raw = env.MAESTRO_MISSION_ROLE?.trim().toLowerCase();\n\tif (raw === \"orchestrator\" || raw === \"worker\" || raw === \"validator\") {\n\t\treturn raw;\n\t}\n\tif (env.MAESTRO_MISSION_WORKER === \"1\") return \"worker\";\n\tif (env.MAESTRO_MISSION_VALIDATOR === \"1\") return \"validator\";\n\treturn undefined;\n}\n\nexport function summarizeMissionSnapshot(\n\tsnapshot: MissionStoreSnapshot,\n): string {\n\tconst counts = snapshot.features.reduce(\n\t\t(acc, feature) => {\n\t\t\tacc.total += 1;\n\t\t\tacc[feature.status] = (acc[feature.status] ?? 0) + 1;\n\t\t\treturn acc;\n\t\t},\n\t\t{ total: 0 } as { total: number } & Record<string, number>,\n\t);\n\treturn [\n\t\t`${snapshot.title ?? snapshot.missionId} (${snapshot.state})`,\n\t\t`features: ${counts.total} total, ${counts.pending ?? 0} pending, ${counts[\"in-progress\"] ?? 0} running, ${counts.passed ?? 0} passed, ${counts.failed ?? 0} failed`,\n\t\t`workers: ${snapshot.workerSessionIds.length}`,\n\t].join(\"\\n\");\n}\n\nfunction validateFeaturesJson(value: unknown, expectedMissionId: string): void {\n\tif (!value || typeof value !== \"object\") {\n\t\tthrow new Error(\"features.json must be a JSON object\");\n\t}\n\tconst record = value as Record<string, unknown>;\n\tif (typeof record.version !== \"number\") {\n\t\tthrow new Error(\"features.json requires numeric version\");\n\t}\n\tif (typeof record.missionId !== \"string\" || !record.missionId.trim()) {\n\t\tthrow new Error(\"features.json requires missionId\");\n\t}\n\tif (sanitizeMissionId(record.missionId) !== expectedMissionId) {\n\t\tthrow new Error(\n\t\t\t`features.json missionId ${record.missionId} does not match mission directory ${expectedMissionId}`,\n\t\t);\n\t}\n\tif (\n\t\ttypeof record.updatedAt !== \"string\" ||\n\t\tNumber.isNaN(Date.parse(record.updatedAt))\n\t) {\n\t\tthrow new Error(\"features.json requires valid updatedAt\");\n\t}\n\tif (!Array.isArray(record.features)) {\n\t\tthrow new Error(\"features.json requires features array\");\n\t}\n\tconst featureIds = new Set<string>();\n\tfor (const [index, feature] of record.features.entries()) {\n\t\tif (!feature || typeof feature !== \"object\") {\n\t\t\tthrow new Error(`feature ${index} must be an object`);\n\t\t}\n\t\tif (!isMissionFeature(feature)) {\n\t\t\tthrow new Error(`feature ${index} must match MissionFeature schema`);\n\t\t}\n\t\tconst featureId = (feature as { id: string }).id;\n\t\tif (featureIds.has(featureId)) {\n\t\t\tthrow new Error(\n\t\t\t\t`features.json contains duplicate feature id ${featureId}`,\n\t\t\t);\n\t\t}\n\t\tfeatureIds.add(featureId);\n\t}\n}\n\nfunction validateMissionStateJson(\n\tvalue: unknown,\n\texpectedMissionId: string,\n): void {\n\tif (!value || typeof value !== \"object\") {\n\t\tthrow new Error(\"state.json must be a JSON object\");\n\t}\n\tconst record = value as Record<string, unknown>;\n\tif (record.schemaVersion !== MISSION_STORE_SCHEMA) {\n\t\tthrow new Error(\"state.json requires mission store schemaVersion\");\n\t}\n\tif (typeof record.missionId !== \"string\" || !record.missionId.trim()) {\n\t\tthrow new Error(\"state.json requires missionId\");\n\t}\n\tif (sanitizeMissionId(record.missionId) !== expectedMissionId) {\n\t\tthrow new Error(\n\t\t\t`state.json missionId ${record.missionId} does not match mission directory ${expectedMissionId}`,\n\t\t);\n\t}\n\tif (!isMissionState(record.state)) {\n\t\tthrow new Error(\"state.json requires valid state\");\n\t}\n\tif (\n\t\t!Array.isArray(record.features) ||\n\t\t!record.features.every(isMissionFeature)\n\t) {\n\t\tthrow new Error(\"state.json requires valid features array\");\n\t}\n\tconst featureIds = new Set<string>();\n\tfor (const feature of record.features) {\n\t\tconst featureId = (feature as { id: string }).id;\n\t\tif (featureIds.has(featureId)) {\n\t\t\tthrow new Error(`state.json contains duplicate feature id ${featureId}`);\n\t\t}\n\t\tfeatureIds.add(featureId);\n\t}\n\tif (!Array.isArray(record.progressLog)) {\n\t\tthrow new Error(\"state.json requires progressLog array\");\n\t}\n\tfor (const [index, entry] of record.progressLog.entries()) {\n\t\tif (!isMissionProgressEntry(entry)) {\n\t\t\tthrow new Error(`state.json progressLog ${index} must be valid`);\n\t\t}\n\t}\n\tif (!Array.isArray(record.workerSessionIds)) {\n\t\tthrow new Error(\"state.json requires workerSessionIds array\");\n\t}\n\tif (!isRecord(record.workerStates)) {\n\t\tthrow new Error(\"state.json requires workerStates object\");\n\t}\n\tif (!isRecord(record.tokenUsageBySessionId)) {\n\t\tthrow new Error(\"state.json requires tokenUsageBySessionId object\");\n\t}\n\tfor (const [sessionId, usage] of Object.entries(\n\t\trecord.tokenUsageBySessionId,\n\t)) {\n\t\tif (!isMissionTokenUsage(usage)) {\n\t\t\tthrow new Error(\n\t\t\t\t`state.json tokenUsageBySessionId ${sessionId} must be valid`,\n\t\t\t);\n\t\t}\n\t}\n\tif (\n\t\trecord.tokenUsage !== undefined &&\n\t\t!isMissionTokenUsage(record.tokenUsage)\n\t) {\n\t\tthrow new Error(\"state.json tokenUsage must be valid\");\n\t}\n\tif (\n\t\ttypeof record.createdAt !== \"string\" ||\n\t\tNumber.isNaN(Date.parse(record.createdAt)) ||\n\t\ttypeof record.updatedAt !== \"string\" ||\n\t\tNumber.isNaN(Date.parse(record.updatedAt))\n\t) {\n\t\tthrow new Error(\"state.json requires valid timestamps\");\n\t}\n}\n\nfunction isMissionState(value: unknown): boolean {\n\treturn (\n\t\tvalue === \"awaiting-input\" ||\n\t\tvalue === \"ready\" ||\n\t\tvalue === \"running\" ||\n\t\tvalue === \"blocked\" ||\n\t\tvalue === \"completed\" ||\n\t\tvalue === \"failed\"\n\t);\n}\n\nfunction isMissionProgressEntry(value: unknown): boolean {\n\tif (!isRecord(value)) return false;\n\tif (\n\t\tvalue.type !== \"mission_created\" &&\n\t\tvalue.type !== \"mission_started\" &&\n\t\tvalue.type !== \"mission_blocked\" &&\n\t\tvalue.type !== \"mission_completed\" &&\n\t\tvalue.type !== \"worker_started\" &&\n\t\tvalue.type !== \"worker_completed\" &&\n\t\tvalue.type !== \"worker_failed\" &&\n\t\tvalue.type !== \"note\"\n\t) {\n\t\treturn false;\n\t}\n\tif (\n\t\ttypeof value.timestamp !== \"string\" ||\n\t\tNumber.isNaN(Date.parse(value.timestamp))\n\t) {\n\t\treturn false;\n\t}\n\tif (value.message !== undefined && typeof value.message !== \"string\") {\n\t\treturn false;\n\t}\n\tif (value.featureId !== undefined && typeof value.featureId !== \"string\") {\n\t\treturn false;\n\t}\n\tif (\n\t\tvalue.workerSessionId !== undefined &&\n\t\ttypeof value.workerSessionId !== \"string\"\n\t) {\n\t\treturn false;\n\t}\n\tif (value.exitCode !== undefined && typeof value.exitCode !== \"number\") {\n\t\treturn false;\n\t}\n\treturn true;\n}\n\nfunction isMissionTokenUsage(value: unknown): boolean {\n\tif (!isRecord(value)) return false;\n\tif (\n\t\ttypeof value.inputTokens !== \"number\" ||\n\t\ttypeof value.outputTokens !== \"number\"\n\t) {\n\t\treturn false;\n\t}\n\tif (\n\t\tvalue.cacheCreationTokens !== undefined &&\n\t\ttypeof value.cacheCreationTokens !== \"number\"\n\t) {\n\t\treturn false;\n\t}\n\tif (\n\t\tvalue.cacheReadTokens !== undefined &&\n\t\ttypeof value.cacheReadTokens !== \"number\"\n\t) {\n\t\treturn false;\n\t}\n\tif (\n\t\tvalue.thinkingTokens !== undefined &&\n\t\ttypeof value.thinkingTokens !== \"number\"\n\t) {\n\t\treturn false;\n\t}\n\tif (value.credits !== undefined && typeof value.credits !== \"number\") {\n\t\treturn false;\n\t}\n\treturn true;\n}\n\nfunction resolveMissionArtifactPath(\n\tfilePath: string,\n\trootDir?: string,\n): {\n\tabsolutePath: string;\n\tmissionStoreRoot: string;\n\trealMissionStoreRoot: string;\n\trealArtifactPath: string;\n\tisWithinMissionStore: boolean;\n\tescapesMissionStore: boolean;\n} {\n\tconst absolutePath = normalize(resolve(filePath));\n\tconst missionStoreRoot = normalize(resolve(getMissionStoreRoot(rootDir)));\n\tconst realMissionStoreRoot =\n\t\tresolveRealPathThroughExistingParents(missionStoreRoot) ?? missionStoreRoot;\n\tconst realArtifactPath =\n\t\tresolveRealPathThroughExistingParents(absolutePath) ?? absolutePath;\n\tconst isLexicallyWithinMissionStore = isPathInside(\n\t\tmissionStoreRoot,\n\t\tabsolutePath,\n\t);\n\tconst isReallyWithinMissionStore = isPathInside(\n\t\trealMissionStoreRoot,\n\t\trealArtifactPath,\n\t);\n\tconst isWithinMissionStore =\n\t\tisLexicallyWithinMissionStore || isReallyWithinMissionStore;\n\treturn {\n\t\tabsolutePath,\n\t\tmissionStoreRoot,\n\t\trealMissionStoreRoot,\n\t\trealArtifactPath,\n\t\tisWithinMissionStore,\n\t\tescapesMissionStore:\n\t\t\tisLexicallyWithinMissionStore && !isReallyWithinMissionStore,\n\t};\n}\n\nfunction resolveRealPathThroughExistingParents(\n\tabsolutePath: string,\n): string | null {\n\tconst suffix: string[] = [];\n\tlet current = absolutePath;\n\twhile (true) {\n\t\tif (existsSync(current)) {\n\t\t\ttry {\n\t\t\t\tconst realCurrent = realpathSync(current);\n\t\t\t\treturn suffix.length === 0\n\t\t\t\t\t? realCurrent\n\t\t\t\t\t: join(realCurrent, ...suffix.reverse());\n\t\t\t} catch {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) {\n\t\t\treturn null;\n\t\t}\n\t\tsuffix.push(basename(current));\n\t\tcurrent = parent;\n\t}\n}\n\nfunction isPathInside(root: string, target: string): boolean {\n\treturn target === root || target.startsWith(`${root}${sep}`);\n}\n"]}