@sentry/warden 0.22.0 → 0.24.0

package/dist/skill-builder/outline.js

@@ -0,0 +1,345 @@
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { basename } from 'node:path';
+import { getRuntime } from '../sdk/runtimes/index.js';
+import { runStructuredSkillBuilderAgent, StructuredSkillBuilderAgentError } from './agentic.js';
+import { GENERATED_SKILL_DEFINITION_FILE, loadGeneratedSkillDefinition, readGeneratedSkillArtifactFiles, } from './definition.js';
+import { SKILL_BUILD_OUTLINE_SCHEMA_VERSION, SKILL_BUILD_VERSION, SkillBuildOutlineSchema, } from './outline-contract.js';
+import { getBuildStatePath, readSkillBuildState, SKILL_BUILD_STATE_KIND, SKILL_BUILD_STATE_SCHEMA_VERSION, writeSkillBuildState, } from './outline-state.js';
+export { outlineHash, SKILL_BUILD_OUTLINE_SCHEMA_VERSION, SKILL_BUILD_VERSION, SkillBuildOutlineSchema } from './outline-contract.js';
+export const SKILL_BUILD_MAX_TOKENS = 64_000;
+export const SKILL_BUILD_TIMEOUT_MS = 180_000;
+export const SKILL_BUILD_MAX_TURNS = 80;
+export class SkillBuildOutlineError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'SkillBuildOutlineError';
+    }
+}
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function sourceBlocks(source) {
+    return source.files
+        .map((file) => `## ${file.path}\n\n${file.content}`)
+        .join('\n\n---\n\n');
+}
+function buildSkillSource(skillName, files) {
+    const hash = sha256(JSON.stringify({
+        skill: skillName,
+        files,
+    }));
+    return { hash, files };
+}
+function generatedSkillDefinitionSourceFile(skill) {
+    if (skill.rootDir) {
+        const { content } = loadGeneratedSkillDefinition(skill.rootDir);
+        return { path: GENERATED_SKILL_DEFINITION_FILE, content };
+    }
+    return {
+        path: GENERATED_SKILL_DEFINITION_FILE,
+        content: `version: 1\nkind: generated-skill\nname: ${skill.name}\nprompt: ${JSON.stringify(skill.prompt)}\n`,
+    };
+}
+export function collectSkillBuildSource(skill) {
+    const files = [];
+    files.push(generatedSkillDefinitionSourceFile(skill));
+    return buildSkillSource(skill.name, files);
+}
+/** Collect the improvement brief and current artifacts as source material. */
+export function collectSkillImproveSource(skill, improvementPrompt) {
+    const files = [
+        generatedSkillDefinitionSourceFile(skill),
+        {
+            path: 'improvement-brief.md',
+            content: improvementPrompt.trim(),
+        },
+    ];
+    if (skill.rootDir) {
+        files.push(...readGeneratedSkillArtifactFiles(skill.rootDir).map((file) => ({
+            path: `current-artifacts/${file.path}`,
+            content: file.content,
+        })));
+    }
+    return buildSkillSource(skill.name, files);
+}
+function validateOutlineIdentity(outline, skillName, sourceHash) {
+    if (outline.skill !== skillName) {
+        throw new SkillBuildOutlineError(`Generated skill outline mismatch: expected ${skillName}, got ${outline.skill}`);
+    }
+    if (outline.sourceHash !== sourceHash) {
+        throw new SkillBuildOutlineError(`Generated skill outline source hash mismatch for ${skillName}. Regenerate the skill.`);
+    }
+    if (outline.buildVersion !== SKILL_BUILD_VERSION) {
+        throw new SkillBuildOutlineError(`Generated skill outline version mismatch for ${skillName}. Regenerate the skill.`);
+    }
+}
+function validateStateIdentity(state, model) {
+    if (state.identity?.requestedModel !== model) {
+        throw new SkillBuildOutlineError(`Generated skill model mismatch. Expected ${model ?? 'default'}, got ${state.identity?.requestedModel ?? 'default'}. Regenerate the skill.`);
+    }
+}
+function renderPreviousOutlineContinuity(previousOutline) {
+    if (!previousOutline || previousOutline.tracks.length === 0) {
+        return '';
+    }
+    const previousTracks = previousOutline.tracks.map((track) => ({
+        id: track.id,
+        title: track.title,
+        goal: track.goal,
+    }));
+    return `
+
+Existing track continuity:
+- Reuse an existing track id exactly when the same concern still exists after regeneration.
+- Only create a new track id when a concern is genuinely new.
+- If one previous track splits into multiple tracks, keep the previous id on the primary surviving concern and mint new ids only for the new sibling concerns.
+- If multiple previous tracks merge, keep the id of the track whose concern remains primary.
+- Do not rename tracks casually. Stable ids help compare authoring plans across regenerations.
+
+Previous track set:
+${JSON.stringify(previousTracks, null, 2)}`;
+}
+function buildOutlinePrompt(skill, source, previousOutline) {
+    return `You build the internal outline for one repo-local Warden skill.
+
+This outline exists only to give Warden context for a later authoring-provider run. It is planning metadata, not a runnable skill, and it does not prescribe the final artifact layout.
+
+Rules:
+- Return only a JSON object. No markdown, prose, or code fences.
+- Use version ${SKILL_BUILD_OUTLINE_SCHEMA_VERSION}.
+- Use skill "${skill.name}".
+- Use sourceHash "${source.hash}" exactly.
+- Use buildVersion "${SKILL_BUILD_VERSION}" exactly.
+- First determine what kind of skill this is: domain, ecosystem, repository, or product.
+- First determine the full agenda implied by the prompt, metadata contract, and source material. The track set exists only to accomplish that agenda completely.
+- Split by analysis concern, not file type, severity, or implementation phase.
+- Track count is unconstrained. Use as many or as few tracks as needed to fit the agenda cleanly.
+- If one track can carry the agenda without becoming vague or overloaded, one track is correct.
+- If the agenda requires many focused tracks to avoid overlap or shallow work, many tracks are correct.
+- The important constraint is scope fit: each track should be small enough to support deep, coherent execution, and the full track set should accomplish the entire agenda without gaps or duplicate ownership.
+- Each track must have an id, title, goal, rationale, sourceSignals, owns, excludes, relevanceSignals, evidenceFocus, checks, safeCounterpatterns, falsePositiveTraps, and researchHints.
+- Track ids must be lowercase kebab-case.
+- The outline should stay lean. Do not write runnable prompts here.
+- scopeProfile.subject should describe the generated skill, not the repo name alone.
+- scopeProfile.observedContext should capture the concrete context that shaped the track split:
+  - for repository or product skills, include the stack, runtime, notable trust boundaries, and important repo-local surfaces you actually observed
+  - for domain or ecosystem skills, include the supplied source material, intended platform, and any explicit coverage boundaries
+- scopeProfile.unresolvedContext is only for context that would materially improve decomposition and was not inferable from the provided sources.
+- Do not list obvious context as unresolved when it is already visible in the source material.
+- Treat each track as a concise analysis concern that the authoring provider may use, merge, split, or inline while producing the final skill:
+  - goal: the one-line investigation objective
+  - rationale: why this track exists for this skill
+  - sourceSignals: the context signals that justified this track
+  - owns: the primary concerns this track is responsible for
+  - excludes: the sibling concerns or boundaries this track must not absorb
+  - relevanceSignals: the file, hunk, or behavioral cues that should make the runtime skill pick this track
+  - evidenceFocus: what concrete evidence the runtime skill must require
+  - checks: a short ordered task set of concrete investigation steps or questions for this track
+  - safeCounterpatterns: concrete safe patterns, mitigations, or boundary conditions that should suppress weak findings
+  - falsePositiveTraps: the common shallow misreads, sibling overlaps, or pattern-only claims that this track must avoid
+  - researchHints: public docs, runtime topics, or prior-art areas the generated reference may need to consult
+- Keep track fields short and specific. If a field starts reading like a long prompt, you are adding bloat to the outline.
+- Do not put trigger-language, long remediation playbooks, or essay-length false-positive controls into the outline.
+- When one code path could create chained risks across tracks, assign one primary owning track and make the other tracks exclude that ownership boundary instead of competing for the same finding.
+- Boundary rules should be written from this track's perspective: say what this track owns and what it must not report.
+- If the source material is too thin for a safe decomposition, make that explicit inside scopeProfile.unresolvedContext or the relevant track fields. Do not silently invent coverage areas.
+- Do not ask follow-up questions or return prose. If context is missing, still return valid JSON and record it in scopeProfile.unresolvedContext or the relevant track fields.
+- Keep all track guidance compatible with Warden's normal hunk analysis model: concerns must be focused, inspectable, and able to return an empty findings array when evidence is insufficient.
+- If the skill is intentionally generic, keep it generic. Depth must come from concrete checks, relevance signals, safe counterpatterns, falsePositiveTraps, and researchHints, not fake repo specificity.
+
+JSON shape:
+{
+  "version": ${SKILL_BUILD_OUTLINE_SCHEMA_VERSION},
+  "skill": "${skill.name}",
+  "sourceHash": "${source.hash}",
+  "buildVersion": "${SKILL_BUILD_VERSION}",
+  "scopeProfile": {
+    "kind": "repository",
+    "subject": "Code review for this repo's CLI and runtime surfaces",
+    "localContextUsed": true,
+    "observedContext": [
+      "Node.js and TypeScript runtime",
+      "CLI orchestration and subprocess execution",
+      "GitHub workflow and token boundaries"
+    ],
+    "unresolvedContext": ["Production deployment boundary, if it materially affects decomposition"]
+  },
+  "build": {
+    "phases": [
+      {"id": "collect-inputs", "status": "generated"},
+      {"id": "assess-source-depth", "status": "generated"},
+      {"id": "identify-research-needs", "status": "generated"},
+      {"id": "build-tracks", "status": "generated"},
+      {"id": "validate-coverage", "status": "validated"}
+    ],
+    "externalSources": [
+      {"title": "Public source title", "url": "https://example.com/source", "reason": "Why this source informed the decomposition"}
+    ]
+  },
+  "tracks": [
+    {
+      "id": "example-track",
+      "title": "Example track",
+      "goal": "One-line investigation objective.",
+      "rationale": "Why this track exists for this skill.",
+      "sourceSignals": ["Observed context or source signal that justified this track"],
+      "owns": ["Primary concern this track is responsible for"],
+      "excludes": ["Sibling concern or boundary this track must not report"],
+      "relevanceSignals": ["Cue that should make the runtime skill choose this track"],
+      "evidenceFocus": ["Concrete evidence the runtime skill must require"],
+      "checks": ["Ordered investigation step or question for this track"],
+      "safeCounterpatterns": ["Concrete safe pattern or mitigation that should suppress weak reporting"],
+      "falsePositiveTraps": ["Common shallow misread or sibling overlap this track must avoid"],
+      "researchHints": ["Public runtime or ecosystem topic the generated reference may need to consult"]
+    }
+  ]
+}
+
+Quality bar:
+- The outline should fully accomplish the agenda implied by the prompt, metadata, and source material. Do not optimize for a preferred number of tracks.
+- The track set should be specific enough that one generated skill can route work clearly and avoid duplicate reports.
+- Each track should have the right amount of work for one coherent investigation track: not so broad that it becomes shallow, and not so narrow that the split becomes busywork.
+- The checks should be specific enough that the authoring provider can turn them into executable runtime guidance without inventing the structure again.
+- The track set should give later build steps enough depth hooks to expand into strong references: relevanceSignals, safeCounterpatterns, falsePositiveTraps, and researchHints should be concrete instead of generic filler.
+- Repository or product skills must reflect the local context actually observed. Domain or ecosystem skills must say they are generic and stay aligned with the supplied scope.
+
+Skill description:
+${skill.description}
+${renderPreviousOutlineContinuity(previousOutline)}
+
+Source material:
+
+${sourceBlocks(source)}`;
+}
+function buildOutlineSystemPrompt() {
+    return `You build the internal outline for one generated Warden skill.
+
+Use Read, Grep, and Glob to inspect relevant repository source before deciding how to decompose the skill when local context is needed. Use WebSearch or WebFetch for public prior art and current external documentation when framework, runtime, risk class, or ecosystem behavior affects the outline.
+
+Do not send repository code, secrets, private file paths, or proprietary details to web tools. Use public framework, package, API, risk class, and documentation names only.
+
+Return only the strict JSON object requested by the user prompt. Never return prose or follow-up questions.`;
+}
+function parseCachedOutline(statePath, skillName, sourceHash, model) {
+    const state = readSkillBuildState(statePath);
+    if (!state) {
+        return undefined;
+    }
+    try {
+        validateOutlineIdentity(state.outline, skillName, sourceHash);
+        validateStateIdentity(state, model);
+        return state;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function buildSkillOutline(options) {
+    const { skill, apiKey, model, maxRetries, regenerate = false } = options;
+    const runtime = options.runtime ?? getRuntime(options.runtimeName ?? 'claude');
+    const source = options.source ?? collectSkillBuildSource(skill);
+    const rootDir = skill.rootDir;
+    if (!rootDir) {
+        throw new SkillBuildOutlineError(`Generated skill ${skill.name} is missing a root directory`);
+    }
+    const statePath = getBuildStatePath(rootDir);
+    if (existsSync(statePath) && !regenerate) {
+        const state = parseCachedOutline(statePath, skill.name, source.hash, model);
+        if (state) {
+            return {
+                outline: state.outline,
+                source: 'cache',
+                statePath,
+                usage: state.outlineRun?.usage,
+                durationMs: state.outlineRun?.durationMs,
+                responseModel: state.outlineRun?.responseModel,
+                numTurns: state.outlineRun?.numTurns,
+            };
+        }
+    }
+    if (options.repoPath) {
+        try {
+            options.onStatus?.('Inspecting source material');
+            const result = await runStructuredSkillBuilderAgent({
+                runtime,
+                repoPath: options.repoPath,
+                skillName: `${skill.name}:skill-outline`,
+                systemPrompt: buildOutlineSystemPrompt(),
+                userPrompt: buildOutlinePrompt(skill, source, options.previousOutline),
+                schema: SkillBuildOutlineSchema,
+                model,
+                maxTurns: options.maxTurns ?? SKILL_BUILD_MAX_TURNS,
+                abortController: options.abortController,
+                repair: {
+                    apiKey,
+                    model: options.repairModel,
+                    maxRetries: options.repairMaxRetries ?? maxRetries,
+                },
+            });
+            validateOutlineIdentity(result.data, skill.name, source.hash);
+            writeSkillBuildState(statePath, {
+                version: SKILL_BUILD_STATE_SCHEMA_VERSION,
+                kind: SKILL_BUILD_STATE_KIND,
+                identity: model ? { requestedModel: model } : undefined,
+                outline: result.data,
+                outlineRun: {
+                    usage: result.usage,
+                    durationMs: result.durationMs,
+                    responseModel: result.responseModel,
+                    numTurns: result.numTurns,
+                },
+                updatedAt: new Date().toISOString(),
+            });
+            return {
+                outline: result.data,
+                source: 'generated',
+                statePath,
+                usage: result.usage,
+                durationMs: result.durationMs,
+                responseModel: result.responseModel,
+                numTurns: result.numTurns,
+            };
+        }
+        catch (error) {
+            if (error instanceof StructuredSkillBuilderAgentError) {
+                throw new SkillBuildOutlineError(`Skill outline build failed: ${error.message}`, { cause: error });
+            }
+            throw error;
+        }
+    }
+    const result = await runtime.runSynthesis({
+        task: 'skill_build',
+        apiKey,
+        prompt: buildOutlinePrompt(skill, source, options.previousOutline),
+        schema: SkillBuildOutlineSchema,
+        model,
+        maxTokens: SKILL_BUILD_MAX_TOKENS,
+        timeout: SKILL_BUILD_TIMEOUT_MS,
+        maxRetries,
+    });
+    if (!result.success) {
+        throw new SkillBuildOutlineError(`Skill outline build failed: ${result.error}`);
+    }
+    validateOutlineIdentity(result.data, skill.name, source.hash);
+    writeSkillBuildState(statePath, {
+        version: SKILL_BUILD_STATE_SCHEMA_VERSION,
+        kind: SKILL_BUILD_STATE_KIND,
+        identity: model ? { requestedModel: model } : undefined,
+        outline: result.data,
+        outlineRun: {
+            usage: result.usage,
+        },
+        updatedAt: new Date().toISOString(),
+    });
+    return {
+        outline: result.data,
+        source: 'generated',
+        statePath,
+        usage: result.usage,
+    };
+}
+export function defaultOutlineExportPath(skillName) {
+    return `${basename(skillName)}-outline.json`;
+}
+//# sourceMappingURL=outline.js.map

package/dist/skill-builder/outline.js.map

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

package/dist/skill-builder/skill-contract.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import type { UsageStats } from '../types/index.js';
+export interface SkillBuildExternalSource {
+    title: string;
+    url: string;
+    reason: string;
+}
+export interface SkillBuildAuthoringProvider {
+    name: string;
+    rootDir: string;
+    contentHash: string;
+}
+export type GeneratedSkillAuthoringMode = 'build' | 'improve';
+export declare const GeneratedSkillAuthoringPlanSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    summary: z.ZodString;
+    workflow: z.ZodArray<z.ZodString>;
+    researchPlan: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceDecisions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        decision: z.ZodString;
+        implication: z.ZodString;
+    }, z.core.$strict>>>;
+    lookupQuestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        openWhen: z.ZodString;
+        requiredEvidence: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    qualityBar: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    artifactPlan: z.ZodArray<z.ZodString>;
+    validationPlan: z.ZodArray<z.ZodString>;
+    risks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    missingInputs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    externalSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type GeneratedSkillAuthoringPlan = z.infer<typeof GeneratedSkillAuthoringPlanSchema>;
+export declare const GeneratedSkillWriterResultSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    summary: z.ZodString;
+    validationNotes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    missingInputs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    externalSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strip>;
+export type GeneratedSkillWriterResult = z.infer<typeof GeneratedSkillWriterResultSchema>;
+export declare const GeneratedSkillReviewIssueSchema: z.ZodObject<{
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    path: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    suggestedFix: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const GeneratedSkillReviewResultSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    valid: z.ZodBoolean;
+    summary: z.ZodString;
+    issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        path: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        suggestedFix: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    missingInputs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type GeneratedSkillReviewResult = z.infer<typeof GeneratedSkillReviewResultSchema>;
+export interface GeneratedSkillArtifact {
+    kind: 'generated-skill';
+    source: 'cache' | 'generated';
+    name: string;
+    path: string;
+    bytes: number;
+    durationMs: number;
+    usage: UsageStats;
+    externalSources: SkillBuildExternalSource[];
+    missingInputs: string[];
+    warnings: string[];
+    responseModel?: string;
+    numTurns?: number;
+}
+export declare class GeneratedSkillBuildError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=skill-contract.d.ts.map

package/dist/skill-builder/skill-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-contract.d.ts","sourceRoot":"","sources":["../../src/skill-builder/skill-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,SAAS,CAAC;AAW9D,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;kBAqBnC,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,gCAAgC;;;;;;;;;;iBAM3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,+BAA+B;;;;;;;;kBAKjC,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;kBAMlC,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/skill-builder/skill-contract.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+const SkillBuildExternalSourceSchema = z.object({
+    title: z.string().min(1),
+    url: z.string().min(1),
+    reason: z.string().min(1),
+}).strict();
+// The authoring plan is meant to describe semantic coverage, source depth,
+// ordered work, and review criteria. It must not become an artifact-layout
+// plan; the authoring skill owns artifact placement and routing choices.
+export const GeneratedSkillAuthoringPlanSchema = z.object({
+    version: z.literal(1),
+    summary: z.string().min(1),
+    workflow: z.array(z.string().min(1)).min(1),
+    researchPlan: z.array(z.string().min(1)).default([]),
+    sourceDecisions: z.array(z.object({
+        source: z.string().min(1),
+        decision: z.string().min(1),
+        implication: z.string().min(1),
+    }).strict()).default([]),
+    lookupQuestions: z.array(z.object({
+        question: z.string().min(1),
+        openWhen: z.string().min(1),
+        requiredEvidence: z.array(z.string().min(1)).min(1),
+    }).strict()).default([]),
+    qualityBar: z.array(z.string().min(1)).default([]),
+    artifactPlan: z.array(z.string().min(1)).min(1),
+    validationPlan: z.array(z.string().min(1)).min(1),
+    risks: z.array(z.string().min(1)).default([]),
+    missingInputs: z.array(z.string().min(1)).default([]),
+    externalSources: z.array(SkillBuildExternalSourceSchema).default([]),
+}).strict();
+export const GeneratedSkillWriterResultSchema = z.object({
+    version: z.literal(1),
+    summary: z.string().min(1),
+    validationNotes: z.array(z.string().min(1)).default([]),
+    missingInputs: z.array(z.string().min(1)).default([]),
+    externalSources: z.array(SkillBuildExternalSourceSchema).default([]),
+});
+export const GeneratedSkillReviewIssueSchema = z.object({
+    severity: z.enum(['error', 'warning']),
+    path: z.string().optional(),
+    message: z.string().min(1),
+    suggestedFix: z.string().optional(),
+}).strict();
+export const GeneratedSkillReviewResultSchema = z.object({
+    version: z.literal(1),
+    valid: z.boolean(),
+    summary: z.string().min(1),
+    issues: z.array(GeneratedSkillReviewIssueSchema).default([]),
+    missingInputs: z.array(z.string().min(1)).default([]),
+}).strict();
+export class GeneratedSkillBuildError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'GeneratedSkillBuildError';
+    }
+}
+//# sourceMappingURL=skill-contract.js.map

