@evalops/maestro 0.10.50 → 0.10.53

package/dist/agent/routing-receipt.js

@@ -0,0 +1,55 @@
+export function resolveAgentProfileSelection(input) {
+    if (input.requestedProfile?.trim()) {
+        return {
+            requestedProfile: input.requestedProfile.trim(),
+            source: "request",
+        };
+    }
+    if (input.sessionPin?.profile.trim()) {
+        return {
+            requestedProfile: input.sessionPin.profile.trim(),
+            source: "session",
+        };
+    }
+    if (!input.compatibilityProfile.trim()) {
+        throw new Error("A compatibility profile is required");
+    }
+    return {
+        requestedProfile: input.compatibilityProfile.trim(),
+        source: "compatibility_default",
+    };
+}
+/** Project a routing decision into immutable historical turn metadata. */
+export function createRoutingReceipt(decision, context) {
+    const oracle = decision.oracleConsultation
+        ? Object.freeze({
+            policyVersion: decision.oracleConsultation.policyVersion,
+            mode: decision.oracleConsultation.mode,
+            reasons: Object.freeze([...decision.oracleConsultation.reasons]),
+        })
+        : undefined;
+    const fallback = context.fallbackReason
+        ? Object.freeze({
+            reason: context.fallbackReason,
+            ...(context.fallbackModel ?? {}),
+        })
+        : undefined;
+    const experiment = context.experiment
+        ? Object.freeze({ ...context.experiment })
+        : undefined;
+    return Object.freeze({
+        decisionId: decision.decisionId,
+        requestedProfile: context.requestedProfile,
+        source: context.source,
+        resolvedProfileId: decision.selectedProfile.id,
+        resolvedProfileVersion: decision.selectedProfile.version,
+        provider: decision.selectedModel.provider,
+        model: decision.selectedModel.model,
+        reasoningEffort: decision.selectedProfile.primary.reasoningEffort,
+        createdAt: decision.createdAt,
+        ...(oracle ? { oracle } : {}),
+        ...(fallback ? { fallback } : {}),
+        ...(experiment ? { experiment } : {}),
+    });
+}
+//# sourceMappingURL=routing-receipt.js.map

package/dist/agent/routing-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-receipt.js","sourceRoot":"","sources":["../../src/agent/routing-receipt.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,4BAA4B,CAC3C,KAAiC;IAEjC,IAAI,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO;YACN,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE;YAC/C,MAAM,EAAE,SAAS;SACjB,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO;YACN,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE;YACjD,MAAM,EAAE,SAAS;SACjB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO;QACN,gBAAgB,EAAE,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE;QACnD,MAAM,EAAE,uBAAuB;KAC/B,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CACnC,QAAgC,EAChC,OAA8B;IAE9B,MAAM,MAAM,GAAG,QAAQ,CAAC,kBAAkB;QACzC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACd,aAAa,EAAE,QAAQ,CAAC,kBAAkB,CAAC,aAAa;YACxD,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,IAAI;YACtC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;SAChE,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc;QACtC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,OAAO,CAAC,cAAc;YAC9B,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;SAChC,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU;QACpC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEb,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,iBAAiB,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE;QAC9C,sBAAsB,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO;QACxD,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,QAAQ;QACzC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK;QACnC,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,eAAe;QACjE,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type {\n\tAgentProfilePin,\n\tRoutingReceipt,\n\tRoutingReceiptExperiment,\n\tRoutingReceiptSource,\n} from \"@evalops/contracts\";\nimport type { OracleConsultationDecision } from \"./oracle-consultation-policy.js\";\nimport type { AgentProfile } from \"./profiles.js\";\n\nexport interface AgentProfileSelectionInput {\n\trequestedProfile?: string;\n\tsessionPin?: AgentProfilePin;\n\tcompatibilityProfile: string;\n}\n\nexport interface AgentProfileSelection {\n\trequestedProfile: string;\n\tsource: RoutingReceiptSource;\n}\n\nexport interface RoutingReceiptDecision {\n\tdecisionId: string;\n\tselectedModel: { provider: string; model: string };\n\tselectedProfile: AgentProfile;\n\tcreatedAt: string;\n\toracleConsultation?: OracleConsultationDecision;\n}\n\nexport interface RoutingReceiptContext extends AgentProfileSelection {\n\tfallbackReason?: string;\n\tfallbackModel?: { provider: string; model: string };\n\texperiment?: RoutingReceiptExperiment;\n}\n\nexport function resolveAgentProfileSelection(\n\tinput: AgentProfileSelectionInput,\n): AgentProfileSelection {\n\tif (input.requestedProfile?.trim()) {\n\t\treturn {\n\t\t\trequestedProfile: input.requestedProfile.trim(),\n\t\t\tsource: \"request\",\n\t\t};\n\t}\n\tif (input.sessionPin?.profile.trim()) {\n\t\treturn {\n\t\t\trequestedProfile: input.sessionPin.profile.trim(),\n\t\t\tsource: \"session\",\n\t\t};\n\t}\n\tif (!input.compatibilityProfile.trim()) {\n\t\tthrow new Error(\"A compatibility profile is required\");\n\t}\n\treturn {\n\t\trequestedProfile: input.compatibilityProfile.trim(),\n\t\tsource: \"compatibility_default\",\n\t};\n}\n\n/** Project a routing decision into immutable historical turn metadata. */\nexport function createRoutingReceipt(\n\tdecision: RoutingReceiptDecision,\n\tcontext: RoutingReceiptContext,\n): RoutingReceipt {\n\tconst oracle = decision.oracleConsultation\n\t\t? Object.freeze({\n\t\t\t\tpolicyVersion: decision.oracleConsultation.policyVersion,\n\t\t\t\tmode: decision.oracleConsultation.mode,\n\t\t\t\treasons: Object.freeze([...decision.oracleConsultation.reasons]),\n\t\t\t})\n\t\t: undefined;\n\tconst fallback = context.fallbackReason\n\t\t? Object.freeze({\n\t\t\t\treason: context.fallbackReason,\n\t\t\t\t...(context.fallbackModel ?? {}),\n\t\t\t})\n\t\t: undefined;\n\tconst experiment = context.experiment\n\t\t? Object.freeze({ ...context.experiment })\n\t\t: undefined;\n\n\treturn Object.freeze({\n\t\tdecisionId: decision.decisionId,\n\t\trequestedProfile: context.requestedProfile,\n\t\tsource: context.source,\n\t\tresolvedProfileId: decision.selectedProfile.id,\n\t\tresolvedProfileVersion: decision.selectedProfile.version,\n\t\tprovider: decision.selectedModel.provider,\n\t\tmodel: decision.selectedModel.model,\n\t\treasoningEffort: decision.selectedProfile.primary.reasoningEffort,\n\t\tcreatedAt: decision.createdAt,\n\t\t...(oracle ? { oracle } : {}),\n\t\t...(fallback ? { fallback } : {}),\n\t\t...(experiment ? { experiment } : {}),\n\t});\n}\n"]}

