usesteady 0.1.0-alpha.1

package/dist/src/skills/types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * UseSteady Skills v1 — core types and interfaces.
+ *
+ * Architecture invariant: nothing in this file grants execution authority,
+ * tool access, policy override, or approval influence.
+ * All types here are metadata, schema contracts, and error/audit shapes only.
+ */
+/**
+ * The only valid skill kinds in v1. Each kind fires under a distinct condition
+ * and may only emit its matching output schema.
+ */
+export type SkillKind = 'interpretation' | 'workflow_generation' | 'recovery';
+export type SkillOutputSchema = 'usesteady.intent_candidates.v1' | 'usesteady.workflow_draft.v1' | 'usesteady.recovery_suggestions.v1';
+/**
+ * The only valid kind→schema combinations. Validator rejects any SKILL.md
+ * whose output_schema does not match this mapping exactly.
+ */
+export declare const KIND_SCHEMA_MAP: {
+    readonly interpretation: "usesteady.intent_candidates.v1";
+    readonly workflow_generation: "usesteady.workflow_draft.v1";
+    readonly recovery: "usesteady.recovery_suggestions.v1";
+};
+export declare const REQUIRED_BODY_SECTIONS: readonly ["Purpose", "When to use", "Output contract", "Guardrails", "Examples"];
+export type RequiredBodySection = (typeof REQUIRED_BODY_SECTIONS)[number];
+/**
+ * Parsed and validated YAML frontmatter from a SKILL.md file.
+ *
+ * Guardrail fields use literal types (true / false) rather than boolean so
+ * the TypeScript compiler rejects any code that tries to assign a computed
+ * boolean to them — drift is a compile-time error, not just a runtime check.
+ *
+ * exactOptionalPropertyTypes is active: risk_level?: string means the
+ * property may be absent, but when present it must be a string (never undefined).
+ */
+export interface SkillMetadata {
+    readonly name: string;
+    readonly description: string;
+    /** Semantic version string, e.g. "1.0.0". Validator checks parseability. */
+    readonly version: string;
+    readonly kind: SkillKind;
+    readonly triggers: readonly string[];
+    readonly output_schema: SkillOutputSchema;
+    readonly requires_review: true;
+    readonly can_execute: false;
+    readonly can_call_tools: false;
+    readonly can_bypass_policy: false;
+    readonly can_bypass_approval: false;
+    /** Optional human-readable risk label. Does not affect loader behaviour. */
+    readonly risk_level?: string;
+    /**
+     * Lower number = evaluated earlier within a kind. Default: 100.
+     * Range is not enforced; negative values are allowed for overrides.
+     */
+    readonly priority: number;
+}
+export interface Skill {
+    readonly metadata: SkillMetadata;
+    /** Full markdown body text after the closing --- of the frontmatter block. */
+    readonly body: string;
+    /** Absolute filesystem path to the SKILL.md file. Used in errors and audit. */
+    readonly sourcePath: string;
+}
+export interface LoadedSkillRegistry {
+    /**
+     * Skills grouped by kind and sorted by ascending priority within each group.
+     * All three kind keys are always present; arrays may be empty.
+     */
+    readonly byKind: Readonly<Record<SkillKind, readonly Skill[]>>;
+    /** Flat list of all loaded skills, in the same order as byKind iteration. */
+    readonly all: readonly Skill[];
+    /** Timestamp of when buildRegistry() completed successfully. */
+    readonly loadedAt: Date;
+}
+/** Minimal skill identity embedded in every output object. */
+export interface SkillRef {
+    readonly name: string;
+    readonly version: string;
+}
+export type IntentCandidateKind = 'create_dir' | 'create_file' | 'rename' | 'delete' | 'replace';
+interface IntentCandidateBase {
+    readonly kind: IntentCandidateKind;
+    /**
+     * 0–1 float. Advisory only.
+     * UseSteady does not use this value for allow/deny decisions.
+     */
+    readonly confidence: number;
+    /** Must name the specific signal in user input that justifies the candidate. */
+    readonly reason: string;
+}
+export interface CreateDirCandidate extends IntentCandidateBase {
+    readonly kind: 'create_dir';
+    readonly path: string;
+}
+export interface CreateFileCandidate extends IntentCandidateBase {
+    readonly kind: 'create_file';
+    readonly path: string;
+}
+export interface RenameCandidate extends IntentCandidateBase {
+    readonly kind: 'rename';
+    readonly from: string;
+    readonly to: string;
+}
+export interface DeleteCandidate extends IntentCandidateBase {
+    readonly kind: 'delete';
+    readonly path: string;
+}
+export interface ReplaceCandidate extends IntentCandidateBase {
+    readonly kind: 'replace';
+    readonly find: string;
+    readonly replace: string;
+    readonly file: string;
+}
+export type IntentCandidate = CreateDirCandidate | CreateFileCandidate | RenameCandidate | DeleteCandidate | ReplaceCandidate;
+export interface IntentCandidatesOutput {
+    readonly schema: 'usesteady.intent_candidates.v1';
+    readonly skill: SkillRef;
+    /** May be empty when no safe candidate can be determined — never fabricate. */
+    readonly candidates: readonly IntentCandidate[];
+}
+export interface WorkflowStep {
+    /**
+     * Exact phrase the user could type in the workflow builder.
+     * Must be independently validatable by the deterministic parser or an
+     * interpretation skill.
+     */
+    readonly input: string;
+    readonly reason: string;
+}
+export interface WorkflowDraftOutput {
+    readonly schema: 'usesteady.workflow_draft.v1';
+    readonly skill: SkillRef;
+    /** Human-readable label for the draft workflow. Empty string when steps is empty. */
+    readonly name: string;
+    /** May be empty when the request is too vague to decompose safely. */
+    readonly steps: readonly WorkflowStep[];
+}
+export interface RecoverySuggestion {
+    /** Exact phrase UseSteady can validate and execute as-is without modification. */
+    readonly input: string;
+    readonly reason: string;
+}
+export interface RecoverySuggestionsOutput {
+    readonly schema: 'usesteady.recovery_suggestions.v1';
+    readonly skill: SkillRef;
+    /** May be empty when no safe, explicit suggestion exists — never fabricate. */
+    readonly suggestions: readonly RecoverySuggestion[];
+}
+/** Discriminated union of all valid runtime skill outputs. */
+export type SkillOutput = IntentCandidatesOutput | WorkflowDraftOutput | RecoverySuggestionsOutput;
+/**
+ * A single structured issue emitted during parsing or validation.
+ * Carrying `type` as a literal union (rather than a free string) lets callers
+ * assert on exact failure reasons in tests without string-matching messages.
+ */
+export type SkillValidationIssue = {
+    readonly type: 'missing_field' | 'invalid_field' | 'schema_mismatch' | 'guardrail_violation' | 'invalid_kind' | 'invalid_yaml' | 'invalid_markdown' | 'unknown_error';
+    /**
+     * The frontmatter field name involved, when applicable.
+     * Absent (not undefined) when the issue is not field-specific.
+     */
+    readonly field?: string;
+    readonly message: string;
+};
+/**
+ * Thrown by the parser for YAML / markdown syntax errors and by the validator
+ * for spec constraint violations. Carries all issues found in a single pass
+ * rather than stopping at the first error.
+ */
+export declare class ValidationError extends Error {
+    readonly issues: readonly SkillValidationIssue[];
+    constructor(message: string, issues: readonly SkillValidationIssue[]);
+}
+export type SkillErrorCode = 'YAML_PARSE_FAILED' | 'MISSING_REQUIRED_FIELD' | 'INVALID_KIND' | 'SCHEMA_KIND_MISMATCH' | 'GUARDRAIL_VIOLATION' | 'MISSING_BODY_SECTION' | 'INVALID_VERSION' | 'FILE_NOT_FOUND' | 'SCAN_FAILED';
+export declare class SkillLoadError extends Error {
+    readonly code: SkillErrorCode;
+    readonly sourcePath: string;
+    constructor(code: SkillErrorCode, sourcePath: string, message: string);
+}
+/**
+ * Discriminated union so callers can narrow on `valid` and get either:
+ *   valid: true  → guaranteed typed SkillMetadata (no casts needed in loader)
+ *   valid: false → full structured issue list (all issues, not just the first)
+ *
+ * The old { valid: boolean; errors: string[] } shape was replaced because:
+ *   - tests need to assert on issue.type, not a string message
+ *   - the loader needs the typed metadata without re-casting unknown fields
+ *   - aggregating all issues in one pass requires a structured container
+ */
+export type SkillValidationResult = {
+    readonly valid: true;
+    readonly metadata: SkillMetadata;
+} | {
+    readonly valid: false;
+    readonly issues: readonly SkillValidationIssue[];
+};
+export type TriggerReason = {
+    readonly kind: 'interpretation';
+    /** Raw input the deterministic parser returned null for. */
+    readonly rawInput: string;
+} | {
+    readonly kind: 'workflow_generation';
+    /** Raw input containing an explicit broad or multi-step request. */
+    readonly rawInput: string;
+} | {
+    readonly kind: 'recovery';
+    readonly failureReason: 'unsupported' | 'blocked' | 'failed';
+    /** Raw input that produced the failure or block. */
+    readonly rawInput: string;
+};
+/**
+ * A complete, self-contained record of one skill invocation.
+ *
+ * Designed to be: serialisable (no functions, no cycles), forward-compatible
+ * with a persistence layer, and sufficient for full replay/debugging without
+ * re-querying the registry.
+ *
+ * exactOptionalPropertyTypes fields:
+ *   sourcePath?      — absent when the caller did not supply a source map
+ *   rejectionReason? — absent when validationOutcome === 'accepted'
+ */
+export interface SkillAuditRecord {
+    readonly skillName: string;
+    readonly skillVersion: string;
+    /** Absolute path to the SKILL.md file. Absent when the caller did not supply a source map. */
+    readonly sourcePath?: string;
+    readonly outputSchema: SkillOutputSchema;
+    /**
+     * The raw output the skill returned, or null if the skill could not be
+     * invoked or returned malformed output. Preserved even on schema rejection
+     * so the full adapter response is always in the audit trail.
+     */
+    readonly rawOutput: SkillOutput | null;
+    readonly validationOutcome: 'accepted' | 'rejected';
+    /** Absent when accepted. Present (as a non-undefined string) when rejected. */
+    readonly rejectionReason?: string;
+    readonly invokedAt: Date;
+    readonly triggerReason: TriggerReason;
+    /** The raw user input string that triggered this invocation. */
+    readonly rawInput: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/skills/types.d.ts.map

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

package/dist/src/skills/types.js

@@ -0,0 +1,50 @@
+/**
+ * UseSteady Skills v1 — core types and interfaces.
+ *
+ * Architecture invariant: nothing in this file grants execution authority,
+ * tool access, policy override, or approval influence.
+ * All types here are metadata, schema contracts, and error/audit shapes only.
+ */
+/**
+ * The only valid kind→schema combinations. Validator rejects any SKILL.md
+ * whose output_schema does not match this mapping exactly.
+ */
+export const KIND_SCHEMA_MAP = {
+    interpretation: 'usesteady.intent_candidates.v1',
+    workflow_generation: 'usesteady.workflow_draft.v1',
+    recovery: 'usesteady.recovery_suggestions.v1',
+};
+// ---------------------------------------------------------------------------
+// Required body sections — must all be present; order validated by scanner
+// ---------------------------------------------------------------------------
+export const REQUIRED_BODY_SECTIONS = [
+    'Purpose',
+    'When to use',
+    'Output contract',
+    'Guardrails',
+    'Examples',
+];
+/**
+ * Thrown by the parser for YAML / markdown syntax errors and by the validator
+ * for spec constraint violations. Carries all issues found in a single pass
+ * rather than stopping at the first error.
+ */
+export class ValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.name = 'ValidationError';
+        this.issues = issues;
+    }
+}
+export class SkillLoadError extends Error {
+    code;
+    sourcePath;
+    constructor(code, sourcePath, message) {
+        super(`[${code}] ${sourcePath}: ${message}`);
+        this.name = 'SkillLoadError';
+        this.code = code;
+        this.sourcePath = sourcePath;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAO,gCAAgC;IACrD,mBAAmB,EAAE,6BAA6B;IAClD,QAAQ,EAAa,mCAAmC;CACD,CAAC;AAE1D,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS;IACT,aAAa;IACb,iBAAiB;IACjB,YAAY;IACZ,UAAU;CACF,CAAC;AAqNX;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,MAAM,CAAkC;IAEjD,YAAY,OAAe,EAAE,MAAuC;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAiBD,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAiB;IACrB,UAAU,CAAS;IAE5B,YAAY,IAAoB,EAAE,UAAkB,EAAE,OAAe;QACnE,KAAK,CAAC,IAAI,IAAI,KAAK,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/skills/validator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * UseSteady Skills v1 — validator (file 3 of 8).
+ *
+ * Single responsibility: given the raw output of parseSkillFile, enforce every
+ * constraint from the frozen UseSteady Skills Architecture v1 spec.
+ *
+ * Design rules followed here:
+ *   - Collect ALL issues before returning (never fail-fast on the first error)
+ *   - Return a discriminated SkillValidationResult — never throw
+ *   - Use SkillValidationIssue.type literals so tests can assert on exact reasons
+ *   - Apply guardrails as strict equality checks against boolean literals
+ *   - Enforce the kind→schema mapping from KIND_SCHEMA_MAP (single source of truth)
+ *   - Treat absent optional fields (risk_level, priority) correctly under
+ *     exactOptionalPropertyTypes: true
+ */
+import { type SkillValidationResult } from './types.js';
+import type { ParsedSkillFile } from './parser.js';
+/**
+ * Validate the parsed output of a SKILL.md file against the frozen spec.
+ *
+ *   valid: true  → metadata is fully typed and safe to store in the registry
+ *   valid: false → issues contains every violation found in one pass
+ *
+ * Never throws. All errors are returned as structured SkillValidationIssue
+ * objects so that tests can assert on issue.type rather than string messages.
+ *
+ * @param parsed     The ParsedSkillFile returned by parseSkillFile.
+ * @param sourcePath Absolute path to the SKILL.md file; used in error messages.
+ */
+export declare function validateSkill(parsed: ParsedSkillFile, sourcePath: string): SkillValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/skills/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/skills/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAQL,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAoWnD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAqDvB"}