package/dist/skill-builder/skill-contract.js.map

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

package/dist/skill-builder/skill-prompts.d.ts

@@ -0,0 +1,61 @@
+import type { GeneratedSkillAuthoringPlan, GeneratedSkillAuthoringMode, GeneratedSkillReviewResult, SkillBuildExternalSource } from './skill-contract.js';
+import type { SkillBuildOutline, SkillBuildSource } from './outline-contract.js';
+interface GeneratedSkillArtifactSnapshot {
+    summary: string;
+    files: {
+        path: string;
+        content: string;
+    }[];
+    validationNotes: string[];
+    missingInputs: string[];
+    externalSources: SkillBuildExternalSource[];
+}
+export declare function defaultBuildMaxTurns(): number;
+export declare function defaultValidationMaxTurns(): number;
+export declare function authoringSystemPrompt(): string;
+export declare function buildAuthoringPlanPrompt(args: {
+    outline: SkillBuildOutline;
+    source: SkillBuildSource;
+    authoringSkillRoot: string;
+    targetName: string;
+    targetRootDir: string;
+    mode?: GeneratedSkillAuthoringMode;
+    improvementPrompt?: string;
+}): string;
+export declare function buildAuthoringImplementationPrompt(args: {
+    outline: SkillBuildOutline;
+    source: SkillBuildSource;
+    authoringSkillRoot: string;
+    targetName: string;
+    targetRootDir: string;
+    plan: GeneratedSkillAuthoringPlan;
+    mode?: GeneratedSkillAuthoringMode;
+    improvementPrompt?: string;
+}): string;
+export declare function buildAuthoringValidationPrompt(args: {
+    outline: SkillBuildOutline;
+    source: SkillBuildSource;
+    authoringSkillRoot: string;
+    targetName: string;
+    targetRootDir: string;
+    plan: GeneratedSkillAuthoringPlan;
+    artifact: GeneratedSkillArtifactSnapshot;
+    deterministicIssues: string[];
+    mode?: GeneratedSkillAuthoringMode;
+    improvementPrompt?: string;
+}): string;
+export declare function buildAuthoringRevisionPrompt(args: {
+    outline: SkillBuildOutline;
+    source: SkillBuildSource;
+    authoringSkillRoot: string;
+    targetName: string;
+    targetRootDir: string;
+    plan: GeneratedSkillAuthoringPlan;
+    artifact: GeneratedSkillArtifactSnapshot;
+    review: GeneratedSkillReviewResult;
+    deterministicIssues: string[];
+    mode?: GeneratedSkillAuthoringMode;
+    improvementPrompt?: string;
+}): string;
+export {};
+//# sourceMappingURL=skill-prompts.d.ts.map

package/dist/skill-builder/skill-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompts.d.ts","sourceRoot":"","sources":["../../src/skill-builder/skill-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKjF,UAAU,8BAA8B;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,wBAAwB,EAAE,CAAC;CAC7C;AAQD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AA0ED,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,2BAA2B,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAoDT;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,2BAA2B,CAAC;IAClC,IAAI,CAAC,EAAE,2BAA2B,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CA2CT;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE,8BAA8B,CAAC;IACzC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,2BAA2B,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAoDT;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE,8BAA8B,CAAC;IACzC,MAAM,EAAE,0BAA0B,CAAC;IACnC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,2BAA2B,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CAuDT"}