package/dist/agent/skill-artifact-metadata.d.ts

@@ -0,0 +1,14 @@
+export type SkillArtifactSource = "project" | "user" | "system" | "service";
+export interface SkillArtifactMetadata {
+    name: string;
+    hash: string;
+    source: SkillArtifactSource;
+    artifactId?: string;
+    version?: string;
+    sourcePath?: string;
+    scope?: string;
+    workspaceId?: string;
+    ownerId?: string;
+}
+export declare function getSkillArtifactMetadataFromDetails(details: unknown): SkillArtifactMetadata | undefined;
+//# sourceMappingURL=skill-artifact-metadata.d.ts.map

package/dist/agent/skill-artifact-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-artifact-metadata.d.ts","sourceRoot":"","sources":["../../src/agent/skill-artifact-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAkDD,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,OAAO,GACd,qBAAqB,GAAG,SAAS,CAOnC"}

package/dist/agent/skill-artifact-metadata.js

@@ -0,0 +1,49 @@
+function normalizeSkillArtifactMetadata(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const candidate = value;
+    if (typeof candidate.name !== "string" ||
+        candidate.name.trim().length === 0 ||
+        typeof candidate.hash !== "string" ||
+        candidate.hash.trim().length === 0 ||
+        typeof candidate.source !== "string" ||
+        candidate.source.trim().length === 0) {
+        return undefined;
+    }
+    return {
+        name: candidate.name.trim(),
+        hash: candidate.hash.trim(),
+        source: candidate.source.trim(),
+        ...(typeof candidate.artifactId === "string" &&
+            candidate.artifactId.trim().length > 0
+            ? { artifactId: candidate.artifactId.trim() }
+            : {}),
+        ...(typeof candidate.version === "string" &&
+            candidate.version.trim().length > 0
+            ? { version: candidate.version.trim() }
+            : {}),
+        ...(typeof candidate.sourcePath === "string" &&
+            candidate.sourcePath.trim().length > 0
+            ? { sourcePath: candidate.sourcePath.trim() }
+            : {}),
+        ...(typeof candidate.scope === "string" && candidate.scope.trim().length > 0
+            ? { scope: candidate.scope.trim() }
+            : {}),
+        ...(typeof candidate.workspaceId === "string" &&
+            candidate.workspaceId.trim().length > 0
+            ? { workspaceId: candidate.workspaceId.trim() }
+            : {}),
+        ...(typeof candidate.ownerId === "string" &&
+            candidate.ownerId.trim().length > 0
+            ? { ownerId: candidate.ownerId.trim() }
+            : {}),
+    };
+}
+export function getSkillArtifactMetadataFromDetails(details) {
+    if (!details || typeof details !== "object" || Array.isArray(details)) {
+        return undefined;
+    }
+    return normalizeSkillArtifactMetadata(details.skillMetadata);
+}
+//# sourceMappingURL=skill-artifact-metadata.js.map

package/dist/agent/skill-artifact-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-artifact-metadata.js","sourceRoot":"","sources":["../../src/agent/skill-artifact-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["export type SkillArtifactSource = \"project\" | \"user\" | \"system\" | \"service\";\n\nexport interface SkillArtifactMetadata {\n\tname: string;\n\thash: string;\n\tsource: SkillArtifactSource;\n\tartifactId?: string;\n\tversion?: string;\n\tsourcePath?: string;\n\tscope?: string;\n\tworkspaceId?: string;\n\townerId?: string;\n}\n\nfunction normalizeSkillArtifactMetadata(\n\tvalue: unknown,\n): SkillArtifactMetadata | undefined {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\treturn undefined;\n\t}\n\tconst candidate = value as Record<string, unknown>;\n\tif (\n\t\ttypeof candidate.name !== \"string\" ||\n\t\tcandidate.name.trim().length === 0 ||\n\t\ttypeof candidate.hash !== \"string\" ||\n\t\tcandidate.hash.trim().length === 0 ||\n\t\ttypeof candidate.source !== \"string\" ||\n\t\tcandidate.source.trim().length === 0\n\t) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tname: candidate.name.trim(),\n\t\thash: candidate.hash.trim(),\n\t\tsource: candidate.source.trim() as SkillArtifactSource,\n\t\t...(typeof candidate.artifactId === \"string\" &&\n\t\tcandidate.artifactId.trim().length > 0\n\t\t\t? { artifactId: candidate.artifactId.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.version === \"string\" &&\n\t\tcandidate.version.trim().length > 0\n\t\t\t? { version: candidate.version.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.sourcePath === \"string\" &&\n\t\tcandidate.sourcePath.trim().length > 0\n\t\t\t? { sourcePath: candidate.sourcePath.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.scope === \"string\" && candidate.scope.trim().length > 0\n\t\t\t? { scope: candidate.scope.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.workspaceId === \"string\" &&\n\t\tcandidate.workspaceId.trim().length > 0\n\t\t\t? { workspaceId: candidate.workspaceId.trim() }\n\t\t\t: {}),\n\t\t...(typeof candidate.ownerId === \"string\" &&\n\t\tcandidate.ownerId.trim().length > 0\n\t\t\t? { ownerId: candidate.ownerId.trim() }\n\t\t\t: {}),\n\t};\n}\n\nexport function getSkillArtifactMetadataFromDetails(\n\tdetails: unknown,\n): SkillArtifactMetadata | undefined {\n\tif (!details || typeof details !== \"object\" || Array.isArray(details)) {\n\t\treturn undefined;\n\t}\n\treturn normalizeSkillArtifactMetadata(\n\t\t(details as { skillMetadata?: unknown }).skillMetadata,\n\t);\n}\n"]}

