@helmiq/crew 0.1.0

package/dist/evaluation/scorer.js

@@ -0,0 +1,94 @@
+const WEIGHT_VALUES = {
+    blocking: 3,
+    important: 2,
+    advisory: 1,
+};
+/**
+ * Compute a weighted aggregate score from per-criterion scores.
+ * blocking=3, important=2, advisory=1
+ */
+export function computeAggregate(scores) {
+    if (scores.length === 0)
+        return 0;
+    let weightedSum = 0;
+    let totalWeight = 0;
+    for (const s of scores) {
+        const w = WEIGHT_VALUES[s.weight];
+        weightedSum += s.score * w;
+        totalWeight += w;
+    }
+    if (totalWeight === 0)
+        return 0;
+    return Math.round((weightedSum / totalWeight) * 100) / 100;
+}
+/**
+ * Determine pass/fail from per-criterion scores and rubric thresholds.
+ *
+ * Pass requires:
+ * 1. All blocking criteria score >= pass_threshold
+ * 2. If aggregate_threshold is set, the weighted aggregate must meet it
+ */
+export function determinePassFail(scores, rubric) {
+    const { pass_threshold, aggregate_threshold } = rubric.rubric;
+    const blockingFailed = scores.filter((s) => s.weight === 'blocking' && s.score < pass_threshold);
+    if (blockingFailed.length > 0)
+        return false;
+    if (aggregate_threshold !== undefined) {
+        const aggregate = computeAggregate(scores);
+        if (aggregate < aggregate_threshold)
+            return false;
+    }
+    return true;
+}
+/**
+ * Parse the LLM's structured evaluation response into typed scores.
+ * Expects a JSON array of { name, score, reasoning } objects.
+ * Merges the weight from the rubric criteria definitions.
+ */
+export function parseEvaluationResponse(text, rubric) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        const jsonMatch = /\[[\s\S]*\]/.exec(text);
+        if (jsonMatch) {
+            parsed = JSON.parse(jsonMatch[0]);
+        }
+        else {
+            return rubric.rubric.criteria.map((c) => ({
+                name: c.name,
+                weight: c.weight,
+                score: 0,
+                reasoning: 'Failed to parse evaluation response',
+            }));
+        }
+    }
+    if (!Array.isArray(parsed)) {
+        return rubric.rubric.criteria.map((c) => ({
+            name: c.name,
+            weight: c.weight,
+            score: 0,
+            reasoning: 'Evaluation response was not an array',
+        }));
+    }
+    return rubric.rubric.criteria.map((criterion) => {
+        const match = parsed.find((entry) => entry.name?.toLowerCase() === criterion.name.toLowerCase());
+        return {
+            name: criterion.name,
+            weight: criterion.weight,
+            score: typeof match?.score === 'number' ? match.score : 0,
+            reasoning: match?.reasoning ?? 'No evaluation provided',
+        };
+    });
+}
+/**
+ * Format failure feedback for the refinement callback.
+ */
+export function formatFailureFeedback(scores) {
+    const failed = scores.filter((s) => s.score < 7);
+    if (failed.length === 0)
+        return 'Evaluation failed but no specific criteria scored below threshold.';
+    const lines = failed.map((s) => `- ${s.name} (${s.weight}, score: ${s.score}/10): ${s.reasoning}`);
+    return `The following evaluation criteria need improvement:\n${lines.join('\n')}\n\nPlease revise the artifact to address these issues.`;
+}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+export { loadConfig, loadYaml, projectConfigPath, loadProjectConfig } from './config/index.js';
+export type { LoadedConfig, ResolverOptions, ResolvedSkills } from './config/index.js';
+export { resolveModel, resolveExecutionModel, resolveEvalModel } from './config/index.js';
+export type { ResolvedModel } from './config/index.js';
+export { assembleContext } from './context/index.js';
+export type { ContextBlock, AssembledContext } from './context/index.js';
+export { readArtifact } from './context/index.js';
+export type { ArtifactReadResult } from './context/index.js';
+export { readCodeFiles } from './context/index.js';
+export type { CodeFileResult } from './context/index.js';
+export { extractSections } from './context/index.js';
+export { countTokens, defaultTokenBudget } from './context/index.js';
+export { executeSimpleTask } from './engine/index.js';
+export type { EngineResult } from './engine/index.js';
+export { executeCompositeTask } from './engine/index.js';
+export type { CompositeResult, CheckpointRecord } from './engine/index.js';
+export { callLlm } from './engine/index.js';
+export type { LlmCallOptions, LlmCallResult } from './engine/index.js';
+export { filterTools } from './engine/index.js';
+export { executeWithToolDispatch, toSchemaOnlyToolSet, filterCrewTools } from './engine/index.js';
+export type { ToolDispatchOptions, ToolDispatchResult } from './engine/index.js';
+export { evaluate } from './evaluation/index.js';
+export { computeAggregate, determinePassFail, parseEvaluationResponse, } from './evaluation/index.js';
+export type { CriterionScore, EvaluationResult } from './evaluation/index.js';
+export { publish } from './publication/index.js';
+export type { PublicationOptions, PublicationResult } from './publication/index.js';
+export { addFrontmatter, parseFrontmatter } from './publication/index.js';
+export type { ArtifactMetadata } from './publication/index.js';
+export { writeProvenance, writeManifest } from './publication/index.js';
+export type { ManifestData } from './publication/index.js';
+export { scanForSecrets } from './publication/index.js';
+export { acquireLock } from './control/index.js';
+export type { LockHandle } from './control/index.js';
+export { transitionState, persistState, loadState } from './control/index.js';
+export { generateRunId, generateIdempotencyKey } from './control/index.js';
+export { executeRunCommand } from './cli/run.js';
+export type { RunCommandOptions, RunCommandResult, ProviderFactory } from './cli/run.js';
+export { resolveProvider } from './providers/index.js';
+export { detectWorkspace, WorkspaceNotFoundError } from './workspace/index.js';
+export { createToolRegistry } from './tools/index.js';
+export type { ToolRegistryOptions } from './tools/index.js';
+export { getAction, listActions, listActionNames, resolveAction, parseWorkItemId, UnknownActionError, DirectDispatcher, } from './actions/index.js';
+export type { ActionDefinition, ActionTrack, ActionIdLevel, ResolvedAction, ActionResult, ResolveOptions, ActionDispatcher, } from './actions/index.js';
+export { CrewError, ConfigNotFoundError, PersonaNotFoundError, RubricNotFoundError, SkillNotFoundError, SchemaValidationError, ModelNotFoundError, ModelNotAllowedError, LlmCallError, PublicationError, SecretDetectedError, LockAcquisitionError, InvalidStateTransitionError, ArtifactStoreError, } from './common/errors.js';
+export type { PersonaSpec, ProjectConfig, SourceConfig, WorkspaceConfig, LlmConfig, Provider, EvaluationRubric, RunStatus, RunRecord, Provenance, LlmProvider, GenerateTextOptions, GenerateTextResult, LlmMessage, ToolCallRecord, ToolDefinition, ToolSet, ArtifactStore, ArtifactRecord, ArtifactVersion, ArtifactListFilter, ArtifactWriteResult, CrewTool, CrewToolSet, ToolExecutionContext, ToolExecutionRecord, ToolLogger, } from './types/index.js';
+export { createNullToolContext } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,28 @@
+export { loadConfig, loadYaml, projectConfigPath, loadProjectConfig } from './config/index.js';
+export { resolveModel, resolveExecutionModel, resolveEvalModel } from './config/index.js';
+export { assembleContext } from './context/index.js';
+export { readArtifact } from './context/index.js';
+export { readCodeFiles } from './context/index.js';
+export { extractSections } from './context/index.js';
+export { countTokens, defaultTokenBudget } from './context/index.js';
+export { executeSimpleTask } from './engine/index.js';
+export { executeCompositeTask } from './engine/index.js';
+export { callLlm } from './engine/index.js';
+export { filterTools } from './engine/index.js';
+export { executeWithToolDispatch, toSchemaOnlyToolSet, filterCrewTools } from './engine/index.js';
+export { evaluate } from './evaluation/index.js';
+export { computeAggregate, determinePassFail, parseEvaluationResponse, } from './evaluation/index.js';
+export { publish } from './publication/index.js';
+export { addFrontmatter, parseFrontmatter } from './publication/index.js';
+export { writeProvenance, writeManifest } from './publication/index.js';
+export { scanForSecrets } from './publication/index.js';
+export { acquireLock } from './control/index.js';
+export { transitionState, persistState, loadState } from './control/index.js';
+export { generateRunId, generateIdempotencyKey } from './control/index.js';
+export { executeRunCommand } from './cli/run.js';
+export { resolveProvider } from './providers/index.js';
+export { detectWorkspace, WorkspaceNotFoundError } from './workspace/index.js';
+export { createToolRegistry } from './tools/index.js';
+export { getAction, listActions, listActionNames, resolveAction, parseWorkItemId, UnknownActionError, DirectDispatcher, } from './actions/index.js';
+export { CrewError, ConfigNotFoundError, PersonaNotFoundError, RubricNotFoundError, SkillNotFoundError, SchemaValidationError, ModelNotFoundError, ModelNotAllowedError, LlmCallError, PublicationError, SecretDetectedError, LockAcquisitionError, InvalidStateTransitionError, ArtifactStoreError, } from './common/errors.js';
+export { createNullToolContext } from './types/index.js';

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { resolveProvider } from './provider-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1 @@
+export { resolveProvider } from './provider-factory.js';

