@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/agent/research-script-skill-candidate.js

@@ -0,0 +1,540 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { parseSkillFile, validateSkill } from '../skills/parser.js';
+import { computeChecksum, getSkillsHub, SkillsHub } from '../skills/hub.js';
+import { generateDiff } from '../utils/diff-generator.js';
+export const RESEARCH_SCRIPT_SKILL_CANDIDATE_REVIEW_SCHEMA_VERSION = 1;
+const SKILL_CANDIDATE_DIFF_PREVIEW_CHARS = 900;
+const SKILL_CANDIDATE_DIFF_PREVIEW_LINES = 32;
+const LEARNING_SKILL_CANDIDATE_MIN_SUCCESSFUL_RUNS = 2;
+export function buildResearchScriptSkillCandidate(job, runs, options = {}) {
+    const minSuccessfulRuns = normalizeMinSuccessfulRuns(options.minSuccessfulRuns);
+    const successfulRuns = runs.filter((run) => run.status === 'completed' && run.exitCode === 0);
+    const skillName = `research-${slugify(job.title)}`;
+    const skillRoot = normalizeSkillRoot(options.skillRoot);
+    const skillPath = `${skillRoot}/${skillName}/SKILL.md`;
+    const eligible = successfulRuns.length >= minSuccessfulRuns;
+    const reason = eligible
+        ? `${successfulRuns.length} successful runs met the promotion threshold.`
+        : `${successfulRuns.length}/${minSuccessfulRuns} successful runs; keep as a script job until it proves repeatable.`;
+    const candidate = {
+        eligible,
+        id: `skill-candidate-${stableHash([job.id, skillName].join('|'))}`,
+        kind: 'research-script',
+        reason,
+        skillName,
+        skillPath,
+        sourceJobId: job.id,
+        successfulRunCount: successfulRuns.length,
+        title: `${job.title} skill candidate`,
+    };
+    return {
+        ...candidate,
+        markdown: renderResearchScriptSkillCandidateMarkdown(job, successfulRuns, candidate),
+    };
+}
+export async function materializeResearchScriptSkillCandidate(candidate, options) {
+    const rootDir = path.resolve(options.rootDir);
+    const absoluteSkillPath = resolvePathInsideRoot(rootDir, candidate.skillPath);
+    const reviewManifestPath = buildReviewManifestPath(candidate.skillPath);
+    const absoluteReviewManifestPath = resolvePathInsideRoot(rootDir, reviewManifestPath);
+    const writeFlag = options.overwrite ? 'w' : 'wx';
+    const reviewManifest = buildResearchScriptSkillCandidateReviewManifest(candidate, options.generatedAt);
+    await Promise.all([
+        fs.mkdir(path.dirname(absoluteSkillPath), { recursive: true }),
+        fs.mkdir(path.dirname(absoluteReviewManifestPath), { recursive: true }),
+    ]);
+    await Promise.all([
+        fs.writeFile(absoluteSkillPath, `${candidate.markdown.trimEnd()}\n`, {
+            encoding: 'utf8',
+            flag: writeFlag,
+        }),
+        fs.writeFile(absoluteReviewManifestPath, `${JSON.stringify(reviewManifest, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: writeFlag,
+        }),
+    ]);
+    return {
+        absoluteReviewManifestPath,
+        absoluteSkillPath,
+        candidateId: candidate.id,
+        eligible: candidate.eligible,
+        reviewManifest,
+        reviewManifestPath,
+        skillName: candidate.skillName,
+        skillPath: candidate.skillPath,
+    };
+}
+export async function readMaterializedResearchScriptSkillCandidate(candidatePath, options) {
+    const rootDir = path.resolve(options.rootDir);
+    const absoluteSkillPath = resolveCandidateSkillPath(rootDir, candidatePath);
+    const skillPath = toRootRelativePath(rootDir, absoluteSkillPath);
+    const absoluteReviewManifestPath = resolvePathInsideRoot(rootDir, buildReviewManifestPath(skillPath));
+    const [markdown, manifestRaw] = await Promise.all([
+        fs.readFile(absoluteSkillPath, 'utf8'),
+        fs.readFile(absoluteReviewManifestPath, 'utf8'),
+    ]);
+    const manifest = parseReviewManifest(manifestRaw);
+    return {
+        eligible: manifest.eligible,
+        id: manifest.candidateId,
+        kind: manifest.kind ?? 'research-script',
+        reason: extractMarkdownField(markdown, 'Reason') || reviewStatusReason(manifest),
+        skillName: manifest.skillName,
+        skillPath,
+        sourceJobId: manifest.sourceJobId,
+        sourceRunId: manifest.sourceRunId,
+        successfulRunCount: manifest.successfulRunCount,
+        title: extractMarkdownTitle(markdown) || `${manifest.skillName} skill candidate`,
+        toolSequence: manifest.toolSequence,
+        markdown,
+    };
+}
+export async function listMaterializedResearchScriptSkillCandidates(options) {
+    const rootDir = path.resolve(options.rootDir);
+    const skillRoot = normalizeSkillRoot(options.skillRoot ?? '.codebuddy/skill-candidates');
+    const absoluteSkillRoot = resolvePathInsideRoot(rootDir, skillRoot);
+    const reviewManifestPaths = await findReviewManifestPaths(absoluteSkillRoot);
+    const candidates = await Promise.all(reviewManifestPaths.map((reviewManifestPath) => readMaterializedResearchScriptSkillCandidate(path.dirname(reviewManifestPath), { rootDir })));
+    return candidates.sort((left, right) => left.skillName.localeCompare(right.skillName));
+}
+export async function listMaterializedResearchScriptSkillCandidatesWithInstallState(options) {
+    const rootDir = path.resolve(options.rootDir);
+    const candidates = await listMaterializedResearchScriptSkillCandidates(options);
+    const hub = buildWorkspaceSkillsHub(rootDir);
+    return candidates.map((candidate) => summarizeCandidateInstallState(candidate, hub));
+}
+export async function readMaterializedResearchScriptSkillCandidateWithInstallState(candidatePath, options) {
+    const rootDir = path.resolve(options.rootDir);
+    const candidate = await readMaterializedResearchScriptSkillCandidate(candidatePath, { rootDir });
+    return summarizeCandidateInstallState(candidate, buildWorkspaceSkillsHub(rootDir));
+}
+export async function installResearchScriptSkillCandidate(candidate, options) {
+    if (!candidate.eligible) {
+        throw new Error(`${formatCandidateKind(candidate)} skill candidate is not eligible for install: ${candidate.reason}`);
+    }
+    const approvedBy = normalizeApproval(options.approvedBy);
+    if (!approvedBy) {
+        throw new Error(`Human approval is required before installing a ${formatCandidateKind(candidate)} skill candidate.`);
+    }
+    const rootDir = path.resolve(options.rootDir);
+    const sourceCandidatePath = candidate.skillPath;
+    const absoluteCandidatePath = resolvePathInsideRoot(rootDir, sourceCandidatePath);
+    const installedPath = buildWorkspaceSkillPath(candidate.skillName, options.workspaceSkillRoot);
+    const absoluteInstalledPath = resolvePathInsideRoot(rootDir, installedPath);
+    const approvedAt = normalizeCreatedAt(options.approvedAt);
+    let reviewedMarkdown = '';
+    try {
+        reviewedMarkdown = await fs.readFile(absoluteCandidatePath, 'utf8');
+    }
+    catch {
+        throw new Error(`Materialized candidate not found: ${sourceCandidatePath}`);
+    }
+    const installMarkdown = renderApprovedSkillMarkdown({ ...candidate, markdown: reviewedMarkdown }, approvedBy, approvedAt);
+    const parsedSkill = parseSkillFile(installMarkdown, installedPath, 'workspace');
+    const validation = validateSkill(parsedSkill);
+    if (!validation.valid) {
+        throw new Error(`Research script skill candidate is not a valid SKILL.md: ${validation.errors.join(', ')}`);
+    }
+    await fs.mkdir(path.dirname(absoluteInstalledPath), { recursive: true });
+    await fs.writeFile(absoluteInstalledPath, installMarkdown, {
+        encoding: 'utf8',
+        flag: options.overwrite ? 'w' : 'wx',
+    });
+    buildWorkspaceSkillsHub(rootDir).registerLocalSkillFile(candidate.skillName, absoluteInstalledPath);
+    getSkillsHub().registerLocalSkillFile(candidate.skillName, absoluteInstalledPath);
+    return {
+        absoluteInstalledPath,
+        approvedAt,
+        approvedBy,
+        candidateId: candidate.id,
+        installedPath,
+        skillName: candidate.skillName,
+        sourceCandidatePath,
+    };
+}
+function renderResearchScriptSkillCandidateMarkdown(job, successfulRuns, candidate) {
+    const lines = [
+        '---',
+        `name: ${candidate.skillName}`,
+        'version: 0.1.0',
+        `description: Reusable workflow candidate promoted from ${job.title}.`,
+        'tags: [research-script, generated-candidate, public-data]',
+        '---',
+        '',
+        `# ${candidate.title}`,
+        '',
+        `Status: ${candidate.eligible ? 'eligible for human review' : 'not eligible yet'}`,
+        `Reason: ${candidate.reason}`,
+        `Source job: ${candidate.sourceJobId}`,
+        `Successful runs: ${candidate.successfulRunCount}`,
+        '',
+        '## Use When',
+        `- ${job.goal}`,
+        '- The operator wants a repeatable public-data workflow with saved artifacts.',
+        '- The task can follow the same input/output contract and sandbox policy.',
+        '',
+        '## Do Not Use When',
+        '- The task would bypass login walls, paywalls, captcha, rate limits, or access controls.',
+        '- The workflow would send emails, submit forms, call phone numbers, or contact leads automatically.',
+        '- The data source is private, personal, or outside the declared public-data scope.',
+        '',
+        '## Input Contract',
+        ...recordLines(job.inputContract),
+        '',
+        '## Output Contract',
+        ...recordLines(job.outputContract),
+        '',
+        '## Sandbox Policy',
+        `- Provider: ${job.sandboxPolicy.provider}`,
+        `- Network: ${job.sandboxPolicy.network}`,
+        `- Writes: ${job.sandboxPolicy.writes}`,
+        `- Timeout: ${job.sandboxPolicy.timeoutMs}ms`,
+        `- Page budget: ${job.sandboxPolicy.pageBudget}`,
+        `- Stop on: ${job.sandboxPolicy.stopOn.join(', ')}`,
+        '',
+        '## Successful Run Evidence',
+        ...successfulRuns.map((run) => `- ${run.jobId}: output ${run.outputPath}, summary ${run.summaryPath}, duration ${run.durationMs}ms`),
+        '',
+        '## Candidate Installation Notes',
+        `- Review and edit this candidate before copying it to ${candidate.skillPath}.`,
+        `- Keep the original script manifest at ${job.files.manifest} linked from the final skill docs.`,
+        '- Preserve the no-contact-action assertion unless a human explicitly changes the workflow boundary.',
+        '',
+    ];
+    return lines.join('\n');
+}
+function buildResearchScriptSkillCandidateReviewManifest(candidate, generatedAt) {
+    return {
+        approvalRequired: true,
+        candidateId: candidate.id,
+        eligible: candidate.eligible,
+        generatedAt: normalizeCreatedAt(generatedAt),
+        kind: 'research-script',
+        schemaVersion: RESEARCH_SCRIPT_SKILL_CANDIDATE_REVIEW_SCHEMA_VERSION,
+        skillName: candidate.skillName,
+        sourceJobId: candidate.sourceJobId,
+        status: candidate.eligible ? 'awaiting_human_approval' : 'not_eligible',
+        successfulRunCount: candidate.successfulRunCount,
+    };
+}
+function renderApprovedSkillMarkdown(candidate, approvedBy, approvedAt) {
+    return [
+        candidate.markdown.trimEnd(),
+        '',
+        '## Human Approval',
+        `- Candidate id: ${candidate.id}`,
+        candidate.sourceRunId
+            ? `- Source run: ${candidate.sourceRunId}`
+            : `- Source job: ${candidate.sourceJobId}`,
+        `- Approved by: ${approvedBy}`,
+        `- Approved at: ${approvedAt}`,
+        '- Installation boundary: workspace skill; review before editing generated commands or source policies.',
+        '',
+    ].join('\n');
+}
+function buildReviewManifestPath(skillPath) {
+    return `${skillPath.replace(/\\/g, '/').replace(/\/?SKILL\.md$/i, '')}/candidate-review.json`;
+}
+function summarizeCandidateInstallState(candidate, hub) {
+    const candidateChecksum = computeChecksum(candidate.markdown);
+    const installedDetail = hub.info(candidate.skillName);
+    if (!installedDetail) {
+        return {
+            ...candidate,
+            candidateChecksum,
+            installState: 'not-installed',
+            reviewCommands: buildCandidateReviewCommands(candidate, 'not-installed'),
+        };
+    }
+    const { content, installed, integrityOk } = installedDetail;
+    if (typeof content !== 'string') {
+        return {
+            ...candidate,
+            candidateChecksum,
+            installState: 'installed-missing',
+            installedIntegrityOk: false,
+            installedPath: installed.path,
+            installedVersion: installed.version,
+            reviewCommands: buildCandidateReviewCommands(candidate, 'installed-missing'),
+        };
+    }
+    const installedChecksum = computeChecksum(content);
+    const installState = isInstalledFromCandidate(content, candidate.markdown)
+        ? 'installed-current'
+        : 'installed-different';
+    const candidateDiffPreview = installState === 'installed-different'
+        ? buildCandidateDiffPreview(candidate, content)
+        : undefined;
+    return {
+        ...candidate,
+        candidateChecksum,
+        ...(candidateDiffPreview ? { candidateDiffPreview } : {}),
+        installState,
+        installedChecksum,
+        installedIntegrityOk: integrityOk,
+        installedPath: installed.path,
+        installedVersion: installed.version,
+        reviewCommands: buildCandidateReviewCommands(candidate, installState),
+    };
+}
+function buildWorkspaceSkillsHub(rootDir) {
+    return new SkillsHub({
+        cacheDir: path.join(rootDir, '.codebuddy', 'skills-cache'),
+        lockfilePath: path.join(rootDir, '.codebuddy', 'skills-lock.json'),
+        skillsDir: path.join(rootDir, '.codebuddy', 'skills'),
+    });
+}
+function isInstalledFromCandidate(installedContent, candidateMarkdown) {
+    const candidateBody = candidateMarkdown.trimEnd();
+    const installedBody = installedContent.trimEnd();
+    return installedBody === candidateBody || installedBody.startsWith(`${candidateBody}\n\n## Human Approval`);
+}
+function buildCandidateDiffPreview(candidate, installedContent) {
+    const installedComparableContent = stripHumanApprovalSection(installedContent);
+    const diff = generateDiff(installedComparableContent.split('\n'), candidate.markdown.trimEnd().split('\n'), `${candidate.skillName}/SKILL.md`, {
+        contextLines: 2,
+        summaryPrefix: 'Candidate changes',
+    });
+    const linePreview = diff.diff
+        .split('\n')
+        .slice(0, SKILL_CANDIDATE_DIFF_PREVIEW_LINES)
+        .join('\n');
+    const preview = linePreview.slice(0, SKILL_CANDIDATE_DIFF_PREVIEW_CHARS);
+    return {
+        addedLines: diff.addedLines,
+        preview,
+        removedLines: diff.removedLines,
+        summary: diff.summary,
+        truncated: linePreview.length > preview.length || diff.diff.split('\n').length > SKILL_CANDIDATE_DIFF_PREVIEW_LINES,
+    };
+}
+function stripHumanApprovalSection(content) {
+    return content.trimEnd().replace(/\n\n## Human Approval\n[\s\S]*$/m, '');
+}
+function buildCandidateReviewCommands(candidate, installState) {
+    const commands = [
+        `skill_manage action=candidate_view candidate_path=${candidate.skillPath}`,
+    ];
+    if (!candidate.eligible) {
+        return commands;
+    }
+    if (installState === 'not-installed') {
+        return [
+            ...commands,
+            `skill_manage action=candidate_install candidate_path=${candidate.skillPath} approved_by=<reviewer>`,
+        ];
+    }
+    if (installState === 'installed-different') {
+        return [
+            ...commands,
+            `skill_manage action=candidate_install candidate_path=${candidate.skillPath} approved_by=<reviewer> overwrite=true`,
+            `skill_manage action=history name=${candidate.skillName}`,
+        ];
+    }
+    if (installState === 'installed-missing') {
+        return [
+            ...commands,
+            `skill_manage action=history name=${candidate.skillName}`,
+            `skill_manage action=rollback name=${candidate.skillName} approved_by=<reviewer>`,
+        ];
+    }
+    return [
+        ...commands,
+        `skill_manage action=view name=${candidate.skillName}`,
+    ];
+}
+function parseReviewManifest(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed.schemaVersion !== RESEARCH_SCRIPT_SKILL_CANDIDATE_REVIEW_SCHEMA_VERSION) {
+        throw new Error(`Unsupported research script skill candidate review schema: ${String(parsed.schemaVersion)}`);
+    }
+    if (parsed.approvalRequired !== true) {
+        throw new Error('Research script skill candidate review manifest must require approval.');
+    }
+    if (typeof parsed.candidateId !== 'string' || parsed.candidateId.trim().length === 0) {
+        throw new Error('Research script skill candidate review manifest is missing candidateId.');
+    }
+    if (typeof parsed.skillName !== 'string' || parsed.skillName.trim().length === 0) {
+        throw new Error('Research script skill candidate review manifest is missing skillName.');
+    }
+    const base = {
+        approvalRequired: true,
+        candidateId: parsed.candidateId.trim(),
+        generatedAt: typeof parsed.generatedAt === 'string' ? parsed.generatedAt : '',
+        schemaVersion: RESEARCH_SCRIPT_SKILL_CANDIDATE_REVIEW_SCHEMA_VERSION,
+        skillName: parsed.skillName.trim(),
+    };
+    if (typeof parsed.sourceRunId === 'string' && parsed.sourceRunId.trim().length > 0) {
+        const successfulRunCount = typeof parsed.successfulRunCount === 'number' && Number.isFinite(parsed.successfulRunCount)
+            ? Math.trunc(parsed.successfulRunCount)
+            : 1;
+        const eligible = parsed.eligible === true &&
+            parsed.status === 'awaiting_human_approval' &&
+            successfulRunCount >= LEARNING_SKILL_CANDIDATE_MIN_SUCCESSFUL_RUNS;
+        return {
+            ...base,
+            eligible,
+            kind: 'learning',
+            sourceJobId: '',
+            sourceRunId: parsed.sourceRunId.trim(),
+            status: eligible ? 'awaiting_human_approval' : 'not_eligible',
+            successfulRunCount,
+            toolSequence: normalizeToolSequence(parsed.toolSequence),
+        };
+    }
+    if (typeof parsed.sourceJobId !== 'string' || parsed.sourceJobId.trim().length === 0) {
+        throw new Error('Skill candidate review manifest is missing sourceJobId or sourceRunId.');
+    }
+    if (typeof parsed.successfulRunCount !== 'number' || !Number.isFinite(parsed.successfulRunCount)) {
+        throw new Error('Research script skill candidate review manifest is missing successfulRunCount.');
+    }
+    if (typeof parsed.eligible !== 'boolean') {
+        throw new Error('Research script skill candidate review manifest is missing eligible.');
+    }
+    return {
+        ...base,
+        eligible: parsed.eligible,
+        kind: 'research-script',
+        sourceJobId: parsed.sourceJobId.trim(),
+        status: parsed.eligible ? 'awaiting_human_approval' : 'not_eligible',
+        successfulRunCount: Math.trunc(parsed.successfulRunCount),
+    };
+}
+async function findReviewManifestPaths(absoluteDirectory) {
+    let entries;
+    try {
+        entries = await fs.readdir(absoluteDirectory, { withFileTypes: true });
+    }
+    catch (error) {
+        if (typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+    const reviewManifestPaths = [];
+    for (const entry of entries) {
+        const absoluteEntryPath = path.join(absoluteDirectory, entry.name);
+        if (entry.isDirectory()) {
+            reviewManifestPaths.push(...await findReviewManifestPaths(absoluteEntryPath));
+        }
+        else if (entry.isFile() && entry.name === 'candidate-review.json') {
+            reviewManifestPaths.push(absoluteEntryPath);
+        }
+    }
+    return reviewManifestPaths;
+}
+function reviewStatusReason(manifest) {
+    if (manifest.kind === 'learning' && manifest.sourceRunId) {
+        return manifest.eligible
+            ? `Learning Agent candidate from run ${manifest.sourceRunId} is awaiting human approval.`
+            : `Learning Agent candidate from run ${manifest.sourceRunId} is not eligible yet.`;
+    }
+    return manifest.eligible
+        ? `${manifest.successfulRunCount} successful runs met the promotion threshold.`
+        : `${manifest.successfulRunCount} successful runs; candidate is not eligible yet.`;
+}
+function normalizeToolSequence(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const sequence = value
+        .map((item) => typeof item === 'string' ? item.trim() : '')
+        .filter(Boolean);
+    return sequence.length > 0 ? sequence : undefined;
+}
+function formatCandidateKind(candidate) {
+    return candidate.kind === 'learning' ? 'Learning Agent' : 'research script';
+}
+function extractMarkdownTitle(markdown) {
+    return markdown.match(/^#\s+(.+)$/m)?.[1]?.trim() ?? '';
+}
+function extractMarkdownField(markdown, fieldName) {
+    const escaped = fieldName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return markdown.match(new RegExp(`^${escaped}:\\s*(.+)$`, 'm'))?.[1]?.trim() ?? '';
+}
+function buildWorkspaceSkillPath(skillName, workspaceSkillRoot) {
+    const root = normalizeSkillRoot(workspaceSkillRoot ?? '.codebuddy/skills');
+    return `${root}/${skillName}/SKILL.md`;
+}
+function recordLines(record) {
+    const entries = Object.entries(record);
+    if (entries.length === 0) {
+        return ['- none'];
+    }
+    return entries.map(([key, value]) => `- ${key}: ${value}`);
+}
+function normalizeMinSuccessfulRuns(value) {
+    if (!Number.isFinite(value)) {
+        return 2;
+    }
+    return Math.min(10, Math.max(1, Math.trunc(value)));
+}
+function normalizeSkillRoot(value) {
+    return value?.trim().replace(/\\/g, '/').replace(/\/+$/g, '') || '.codebuddy/skill-candidates';
+}
+function normalizeApproval(value) {
+    return typeof value === 'string' ? value.trim().replace(/\s+/g, ' ') : '';
+}
+function resolvePathInsideRoot(rootDir, relativePath) {
+    const resolvedRoot = path.resolve(rootDir);
+    const resolvedPath = path.resolve(resolvedRoot, normalizeRelativePath(relativePath));
+    assertPathInsideRoot(resolvedRoot, resolvedPath, relativePath);
+    return resolvedPath;
+}
+function resolveCandidateSkillPath(rootDir, candidatePath) {
+    const resolvedRoot = path.resolve(rootDir);
+    const candidateSkillPath = candidatePath.trim().replace(/\\/g, '/').endsWith('/SKILL.md')
+        ? candidatePath
+        : path.join(candidatePath, 'SKILL.md');
+    const resolvedPath = path.isAbsolute(candidateSkillPath)
+        ? path.resolve(candidateSkillPath)
+        : path.resolve(resolvedRoot, normalizeRelativePath(candidateSkillPath));
+    assertPathInsideRoot(resolvedRoot, resolvedPath, candidatePath);
+    return resolvedPath;
+}
+function assertPathInsideRoot(rootDir, absolutePath, originalPath) {
+    const normalizedRoot = normalizeForCompare(path.resolve(rootDir));
+    const normalizedPath = normalizeForCompare(path.resolve(absolutePath));
+    if (normalizedPath !== normalizedRoot && !normalizedPath.startsWith(`${normalizedRoot}${path.sep}`)) {
+        throw new Error(`Research script skill candidate path escapes root: ${originalPath}`);
+    }
+}
+function toRootRelativePath(rootDir, absolutePath) {
+    return path.relative(path.resolve(rootDir), absolutePath).replace(/\\/g, '/');
+}
+function normalizeRelativePath(value) {
+    return value
+        .trim()
+        .replace(/\\/g, '/')
+        .replace(/^\/+/, '')
+        .replace(/\/+/g, '/');
+}
+function normalizeForCompare(value) {
+    return process.platform === 'win32' ? value.toLowerCase() : value;
+}
+function normalizeCreatedAt(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'number' && Number.isFinite(value))
+        return new Date(value).toISOString();
+    if (typeof value === 'string' && value.trim())
+        return value.trim();
+    return new Date().toISOString();
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '') || 'script';
+}
+function stableHash(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index++) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36).padStart(7, '0');
+}
+//# sourceMappingURL=research-script-skill-candidate.js.map

package/dist/agent/research-script-skill-candidate.js.map

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

package/dist/agent/scope-awareness.d.ts

@@ -0,0 +1,19 @@
+import { CodeBuddyClient } from '../codebuddy/client.js';
+import { AgenticCodingTaskContract } from './autonomous/agentic-coding-contract.js';
+export interface RepoRules {
+    agentsMd?: string;
+    colabMd?: string;
+    claudeMd?: string;
+    readme?: string;
+    preexistingChanges: string[];
+}
+export interface ScopeVerdict {
+    allowed: boolean;
+    reason: string;
+    facts: string[];
+    inferences: string[];
+}
+export type ScopeEvaluationResult = ScopeVerdict;
+export declare function loadRepoRules(repo: string): Promise<RepoRules>;
+export declare function evaluateScope(rules: RepoRules, contract: AgenticCodingTaskContract): ScopeVerdict;
+export declare function evaluateScope(contract: AgenticCodingTaskContract, customClient?: CodeBuddyClient): Promise<ScopeVerdict>;