package/dist/agent/snapshot-store.d.ts

@@ -0,0 +1,32 @@
+import type { RewindPlan } from "./snapshot-rewind-plan.js";
+export interface SnapshotBlobStoreConfig {
+    rootDir?: string;
+}
+export interface RewindExecutionResult {
+    targetIndex: number;
+    fromIndex: number;
+    restored: string[];
+    deleted: string[];
+    bytesRestored: number;
+    dryRun: boolean;
+}
+export declare function getSnapshotBlobRoot(rootDir?: string): string;
+export declare function sha256Content(content: string | Buffer): string;
+export declare class SnapshotBlobStore {
+    private readonly rootDir;
+    constructor(config?: SnapshotBlobStoreConfig);
+    put(content: string | Buffer): {
+        contentSha256: string;
+        size: number;
+    };
+    get(contentSha256: string): Buffer;
+    has(contentSha256: string): boolean;
+    getPath(contentSha256: string): string;
+}
+export declare function executeRewindPlan(options: {
+    plan: RewindPlan;
+    workspaceDir: string;
+    store?: SnapshotBlobStore;
+    dryRun?: boolean;
+}): RewindExecutionResult;
+//# sourceMappingURL=snapshot-store.d.ts.map

package/dist/agent/snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.d.ts","sourceRoot":"","sources":["../../src/agent/snapshot-store.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,2BAA2B,CAAC;AAI7E,MAAM,WAAW,uBAAuB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CAChB;AAgBD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE9D;AAED,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,GAAE,uBAA4B;IAIhD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAYtE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAQlC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAInC,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAItC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,qBAAqB,CAgDxB"}

package/dist/agent/snapshot-store.js