package/dist/providers/provider-factory.d.ts

@@ -0,0 +1,11 @@
+import type { LlmProvider } from '../types/index.js';
+import type { ResolvedModel } from '../config/model-resolver.js';
+/**
+ * Resolve a provider from the model config using dynamic imports.
+ *
+ * Provider packages are loaded at runtime so `@helmiq/crew` does not
+ * declare a package.json dependency on them (which would create a cycle
+ * since providers depend on crew for the LlmProvider contract).
+ */
+export declare function resolveProvider(model: ResolvedModel): Promise<LlmProvider>;
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/providers/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/providers/provider-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAWjE;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBhF"}

package/dist/providers/provider-factory.js

@@ -0,0 +1,30 @@
+const PROVIDER_PACKAGES = {
+    anthropic: '@helmiq/anthropic-sdk',
+    cursor: '@helmiq/cursor-sdk',
+};
+/**
+ * Resolve a provider from the model config using dynamic imports.
+ *
+ * Provider packages are loaded at runtime so `@helmiq/crew` does not
+ * declare a package.json dependency on them (which would create a cycle
+ * since providers depend on crew for the LlmProvider contract).
+ */
+export async function resolveProvider(model) {
+    const apiKey = process.env[model.apiKeyEnv];
+    if (!apiKey) {
+        throw new Error(`Environment variable '${model.apiKeyEnv}' is not set (required for provider '${model.provider}')`);
+    }
+    const packageName = PROVIDER_PACKAGES[model.provider];
+    if (!packageName) {
+        const available = Object.keys(PROVIDER_PACKAGES).join(', ');
+        throw new Error(`Unsupported provider: '${model.provider}'. Available: ${available}`);
+    }
+    let mod;
+    try {
+        mod = (await import(packageName));
+    }
+    catch {
+        throw new Error(`Failed to load provider package '${packageName}'. Is it installed?`);
+    }
+    return model.provider === 'cursor' ? mod.createProvider({ apiKey }) : mod.createProvider(apiKey);
+}