@@ -0,0 +1,195 @@
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, rmdirSync, } from "node:fs";
+import { basename, dirname, isAbsolute, join, relative, resolve, } from "node:path";
+import { PATHS } from "../config/constants.js";
+import { defaultRuntimeEnv } from "../runtime/env.js";
+import { writeTextFileAtomic } from "../utils/fs.js";
+const SNAPSHOT_SHA256_PATTERN = /^(?:sha256:)?[a-f0-9]{64}$/iu;
+export function getSnapshotBlobRoot(rootDir) {
+    return (rootDir ??
+        defaultRuntimeEnv().snapshotBlobDir ??
+        join(PATHS.MAESTRO_HOME, "snapshots", "blobs"));
+}
+export function sha256Content(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+export class SnapshotBlobStore {
+    constructor(config = {}) {
+        this.rootDir = getSnapshotBlobRoot(config.rootDir);
+    }
+    put(content) {
+        const buffer = Buffer.isBuffer(content)
+            ? content
+            : Buffer.from(content, "utf-8");
+        const contentSha256 = sha256Content(buffer);
+        const path = this.getPath(contentSha256);
+        if (!existsSync(path)) {
+            writeBlobFileAtomic(path, buffer);
+        }
+        return { contentSha256, size: buffer.byteLength };
+    }
+    get(contentSha256) {
+        const path = this.getPath(contentSha256);
+        if (!existsSync(path)) {
+            throw new Error(`snapshot blob not found: ${contentSha256}`);
+        }
+        return readFileSync(path);
+    }
+    has(contentSha256) {
+        return existsSync(this.getPath(contentSha256));
+    }
+    getPath(contentSha256) {
+        const clean = normalizeSnapshotContentSha256(contentSha256);
+        return join(this.rootDir, clean.slice(0, 2), clean);
+    }
+}
+export function executeRewindPlan(options) {
+    const store = options.store ?? new SnapshotBlobStore();
+    const restored = [];
+    const deleted = [];
+    let bytesRestored = 0;
+    const workspaceRoot = realpathSync(resolve(options.workspaceDir));
+    const preparedOps = options.plan.ops.map((op) => {
+        const workspacePath = resolveWorkspacePlanPath(workspaceRoot, op.path);
+        if (op.kind === "delete") {
+            return { kind: "delete", path: op.path, workspacePath };
+        }
+        return {
+            kind: "restore",
+            path: op.path,
+            workspacePath,
+            content: readRestoreBlob(op, store),
+            size: op.size,
+        };
+    });
+    const plannedDeletePaths = new Set(preparedOps.flatMap((op) => op.kind === "delete" ? [op.workspacePath] : []));
+    preflightBlockingRestoreDirectories(preparedOps, plannedDeletePaths);
+    for (const op of preparedOps) {
+        if (op.kind === "delete") {
+            if (!options.dryRun) {
+                rmSync(op.workspacePath, { force: true, recursive: false });
+            }
+            deleted.push(op.path);
+            continue;
+        }
+        if (!options.dryRun) {
+            pruneBlockingRestoreDirectory(op.workspacePath);
+            writeBlobFileAtomic(op.workspacePath, op.content);
+        }
+        restored.push(op.path);
+        bytesRestored += op.size;
+    }
+    return {
+        targetIndex: options.plan.targetIndex,
+        fromIndex: options.plan.fromIndex,
+        restored,
+        deleted,
+        bytesRestored,
+        dryRun: options.dryRun === true,
+    };
+}
+function resolveWorkspacePlanPath(workspaceRoot, opPath) {
+    if (!opPath || isAbsolute(opPath)) {
+        throw new Error(`rewind plan path must be relative: ${opPath}`);
+    }
+    if (isParentDirectoryRelPath(opPath)) {
+        throw new Error(`rewind plan path escapes workspace: ${opPath}`);
+    }
+    const resolvedPath = resolve(workspaceRoot, opPath);
+    const rel = relative(workspaceRoot, resolvedPath);
+    if (!rel || isParentDirectoryRelPath(rel) || isAbsolute(rel)) {
+        throw new Error(`rewind plan path escapes workspace: ${opPath}`);
+    }
+    const workspaceRealRoot = realpathSync(workspaceRoot);
+    const parentRealPath = resolveRealPath(dirname(resolvedPath));
+    const parentRel = relative(workspaceRealRoot, parentRealPath);
+    if ((parentRealPath !== workspaceRealRoot && !parentRel) ||
+        isParentDirectoryRelPath(parentRel) ||
+        isAbsolute(parentRel)) {
+        throw new Error(`rewind plan path escapes workspace: ${opPath}`);
+    }
+    return resolvedPath;
+}
+function isParentDirectoryRelPath(relPath) {
+    return (relPath === ".." || relPath.startsWith("../") || relPath.startsWith("..\\"));
+}
+function resolveRealPath(path) {
+    const suffix = [];
+    let current = path;
+    while (true) {
+        if (existsSync(current)) {
+            const realBase = realpathSync(current);
+            return suffix.length === 0
+                ? realBase
+                : join(realBase, ...suffix.reverse());
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return path;
+        }
+        suffix.push(basename(current));
+        current = parent;
+    }
+}
+function preflightBlockingRestoreDirectories(ops, plannedDeletePaths) {
+    for (const op of ops) {
+        if (op.kind !== "restore")
+            continue;
+        assertRestoreDirectoryPrunable(op.workspacePath, op.path, plannedDeletePaths);
+    }
+}
+function assertRestoreDirectoryPrunable(path, planPath, plannedDeletePaths) {
+    if (!existsSync(path))
+        return;
+    const stat = lstatSync(path);
+    if (!stat.isDirectory())
+        return;
+    for (const entry of readdirSync(path, { withFileTypes: true })) {
+        const childPath = join(path, entry.name);
+        if (plannedDeletePaths.has(childPath))
+            continue;
+        if (entry.isDirectory()) {
+            assertRestoreDirectoryPrunable(childPath, planPath, plannedDeletePaths);
+            continue;
+        }
+        throw new Error(`rewind restore target is blocked by unplanned workspace entry: ${planPath}`);
+    }
+}
+function pruneBlockingRestoreDirectory(path) {
+    if (!existsSync(path))
+        return;
+    const stat = lstatSync(path);
+    if (!stat.isDirectory())
+        return;
+    for (const entry of readdirSync(path, { withFileTypes: true })) {
+        const childPath = join(path, entry.name);
+        if (entry.isDirectory())
+            pruneBlockingRestoreDirectory(childPath);
+    }
+    rmdirSync(path);
+}
+function readRestoreBlob(op, store) {
+    const expectedSha256 = normalizeSnapshotContentSha256(op.contentSha256);
+    const content = store.get(op.contentSha256);
+    if (content.byteLength !== op.size) {
+        throw new Error(`snapshot blob size mismatch for ${op.path}: expected ${op.size}, got ${content.byteLength}`);
+    }
+    const actualSha256 = sha256Content(content);
+    if (actualSha256 !== expectedSha256) {
+        throw new Error(`snapshot blob hash mismatch for ${op.path}: expected ${expectedSha256}, got ${actualSha256}`);
+    }
+    return content;
+}
+function normalizeSnapshotContentSha256(contentSha256) {
+    if (!SNAPSHOT_SHA256_PATTERN.test(contentSha256)) {
+        throw new Error(`invalid snapshot blob sha256: ${contentSha256}`);
+    }
+    return contentSha256.replace(/^sha256:/iu, "").toLowerCase();
+}
+function writeBlobFileAtomic(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeTextFileAtomic(path, content.toString("binary"), {
+        encoding: "binary",
+    });
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/agent/snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../../src/agent/snapshot-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n\texistsSync,\n\tlstatSync,\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\trealpathSync,\n\trmSync,\n\trmdirSync,\n} from \"node:fs\";\nimport {\n\tbasename,\n\tdirname,\n\tisAbsolute,\n\tjoin,\n\trelative,\n\tresolve,\n} from \"node:path\";\nimport { PATHS } from \"../config/constants.js\";\nimport { defaultRuntimeEnv } from \"../runtime/env.js\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport type { RewindPlan, RewindRestoreOp } from \"./snapshot-rewind-plan.js\";\n\nconst SNAPSHOT_SHA256_PATTERN = /^(?:sha256:)?[a-f0-9]{64}$/iu;\n\nexport interface SnapshotBlobStoreConfig {\n\trootDir?: string;\n}\n\nexport interface RewindExecutionResult {\n\ttargetIndex: number;\n\tfromIndex: number;\n\trestored: string[];\n\tdeleted: string[];\n\tbytesRestored: number;\n\tdryRun: boolean;\n}\n\ntype PreparedRewindOp =\n\t| {\n\t\t\tkind: \"delete\";\n\t\t\tpath: string;\n\t\t\tworkspacePath: string;\n\t  }\n\t| {\n\t\t\tkind: \"restore\";\n\t\t\tpath: string;\n\t\t\tworkspacePath: string;\n\t\t\tcontent: Buffer;\n\t\t\tsize: number;\n\t  };\n\nexport function getSnapshotBlobRoot(rootDir?: string): string {\n\treturn (\n\t\trootDir ??\n\t\tdefaultRuntimeEnv().snapshotBlobDir ??\n\t\tjoin(PATHS.MAESTRO_HOME, \"snapshots\", \"blobs\")\n\t);\n}\n\nexport function sha256Content(content: string | Buffer): string {\n\treturn createHash(\"sha256\").update(content).digest(\"hex\");\n}\n\nexport class SnapshotBlobStore {\n\tprivate readonly rootDir: string;\n\n\tconstructor(config: SnapshotBlobStoreConfig = {}) {\n\t\tthis.rootDir = getSnapshotBlobRoot(config.rootDir);\n\t}\n\n\tput(content: string | Buffer): { contentSha256: string; size: number } {\n\t\tconst buffer = Buffer.isBuffer(content)\n\t\t\t? content\n\t\t\t: Buffer.from(content, \"utf-8\");\n\t\tconst contentSha256 = sha256Content(buffer);\n\t\tconst path = this.getPath(contentSha256);\n\t\tif (!existsSync(path)) {\n\t\t\twriteBlobFileAtomic(path, buffer);\n\t\t}\n\t\treturn { contentSha256, size: buffer.byteLength };\n\t}\n\n\tget(contentSha256: string): Buffer {\n\t\tconst path = this.getPath(contentSha256);\n\t\tif (!existsSync(path)) {\n\t\t\tthrow new Error(`snapshot blob not found: ${contentSha256}`);\n\t\t}\n\t\treturn readFileSync(path);\n\t}\n\n\thas(contentSha256: string): boolean {\n\t\treturn existsSync(this.getPath(contentSha256));\n\t}\n\n\tgetPath(contentSha256: string): string {\n\t\tconst clean = normalizeSnapshotContentSha256(contentSha256);\n\t\treturn join(this.rootDir, clean.slice(0, 2), clean);\n\t}\n}\n\nexport function executeRewindPlan(options: {\n\tplan: RewindPlan;\n\tworkspaceDir: string;\n\tstore?: SnapshotBlobStore;\n\tdryRun?: boolean;\n}): RewindExecutionResult {\n\tconst store = options.store ?? new SnapshotBlobStore();\n\tconst restored: string[] = [];\n\tconst deleted: string[] = [];\n\tlet bytesRestored = 0;\n\tconst workspaceRoot = realpathSync(resolve(options.workspaceDir));\n\tconst preparedOps = options.plan.ops.map((op): PreparedRewindOp => {\n\t\tconst workspacePath = resolveWorkspacePlanPath(workspaceRoot, op.path);\n\t\tif (op.kind === \"delete\") {\n\t\t\treturn { kind: \"delete\", path: op.path, workspacePath };\n\t\t}\n\t\treturn {\n\t\t\tkind: \"restore\",\n\t\t\tpath: op.path,\n\t\t\tworkspacePath,\n\t\t\tcontent: readRestoreBlob(op, store),\n\t\t\tsize: op.size,\n\t\t};\n\t});\n\tconst plannedDeletePaths = new Set(\n\t\tpreparedOps.flatMap((op) =>\n\t\t\top.kind === \"delete\" ? [op.workspacePath] : [],\n\t\t),\n\t);\n\tpreflightBlockingRestoreDirectories(preparedOps, plannedDeletePaths);\n\tfor (const op of preparedOps) {\n\t\tif (op.kind === \"delete\") {\n\t\t\tif (!options.dryRun) {\n\t\t\t\trmSync(op.workspacePath, { force: true, recursive: false });\n\t\t\t}\n\t\t\tdeleted.push(op.path);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!options.dryRun) {\n\t\t\tpruneBlockingRestoreDirectory(op.workspacePath);\n\t\t\twriteBlobFileAtomic(op.workspacePath, op.content);\n\t\t}\n\t\trestored.push(op.path);\n\t\tbytesRestored += op.size;\n\t}\n\treturn {\n\t\ttargetIndex: options.plan.targetIndex,\n\t\tfromIndex: options.plan.fromIndex,\n\t\trestored,\n\t\tdeleted,\n\t\tbytesRestored,\n\t\tdryRun: options.dryRun === true,\n\t};\n}\n\nfunction resolveWorkspacePlanPath(\n\tworkspaceRoot: string,\n\topPath: string,\n): string {\n\tif (!opPath || isAbsolute(opPath)) {\n\t\tthrow new Error(`rewind plan path must be relative: ${opPath}`);\n\t}\n\tif (isParentDirectoryRelPath(opPath)) {\n\t\tthrow new Error(`rewind plan path escapes workspace: ${opPath}`);\n\t}\n\tconst resolvedPath = resolve(workspaceRoot, opPath);\n\tconst rel = relative(workspaceRoot, resolvedPath);\n\tif (!rel || isParentDirectoryRelPath(rel) || isAbsolute(rel)) {\n\t\tthrow new Error(`rewind plan path escapes workspace: ${opPath}`);\n\t}\n\tconst workspaceRealRoot = realpathSync(workspaceRoot);\n\tconst parentRealPath = resolveRealPath(dirname(resolvedPath));\n\tconst parentRel = relative(workspaceRealRoot, parentRealPath);\n\tif (\n\t\t(parentRealPath !== workspaceRealRoot && !parentRel) ||\n\t\tisParentDirectoryRelPath(parentRel) ||\n\t\tisAbsolute(parentRel)\n\t) {\n\t\tthrow new Error(`rewind plan path escapes workspace: ${opPath}`);\n\t}\n\treturn resolvedPath;\n}\n\nfunction isParentDirectoryRelPath(relPath: string): boolean {\n\treturn (\n\t\trelPath === \"..\" || relPath.startsWith(\"../\") || relPath.startsWith(\"..\\\\\")\n\t);\n}\n\nfunction resolveRealPath(path: string): string {\n\tconst suffix: string[] = [];\n\tlet current = path;\n\twhile (true) {\n\t\tif (existsSync(current)) {\n\t\t\tconst realBase = realpathSync(current);\n\t\t\treturn suffix.length === 0\n\t\t\t\t? realBase\n\t\t\t\t: join(realBase, ...suffix.reverse());\n\t\t}\n\t\tconst parent = dirname(current);\n\t\tif (parent === current) {\n\t\t\treturn path;\n\t\t}\n\t\tsuffix.push(basename(current));\n\t\tcurrent = parent;\n\t}\n}\n\nfunction preflightBlockingRestoreDirectories(\n\tops: readonly PreparedRewindOp[],\n\tplannedDeletePaths: ReadonlySet<string>,\n): void {\n\tfor (const op of ops) {\n\t\tif (op.kind !== \"restore\") continue;\n\t\tassertRestoreDirectoryPrunable(\n\t\t\top.workspacePath,\n\t\t\top.path,\n\t\t\tplannedDeletePaths,\n\t\t);\n\t}\n}\n\nfunction assertRestoreDirectoryPrunable(\n\tpath: string,\n\tplanPath: string,\n\tplannedDeletePaths: ReadonlySet<string>,\n): void {\n\tif (!existsSync(path)) return;\n\tconst stat = lstatSync(path);\n\tif (!stat.isDirectory()) return;\n\tfor (const entry of readdirSync(path, { withFileTypes: true })) {\n\t\tconst childPath = join(path, entry.name);\n\t\tif (plannedDeletePaths.has(childPath)) continue;\n\t\tif (entry.isDirectory()) {\n\t\t\tassertRestoreDirectoryPrunable(childPath, planPath, plannedDeletePaths);\n\t\t\tcontinue;\n\t\t}\n\t\tthrow new Error(\n\t\t\t`rewind restore target is blocked by unplanned workspace entry: ${planPath}`,\n\t\t);\n\t}\n}\n\nfunction pruneBlockingRestoreDirectory(path: string): void {\n\tif (!existsSync(path)) return;\n\tconst stat = lstatSync(path);\n\tif (!stat.isDirectory()) return;\n\tfor (const entry of readdirSync(path, { withFileTypes: true })) {\n\t\tconst childPath = join(path, entry.name);\n\t\tif (entry.isDirectory()) pruneBlockingRestoreDirectory(childPath);\n\t}\n\trmdirSync(path);\n}\n\nfunction readRestoreBlob(\n\top: RewindRestoreOp,\n\tstore: SnapshotBlobStore,\n): Buffer {\n\tconst expectedSha256 = normalizeSnapshotContentSha256(op.contentSha256);\n\tconst content = store.get(op.contentSha256);\n\tif (content.byteLength !== op.size) {\n\t\tthrow new Error(\n\t\t\t`snapshot blob size mismatch for ${op.path}: expected ${op.size}, got ${content.byteLength}`,\n\t\t);\n\t}\n\tconst actualSha256 = sha256Content(content);\n\tif (actualSha256 !== expectedSha256) {\n\t\tthrow new Error(\n\t\t\t`snapshot blob hash mismatch for ${op.path}: expected ${expectedSha256}, got ${actualSha256}`,\n\t\t);\n\t}\n\treturn content;\n}\n\nfunction normalizeSnapshotContentSha256(contentSha256: string): string {\n\tif (!SNAPSHOT_SHA256_PATTERN.test(contentSha256)) {\n\t\tthrow new Error(`invalid snapshot blob sha256: ${contentSha256}`);\n\t}\n\treturn contentSha256.replace(/^sha256:/iu, \"\").toLowerCase();\n}\n\nfunction writeBlobFileAtomic(path: string, content: Buffer): void {\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteTextFileAtomic(path, content.toString(\"binary\"), {\n\t\tencoding: \"binary\",\n\t});\n}\n"]}

package/dist/agent/specialist-profiles.d.ts

@@ -0,0 +1,36 @@
+export type SpecialistProfileScope = "project" | "user";
+export interface SpecialistProfile {
+    name: string;
+    description?: string;
+    prompt: string;
+    tools?: string[];
+    model?: string;
+    scope: SpecialistProfileScope;
+    path: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export declare function normalizeSpecialistProfileName(name: string): string;
+export declare function getSpecialistProfileDir(scope: SpecialistProfileScope, workspaceDir?: string): string;
+export declare function getSpecialistProfilePath(name: string, scope: SpecialistProfileScope, workspaceDir?: string): string;
+export declare function createSpecialistProfile(options: {
+    name: string;
+    description?: string;
+    prompt: string;
+    tools?: string[];
+    model?: string;
+    scope?: SpecialistProfileScope;
+    workspaceDir?: string;
+    now?: string;
+    overwrite?: boolean;
+}): SpecialistProfile;
+export declare function readSpecialistProfile(path: string, scope: SpecialistProfileScope): SpecialistProfile;
+export declare function listSpecialistProfiles(workspaceDir?: string): SpecialistProfile[];
+export declare function resolveSpecialistProfile(name: string, workspaceDir?: string): SpecialistProfile | null;
+export declare function deleteSpecialistProfile(options: {
+    name: string;
+    scope?: SpecialistProfileScope;
+    workspaceDir?: string;
+}): boolean;
+export declare function applySpecialistProfileToPrompt(prompt: string, profile: SpecialistProfile | null | undefined): string;
+//# sourceMappingURL=specialist-profiles.d.ts.map

package/dist/agent/specialist-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-profiles.d.ts","sourceRoot":"","sources":["../../src/agent/specialist-profiles.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,sBAAsB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnE;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,sBAAsB,EAC7B,YAAY,SAAgB,GAC1B,MAAM,CAIR;AAED,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,sBAAsB,EAC7B,YAAY,SAAgB,GAC1B,MAAM,CAKR;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,iBAAiB,CAmCpB;AAED,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,sBAAsB,GAC3B,iBAAiB,CAkCnB;AAED,wBAAgB,sBAAsB,CACrC,YAAY,SAAgB,GAC1B,iBAAiB,EAAE,CAsBrB;AAED,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,SAAgB,GAC1B,iBAAiB,GAAG,IAAI,CAO1B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAUV;AAED,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC3C,MAAM,CAaR"}

package/dist/agent/specialist-profiles.js

@@ -0,0 +1,159 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, } from "node:fs";
+import { basename, join } from "node:path";
+import YAML from "yaml";
+import { PATHS } from "../config/constants.js";
+import { writeTextFileAtomic } from "../utils/fs.js";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("agent:specialist-profiles");
+export function normalizeSpecialistProfileName(name) {
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-");
+    const stripped = normalized.replace(/^-+|-+$/g, "");
+    if (!stripped || stripped.length > 64) {
+        throw new Error("profile name must be 1-64 lowercase letters, numbers, or hyphens");
+    }
+    return stripped;
+}
+export function getSpecialistProfileDir(scope, workspaceDir = process.cwd()) {
+    return scope === "project"
+        ? join(workspaceDir, ".maestro", "agent-profiles")
+        : join(PATHS.MAESTRO_HOME, "agent-profiles");
+}
+export function getSpecialistProfilePath(name, scope, workspaceDir = process.cwd()) {
+    return join(getSpecialistProfileDir(scope, workspaceDir), `${normalizeSpecialistProfileName(name)}.md`);
+}
+export function createSpecialistProfile(options) {
+    const scope = options.scope ?? "project";
+    const name = normalizeSpecialistProfileName(options.name);
+    const path = getSpecialistProfilePath(name, scope, options.workspaceDir);
+    if (existsSync(path) && !options.overwrite) {
+        throw new Error(`specialist profile already exists: ${name}`);
+    }
+    const now = options.now ?? new Date().toISOString();
+    const prompt = options.prompt.trim();
+    if (!prompt) {
+        throw new Error("profile prompt is required");
+    }
+    mkdirSync(getSpecialistProfileDir(scope, options.workspaceDir), {
+        recursive: true,
+    });
+    const frontmatter = YAML.stringify({
+        name,
+        description: options.description,
+        tools: options.tools,
+        model: options.model,
+        createdAt: now,
+        updatedAt: now,
+    });
+    writeTextFileAtomic(path, `---\n${frontmatter}---\n\n${prompt}\n`);
+    return {
+        name,
+        description: options.description,
+        prompt,
+        tools: options.tools,
+        model: options.model,
+        scope,
+        path,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function readSpecialistProfile(path, scope) {
+    const content = readFileSync(path, "utf-8");
+    const parsed = parseProfileMarkdown(content);
+    const name = typeof parsed.metadata.name === "string"
+        ? normalizeSpecialistProfileName(parsed.metadata.name)
+        : normalizeSpecialistProfileName(basename(path, ".md"));
+    return {
+        name,
+        description: typeof parsed.metadata.description === "string"
+            ? parsed.metadata.description
+            : undefined,
+        prompt: parsed.body.trim(),
+        tools: Array.isArray(parsed.metadata.tools)
+            ? parsed.metadata.tools.filter((tool) => typeof tool === "string")
+            : undefined,
+        model: typeof parsed.metadata.model === "string"
+            ? parsed.metadata.model
+            : undefined,
+        scope,
+        path,
+        createdAt: typeof parsed.metadata.createdAt === "string"
+            ? parsed.metadata.createdAt
+            : undefined,
+        updatedAt: typeof parsed.metadata.updatedAt === "string"
+            ? parsed.metadata.updatedAt
+            : undefined,
+    };
+}
+export function listSpecialistProfiles(workspaceDir = process.cwd()) {
+    const byName = new Map();
+    for (const scope of ["user", "project"]) {
+        const dir = getSpecialistProfileDir(scope, workspaceDir);
+        if (!existsSync(dir))
+            continue;
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith(".md"))
+                continue;
+            try {
+                const profile = readSpecialistProfile(join(dir, entry.name), scope);
+                byName.set(profile.name, profile);
+            }
+            catch (error) {
+                logger.debug("Failed to read specialist profile", {
+                    file: entry.name,
+                    scope,
+                    error,
+                });
+            }
+        }
+    }
+    return [...byName.values()].sort((left, right) => left.name.localeCompare(right.name));
+}
+export function resolveSpecialistProfile(name, workspaceDir = process.cwd()) {
+    const normalized = normalizeSpecialistProfileName(name);
+    return (listSpecialistProfiles(workspaceDir).find((profile) => profile.name === normalized) ?? null);
+}
+export function deleteSpecialistProfile(options) {
+    const scope = options.scope ?? "project";
+    const path = getSpecialistProfilePath(options.name, scope, options.workspaceDir);
+    if (!existsSync(path))
+        return false;
+    unlinkSync(path);
+    return true;
+}
+export function applySpecialistProfileToPrompt(prompt, profile) {
+    if (!profile)
+        return prompt;
+    return [
+        `Specialist profile: ${profile.name}`,
+        profile.description ? `Description: ${profile.description}` : "",
+        "Profile instructions:",
+        profile.prompt,
+        "",
+        "Assigned task:",
+        prompt,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function parseProfileMarkdown(content) {
+    if (!content.startsWith("---\n")) {
+        return { metadata: {}, body: content };
+    }
+    const end = content.indexOf("\n---", 4);
+    if (end === -1)
+        return { metadata: {}, body: content };
+    const frontmatter = content.slice(4, end);
+    const body = content.slice(end + 4).replace(/^\r?\n/u, "");
+    const metadata = YAML.parse(frontmatter);
+    return {
+        metadata: metadata && typeof metadata === "object"
+            ? metadata
+            : {},
+        body,
+    };
+}
+//# sourceMappingURL=specialist-profiles.js.map

package/dist/agent/specialist-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-profiles.js","sourceRoot":"","sources":["../../src/agent/specialist-profiles.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\texistsSync,\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\tunlinkSync,\n} from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport YAML from \"yaml\";\nimport { PATHS } from \"../config/constants.js\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport { createLogger } from \"../utils/logger.js\";\n\nconst logger = createLogger(\"agent:specialist-profiles\");\n\nexport type SpecialistProfileScope = \"project\" | \"user\";\n\nexport interface SpecialistProfile {\n\tname: string;\n\tdescription?: string;\n\tprompt: string;\n\ttools?: string[];\n\tmodel?: string;\n\tscope: SpecialistProfileScope;\n\tpath: string;\n\tcreatedAt?: string;\n\tupdatedAt?: string;\n}\n\nexport function normalizeSpecialistProfileName(name: string): string {\n\tconst normalized = name\n\t\t.trim()\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9-]+/g, \"-\");\n\tconst stripped = normalized.replace(/^-+|-+$/g, \"\");\n\tif (!stripped || stripped.length > 64) {\n\t\tthrow new Error(\n\t\t\t\"profile name must be 1-64 lowercase letters, numbers, or hyphens\",\n\t\t);\n\t}\n\treturn stripped;\n}\n\nexport function getSpecialistProfileDir(\n\tscope: SpecialistProfileScope,\n\tworkspaceDir = process.cwd(),\n): string {\n\treturn scope === \"project\"\n\t\t? join(workspaceDir, \".maestro\", \"agent-profiles\")\n\t\t: join(PATHS.MAESTRO_HOME, \"agent-profiles\");\n}\n\nexport function getSpecialistProfilePath(\n\tname: string,\n\tscope: SpecialistProfileScope,\n\tworkspaceDir = process.cwd(),\n): string {\n\treturn join(\n\t\tgetSpecialistProfileDir(scope, workspaceDir),\n\t\t`${normalizeSpecialistProfileName(name)}.md`,\n\t);\n}\n\nexport function createSpecialistProfile(options: {\n\tname: string;\n\tdescription?: string;\n\tprompt: string;\n\ttools?: string[];\n\tmodel?: string;\n\tscope?: SpecialistProfileScope;\n\tworkspaceDir?: string;\n\tnow?: string;\n\toverwrite?: boolean;\n}): SpecialistProfile {\n\tconst scope = options.scope ?? \"project\";\n\tconst name = normalizeSpecialistProfileName(options.name);\n\tconst path = getSpecialistProfilePath(name, scope, options.workspaceDir);\n\tif (existsSync(path) && !options.overwrite) {\n\t\tthrow new Error(`specialist profile already exists: ${name}`);\n\t}\n\tconst now = options.now ?? new Date().toISOString();\n\tconst prompt = options.prompt.trim();\n\tif (!prompt) {\n\t\tthrow new Error(\"profile prompt is required\");\n\t}\n\tmkdirSync(getSpecialistProfileDir(scope, options.workspaceDir), {\n\t\trecursive: true,\n\t});\n\tconst frontmatter = YAML.stringify({\n\t\tname,\n\t\tdescription: options.description,\n\t\ttools: options.tools,\n\t\tmodel: options.model,\n\t\tcreatedAt: now,\n\t\tupdatedAt: now,\n\t});\n\twriteTextFileAtomic(path, `---\\n${frontmatter}---\\n\\n${prompt}\\n`);\n\treturn {\n\t\tname,\n\t\tdescription: options.description,\n\t\tprompt,\n\t\ttools: options.tools,\n\t\tmodel: options.model,\n\t\tscope,\n\t\tpath,\n\t\tcreatedAt: now,\n\t\tupdatedAt: now,\n\t};\n}\n\nexport function readSpecialistProfile(\n\tpath: string,\n\tscope: SpecialistProfileScope,\n): SpecialistProfile {\n\tconst content = readFileSync(path, \"utf-8\");\n\tconst parsed = parseProfileMarkdown(content);\n\tconst name =\n\t\ttypeof parsed.metadata.name === \"string\"\n\t\t\t? normalizeSpecialistProfileName(parsed.metadata.name)\n\t\t\t: normalizeSpecialistProfileName(basename(path, \".md\"));\n\treturn {\n\t\tname,\n\t\tdescription:\n\t\t\ttypeof parsed.metadata.description === \"string\"\n\t\t\t\t? parsed.metadata.description\n\t\t\t\t: undefined,\n\t\tprompt: parsed.body.trim(),\n\t\ttools: Array.isArray(parsed.metadata.tools)\n\t\t\t? parsed.metadata.tools.filter(\n\t\t\t\t\t(tool): tool is string => typeof tool === \"string\",\n\t\t\t\t)\n\t\t\t: undefined,\n\t\tmodel:\n\t\t\ttypeof parsed.metadata.model === \"string\"\n\t\t\t\t? parsed.metadata.model\n\t\t\t\t: undefined,\n\t\tscope,\n\t\tpath,\n\t\tcreatedAt:\n\t\t\ttypeof parsed.metadata.createdAt === \"string\"\n\t\t\t\t? parsed.metadata.createdAt\n\t\t\t\t: undefined,\n\t\tupdatedAt:\n\t\t\ttypeof parsed.metadata.updatedAt === \"string\"\n\t\t\t\t? parsed.metadata.updatedAt\n\t\t\t\t: undefined,\n\t};\n}\n\nexport function listSpecialistProfiles(\n\tworkspaceDir = process.cwd(),\n): SpecialistProfile[] {\n\tconst byName = new Map<string, SpecialistProfile>();\n\tfor (const scope of [\"user\", \"project\"] as const) {\n\t\tconst dir = getSpecialistProfileDir(scope, workspaceDir);\n\t\tif (!existsSync(dir)) continue;\n\t\tfor (const entry of readdirSync(dir, { withFileTypes: true })) {\n\t\t\tif (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n\t\t\ttry {\n\t\t\t\tconst profile = readSpecialistProfile(join(dir, entry.name), scope);\n\t\t\t\tbyName.set(profile.name, profile);\n\t\t\t} catch (error) {\n\t\t\t\tlogger.debug(\"Failed to read specialist profile\", {\n\t\t\t\t\tfile: entry.name,\n\t\t\t\t\tscope,\n\t\t\t\t\terror,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\treturn [...byName.values()].sort((left, right) =>\n\t\tleft.name.localeCompare(right.name),\n\t);\n}\n\nexport function resolveSpecialistProfile(\n\tname: string,\n\tworkspaceDir = process.cwd(),\n): SpecialistProfile | null {\n\tconst normalized = normalizeSpecialistProfileName(name);\n\treturn (\n\t\tlistSpecialistProfiles(workspaceDir).find(\n\t\t\t(profile) => profile.name === normalized,\n\t\t) ?? null\n\t);\n}\n\nexport function deleteSpecialistProfile(options: {\n\tname: string;\n\tscope?: SpecialistProfileScope;\n\tworkspaceDir?: string;\n}): boolean {\n\tconst scope = options.scope ?? \"project\";\n\tconst path = getSpecialistProfilePath(\n\t\toptions.name,\n\t\tscope,\n\t\toptions.workspaceDir,\n\t);\n\tif (!existsSync(path)) return false;\n\tunlinkSync(path);\n\treturn true;\n}\n\nexport function applySpecialistProfileToPrompt(\n\tprompt: string,\n\tprofile: SpecialistProfile | null | undefined,\n): string {\n\tif (!profile) return prompt;\n\treturn [\n\t\t`Specialist profile: ${profile.name}`,\n\t\tprofile.description ? `Description: ${profile.description}` : \"\",\n\t\t\"Profile instructions:\",\n\t\tprofile.prompt,\n\t\t\"\",\n\t\t\"Assigned task:\",\n\t\tprompt,\n\t]\n\t\t.filter(Boolean)\n\t\t.join(\"\\n\");\n}\n\nfunction parseProfileMarkdown(content: string): {\n\tmetadata: Record<string, unknown>;\n\tbody: string;\n} {\n\tif (!content.startsWith(\"---\\n\")) {\n\t\treturn { metadata: {}, body: content };\n\t}\n\tconst end = content.indexOf(\"\\n---\", 4);\n\tif (end === -1) return { metadata: {}, body: content };\n\tconst frontmatter = content.slice(4, end);\n\tconst body = content.slice(end + 4).replace(/^\\r?\\n/u, \"\");\n\tconst metadata = YAML.parse(frontmatter);\n\treturn {\n\t\tmetadata:\n\t\t\tmetadata && typeof metadata === \"object\"\n\t\t\t\t? (metadata as Record<string, unknown>)\n\t\t\t\t: {},\n\t\tbody,\n\t};\n}\n"]}