package/dist/publication/frontmatter.d.ts

@@ -0,0 +1,21 @@
+export interface ArtifactMetadata {
+    author: string;
+    run_id: string;
+    status: string;
+    timestamp: string;
+    eval_score?: number;
+    eval_pass?: boolean;
+}
+/**
+ * Prepend YAML frontmatter to a Markdown artifact.
+ */
+export declare function addFrontmatter(content: string, metadata: ArtifactMetadata): string;
+/**
+ * Parse YAML frontmatter from a Markdown artifact.
+ * Returns the content body and the parsed metadata.
+ */
+export declare function parseFrontmatter(raw: string): {
+    content: string;
+    data: Record<string, unknown>;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/publication/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/publication/frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAElF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAGA"}

package/dist/publication/frontmatter.js

@@ -0,0 +1,15 @@
+import matter from 'gray-matter';
+/**
+ * Prepend YAML frontmatter to a Markdown artifact.
+ */
+export function addFrontmatter(content, metadata) {
+    return matter.stringify(content, metadata);
+}
+/**
+ * Parse YAML frontmatter from a Markdown artifact.
+ * Returns the content body and the parsed metadata.
+ */
+export function parseFrontmatter(raw) {
+    const { content, data } = matter(raw);
+    return { content, data };
+}

package/dist/publication/git-ops.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stage, commit, and optionally push a file in a Git repo.
+ * Returns the commit SHA.
+ */
+export declare function commitAndPush(repoPath: string, filePaths: string[], message: string, push: boolean, branch?: string): Promise<string>;
+/**
+ * Create and checkout a new branch in a repo.
+ */
+export declare function createBranch(repoPath: string, branchName: string): Promise<void>;
+/**
+ * Get the current HEAD commit SHA.
+ */
+export declare function getHeadSha(repoPath: string): Promise<string>;
+/**
+ * Reset the last commit (soft, local only -- before any push).
+ */
+export declare function resetLastCommit(repoPath: string): Promise<void>;
+//# sourceMappingURL=git-ops.d.ts.map

package/dist/publication/git-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../src/publication/git-ops.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAkBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE"}

package/dist/publication/git-ops.js

@@ -0,0 +1,74 @@
+import { simpleGit } from 'simple-git';
+import { PublicationError } from '../common/errors.js';
+const GIT_PUSH_RETRIES = 2;
+const GIT_PUSH_DELAY_MS = 2000;
+function git(cwd) {
+    return simpleGit(cwd);
+}
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Stage, commit, and optionally push a file in a Git repo.
+ * Returns the commit SHA.
+ */
+export async function commitAndPush(repoPath, filePaths, message, push, branch) {
+    const g = git(repoPath);
+    try {
+        await g.add(filePaths);
+        const commitResult = await g.commit(message, filePaths);
+        const sha = commitResult.commit || 'unknown';
+        if (push) {
+            await pushWithRetry(g, branch);
+        }
+        return sha;
+    }
+    catch (err) {
+        throw new PublicationError(`Git commit/push failed in ${repoPath}: ${err instanceof Error ? err.message : String(err)}`, { cause: err, stage: 'git-commit' });
+    }
+}
+async function pushWithRetry(g, branch) {
+    for (let attempt = 0; attempt <= GIT_PUSH_RETRIES; attempt++) {
+        try {
+            if (branch) {
+                await g.push('origin', branch);
+            }
+            else {
+                await g.push();
+            }
+            return;
+        }
+        catch (err) {
+            if (attempt === GIT_PUSH_RETRIES)
+                throw err;
+            await sleep(GIT_PUSH_DELAY_MS);
+        }
+    }
+}
+/**
+ * Create and checkout a new branch in a repo.
+ */
+export async function createBranch(repoPath, branchName) {
+    const g = git(repoPath);
+    try {
+        await g.checkoutLocalBranch(branchName);
+    }
+    catch (err) {
+        throw new PublicationError(`Failed to create branch '${branchName}' in ${repoPath}: ${err instanceof Error ? err.message : String(err)}`, { cause: err, stage: 'git-branch' });
+    }
+}
+/**
+ * Get the current HEAD commit SHA.
+ */
+export async function getHeadSha(repoPath) {
+    const g = git(repoPath);
+    const log = await g.log({ maxCount: 1 });
+    return log.latest?.hash ?? 'unknown';
+}
+/**
+ * Reset the last commit (soft, local only -- before any push).
+ */
+export async function resetLastCommit(repoPath) {
+    const g = git(repoPath);
+    await g.reset(['--soft', 'HEAD~1']);
+}

package/dist/publication/index.d.ts

@@ -0,0 +1,9 @@
+export { publish } from './publisher.js';
+export type { PublicationOptions, PublicationResult } from './publisher.js';
+export { addFrontmatter, parseFrontmatter } from './frontmatter.js';
+export type { ArtifactMetadata } from './frontmatter.js';
+export { commitAndPush, createBranch, getHeadSha, resetLastCommit } from './git-ops.js';
+export { writeProvenance, writeManifest } from './provenance-writer.js';
+export type { ManifestData } from './provenance-writer.js';
+export { scanForSecrets } from './secret-scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/publication/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publication/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/publication/index.js

@@ -0,0 +1,5 @@
+export { publish } from './publisher.js';
+export { addFrontmatter, parseFrontmatter } from './frontmatter.js';
+export { commitAndPush, createBranch, getHeadSha, resetLastCommit } from './git-ops.js';
+export { writeProvenance, writeManifest } from './provenance-writer.js';
+export { scanForSecrets } from './secret-scanner.js';

package/dist/publication/provenance-writer.d.ts

@@ -0,0 +1,27 @@
+import type { Provenance } from '../types/index.js';
+export interface ManifestData {
+    run_id: string;
+    artifacts_repo: {
+        commit_sha: string;
+        artifacts_referenced: {
+            type: string;
+            path: string;
+            status: string;
+        }[];
+    };
+    target_repo?: {
+        branch: string;
+        commit_sha: string;
+        pr_number?: number;
+    };
+    story_id?: string;
+}
+/**
+ * Write the provenance record for a run.
+ */
+export declare function writeProvenance(runDir: string, provenance: Provenance): Promise<string>;
+/**
+ * Write the cross-repo run manifest.
+ */
+export declare function writeManifest(runDir: string, manifest: ManifestData): Promise<string>;
+//# sourceMappingURL=provenance-writer.d.ts.map

package/dist/publication/provenance-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance-writer.d.ts","sourceRoot":"","sources":["../../src/publication/provenance-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,oBAAoB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACxE,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3F"}

package/dist/publication/provenance-writer.js

@@ -0,0 +1,21 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { stringify as yamlStringify } from 'yaml';
+/**
+ * Write the provenance record for a run.
+ */
+export async function writeProvenance(runDir, provenance) {
+    await mkdir(runDir, { recursive: true });
+    const filePath = join(runDir, 'provenance.yaml');
+    await writeFile(filePath, yamlStringify(provenance), 'utf-8');
+    return filePath;
+}
+/**
+ * Write the cross-repo run manifest.
+ */
+export async function writeManifest(runDir, manifest) {
+    await mkdir(runDir, { recursive: true });
+    const filePath = join(runDir, 'manifest.yaml');
+    await writeFile(filePath, yamlStringify({ manifest }), 'utf-8');
+    return filePath;
+}

package/dist/publication/publication.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=publication.test.d.ts.map

package/dist/publication/publication.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publication.test.d.ts","sourceRoot":"","sources":["../../src/publication/publication.test.ts"],"names":[],"mappings":""}