@graphorin/skills 0.5.0

package/dist/frontmatter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["parsed: unknown","parseYaml","conflictingSources: string[]","conflictPolicy: FrontmatterValidatorPolicy","unknownFieldPolicy: UnknownFieldPolicy","diagnostics: FrontmatterDiagnostic[]","severity: 'warn' | 'error'","steps: HandoffInputFilterStep[]","out: SkillToolDeclaration[]","declaration: Mutable<SkillToolDeclaration>","target"],"sources":["../../src/frontmatter/index.ts"],"sourcesContent":["/**\n * Frontmatter validator for `SKILL.md` files.\n *\n * Implements the field-resolution algorithm from ADR-043:\n *\n * 1. Anthropic-base (top-level, no prefix) — highest priority.\n * 2. `metadata.graphorin.<field>` bucket per upstream `metadata`\n *    convention.\n * 3. `graphorin-<field>` legacy top-level prefix.\n * 4. caller-supplied fallback.\n *\n * The validator surfaces every diagnostic through the typed\n * {@link FrontmatterDiagnostic} contract so callers can decide whether\n * to log, fail, or escalate without re-parsing human strings.\n *\n * @packageDocumentation\n */\n\nimport { parse as parseYaml } from 'yaml';\n\nimport { SkillManifestParseError } from '../errors/index.js';\nimport {\n  compareAuthorSpecHint,\n  getGraphorinMapping,\n  getKnownField,\n  getSpecSnapshot,\n} from '../spec/index.js';\nimport type {\n  FieldResolution,\n  FrontmatterDiagnostic,\n  FrontmatterValidatorPolicy,\n  HandoffInputFilterDeclaration,\n  HandoffInputFilterStep,\n  SkillToolDeclaration,\n  UnknownFieldPolicy,\n} from '../types/index.js';\n\n/** Result of {@link splitSkillMd}. */\nexport interface SplitSkillMd {\n  readonly frontmatter: string;\n  readonly body: string;\n}\n\n/**\n * Split a raw SKILL.md string into the YAML frontmatter and the\n * markdown body. The frontmatter delimiter is the canonical\n * `---\\n…\\n---\\n` pair.\n *\n * @stable\n */\nexport function splitSkillMd(skillMd: string): SplitSkillMd {\n  const normalized = skillMd.replace(/^\\uFEFF/u, '').replace(/\\r\\n/g, '\\n');\n  const match = /^---\\n([\\s\\S]*?)\\n---\\n?([\\s\\S]*)$/u.exec(normalized);\n  if (match === null) {\n    throw new SkillManifestParseError(\n      'SKILL.md must begin with a YAML frontmatter block delimited by `---` lines.',\n    );\n  }\n  return { frontmatter: match[1] ?? '', body: match[2] ?? '' };\n}\n\n/**\n * Parse the YAML frontmatter into a record. Returns `{}` for an empty\n * block.\n *\n * @stable\n */\nexport function parseFrontmatterYaml(frontmatter: string): Record<string, unknown> {\n  if (frontmatter.trim().length === 0) return {};\n  let parsed: unknown;\n  try {\n    parsed = parseYaml(frontmatter);\n  } catch (err) {\n    throw new SkillManifestParseError('SKILL.md frontmatter is not valid YAML.', { cause: err });\n  }\n  if (parsed === null || parsed === undefined) return {};\n  if (typeof parsed !== 'object' || Array.isArray(parsed)) {\n    throw new SkillManifestParseError(\n      `Top-level SKILL.md frontmatter must be an object; got '${Array.isArray(parsed) ? 'array' : typeof parsed}'.`,\n    );\n  }\n  return parsed as Record<string, unknown>;\n}\n\n/**\n * Resolve a single field across the four field-resolution tiers.\n * Returns the resolved value plus the source tier the value came from\n * AND the list of conflicting source names so the validator can\n * surface a structured diagnostic.\n *\n * @stable\n */\nexport function resolveSkillField<T = unknown>(\n  frontmatter: Record<string, unknown>,\n  field: string,\n  fallback?: T,\n): FieldResolution<T> {\n  const conflictingSources: string[] = [];\n  const presentInBase = field in frontmatter;\n  const meta = frontmatter.metadata;\n  const presentInMeta =\n    meta !== undefined &&\n    meta !== null &&\n    typeof meta === 'object' &&\n    !Array.isArray(meta) &&\n    `graphorin.${field}` in (meta as Record<string, unknown>);\n  const presentInPrefix = `graphorin-${field}` in frontmatter;\n  if (presentInBase) conflictingSources.push(field);\n  if (presentInMeta) conflictingSources.push(`metadata.graphorin.${field}`);\n  if (presentInPrefix) conflictingSources.push(`graphorin-${field}`);\n  const conflicting = conflictingSources.length > 1;\n\n  if (presentInBase) {\n    return Object.freeze({\n      value: frontmatter[field] as T,\n      source: 'anthropic-base' as const,\n      conflicting,\n      conflictingSources,\n    });\n  }\n  if (presentInMeta) {\n    return Object.freeze({\n      value: (meta as Record<string, unknown>)[`graphorin.${field}`] as T,\n      source: 'metadata-graphorin' as const,\n      conflicting,\n      conflictingSources,\n    });\n  }\n  if (presentInPrefix) {\n    return Object.freeze({\n      value: frontmatter[`graphorin-${field}`] as T,\n      source: 'graphorin-prefix' as const,\n      conflicting,\n      conflictingSources,\n    });\n  }\n  return Object.freeze({\n    value: fallback,\n    source: 'fallback' as const,\n    conflicting: false,\n    conflictingSources: [],\n  });\n}\n\n/**\n * Options accepted by {@link validateFrontmatter}.\n *\n * @stable\n */\nexport interface ValidateFrontmatterOptions {\n  /** Policy for direct collisions (Anthropic-base + `graphorin-*`). */\n  readonly conflictPolicy?: FrontmatterValidatorPolicy;\n  /** Policy for fields not part of the bundled snapshot or `graphorin-*` catalogue. */\n  readonly unknownFieldPolicy?: UnknownFieldPolicy;\n  /**\n   * Installed Graphorin runtime version. Used to validate\n   * `graphorin-runtime-compat` declarations against the running\n   * framework.\n   */\n  readonly runtimeVersion?: string;\n}\n\n/** Successful return of {@link validateFrontmatter}. */\nexport interface ValidatedFrontmatter {\n  readonly raw: Readonly<Record<string, unknown>>;\n  readonly diagnostics: ReadonlyArray<FrontmatterDiagnostic>;\n  readonly resolved: {\n    readonly name: FieldResolution<unknown>;\n    readonly description: FieldResolution<unknown>;\n    readonly license: FieldResolution<unknown>;\n    readonly compatibility: FieldResolution<unknown>;\n    readonly metadata: FieldResolution<unknown>;\n    readonly allowedTools: FieldResolution<unknown>;\n    readonly disableModelInvocation: FieldResolution<unknown>;\n    readonly trustLevel: FieldResolution<unknown>;\n    readonly runtimeCompat: FieldResolution<unknown>;\n    readonly sensitivity: FieldResolution<unknown>;\n    readonly sensitivityDefaults: FieldResolution<unknown>;\n    readonly sandbox: FieldResolution<unknown>;\n    readonly handoffInputFilter: FieldResolution<unknown>;\n    readonly anthropicSpec: FieldResolution<unknown>;\n    readonly version: FieldResolution<unknown>;\n    readonly tools: FieldResolution<unknown>;\n  };\n}\n\n/**\n * Validate a parsed frontmatter against the bundled spec snapshot and\n * the `graphorin-*` extension catalogue.\n *\n * @stable\n */\nexport function validateFrontmatter(\n  frontmatter: Record<string, unknown>,\n  options: ValidateFrontmatterOptions = {},\n): ValidatedFrontmatter {\n  const conflictPolicy: FrontmatterValidatorPolicy = options.conflictPolicy ?? 'warn';\n  const unknownFieldPolicy: UnknownFieldPolicy = options.unknownFieldPolicy ?? 'preserve';\n  const diagnostics: FrontmatterDiagnostic[] = [];\n\n  const resolveAndDiag = <T = unknown>(field: string, fallback?: T): FieldResolution<T> => {\n    const resolution = resolveSkillField<T>(frontmatter, field, fallback);\n    if (resolution.conflicting) {\n      const message =\n        `Both '${resolution.conflictingSources.join(\"' and '\")}' are set for '${field}'. ` +\n        `The Anthropic-base / metadata.graphorin.* tier wins; remove the lower-priority field to silence this diagnostic.`;\n      const hint = `Keep the highest-priority entry: '${resolution.source === 'anthropic-base' ? field : resolution.source === 'metadata-graphorin' ? `metadata.graphorin.${field}` : `graphorin-${field}`}'.`;\n      const severity: 'warn' | 'error' = conflictPolicy === 'error' ? 'error' : 'warn';\n      if (conflictPolicy !== 'silent') {\n        diagnostics.push(\n          Object.freeze({\n            kind: 'conflict',\n            field,\n            severity,\n            message,\n            hint,\n          }),\n        );\n      }\n    }\n    return resolution;\n  };\n\n  const name = resolveAndDiag<string>('name');\n  const description = resolveAndDiag<string>('description');\n  const license = resolveAndDiag<string>('license');\n  const compatibility = resolveAndDiag<string>('compatibility');\n  const metadata = resolveAndDiag<Record<string, unknown>>('metadata');\n  const allowedTools = resolveAndDiag<unknown>('allowed-tools');\n  const disableModelInvocation = resolveAndDiag<boolean>('disable-model-invocation', false);\n  const trustLevel = resolveAndDiag<string>('trust-level');\n  const runtimeCompat = resolveAndDiag<string>('runtime-compat');\n  // The graphorin-only `version` field carries runtime-compat semantics; the\n  // Anthropic-base `metadata.version` is the skill's own version. We honour\n  // both — the loader uses `runtimeCompat` for compat, `version` for\n  // graphorin-runtime-compat-as-version aliasing.\n  const version = resolveAndDiag<string>('version');\n  const sensitivity = resolveAndDiag<string>('sensitivity');\n  const sensitivityDefaults = resolveAndDiag<Record<string, string>>('sensitivity-defaults');\n  const sandbox = resolveAndDiag<Record<string, unknown>>('sandbox');\n  const handoffInputFilter = resolveAndDiag<unknown>('handoff-input-filter');\n  const anthropicSpec = resolveAndDiag<string>('anthropic-spec');\n  const tools = resolveAndDiag<unknown>('tools');\n\n  if (typeof name.value !== 'string' || name.value.trim().length === 0) {\n    diagnostics.push(\n      Object.freeze({\n        kind: 'missing-required-field',\n        field: 'name',\n        severity: 'error',\n        message: \"Required field 'name' is missing or empty.\",\n        hint: \"Add a unique 'name' (kebab-case is conventional) to the SKILL.md frontmatter.\",\n      }),\n    );\n  }\n  if (typeof description.value !== 'string' || description.value.trim().length === 0) {\n    diagnostics.push(\n      Object.freeze({\n        kind: 'missing-required-field',\n        field: 'description',\n        severity: 'error',\n        message: \"Required field 'description' is missing or empty.\",\n        hint: 'Add a description that explains when the model should activate the skill.',\n      }),\n    );\n  }\n  if (allowedTools.value !== undefined) {\n    const list = parseAllowedToolsValue(allowedTools.value);\n    if (list === null) {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'invalid-field-type',\n          field: 'allowed-tools',\n          severity: 'warn',\n          message:\n            \"'allowed-tools' must be a string ('read_file write_file') or an array (['read_file', 'write_file']).\",\n          hint: 'Switch to one of the two supported shapes; entries are split on whitespace for the string form.',\n        }),\n      );\n    }\n  }\n  if (\n    allowedTools.value !== undefined &&\n    getKnownField('allowed-tools')?.stability === 'experimental'\n  ) {\n    diagnostics.push(\n      Object.freeze({\n        kind: 'experimental-field',\n        field: 'allowed-tools',\n        severity: 'info',\n        message:\n          \"'allowed-tools' is marked experimental in the bundled spec snapshot; behaviour may evolve.\",\n      }),\n    );\n  }\n  if (anthropicSpec.value !== undefined && typeof anthropicSpec.value === 'string') {\n    const compare = compareAuthorSpecHint(anthropicSpec.value);\n    if (compare === 'newer') {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'spec-newer-than-loader',\n          field: 'anthropic-spec',\n          severity: 'warn',\n          message: `Skill targets spec snapshot '${anthropicSpec.value}', newer than the bundled '${getSpecSnapshot().snapshotDate}'. Unknown fields will be preserved leniently.`,\n        }),\n      );\n    } else if (compare === 'older') {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'spec-older-than-loader',\n          field: 'anthropic-spec',\n          severity: 'info',\n          message: `Skill targets spec snapshot '${anthropicSpec.value}', older than the bundled '${getSpecSnapshot().snapshotDate}'.`,\n        }),\n      );\n    } else if (compare === 'unparseable') {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'invalid-field-type',\n          field: 'anthropic-spec',\n          severity: 'warn',\n          message: `'anthropic-spec' must be an ISO-8601 date string (YYYY-MM-DD); got '${String(anthropicSpec.value)}'.`,\n        }),\n      );\n    }\n  }\n  if (\n    runtimeCompat.value !== undefined &&\n    typeof runtimeCompat.value === 'string' &&\n    options.runtimeVersion !== undefined\n  ) {\n    if (!isRuntimeCompatSatisfied(runtimeCompat.value, options.runtimeVersion)) {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'invalid-runtime-compat',\n          field: 'runtime-compat',\n          severity: 'error',\n          message: `Skill declares runtime-compat '${runtimeCompat.value}' which does not match installed Graphorin '${options.runtimeVersion}'.`,\n          hint: 'Adjust the skill or upgrade Graphorin so the declared range covers the installed version.',\n        }),\n      );\n    }\n  }\n  for (const key of Object.keys(frontmatter)) {\n    if (isRecognisedField(key)) continue;\n    if (key.startsWith('graphorin-')) {\n      // `graphorin-*` fields not in the mapping table are tolerated as\n      // opaque metadata per Phase 08 § Frontmatter validator. Emit a\n      // single info-level diagnostic so loaders can surface them.\n      if (unknownFieldPolicy === 'reject') {\n        diagnostics.push(\n          Object.freeze({\n            kind: 'unknown-field',\n            field: key,\n            severity: 'error',\n            message: `Unknown 'graphorin-*' field '${key}' rejected by unknownFieldPolicy='reject'.`,\n          }),\n        );\n      } else if (unknownFieldPolicy === 'warn') {\n        diagnostics.push(\n          Object.freeze({\n            kind: 'unknown-field',\n            field: key,\n            severity: 'warn',\n            message: `Unknown 'graphorin-*' field '${key}'. Will be preserved as opaque metadata.`,\n          }),\n        );\n      }\n      continue;\n    }\n    if (unknownFieldPolicy === 'reject') {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'unknown-field',\n          field: key,\n          severity: 'error',\n          message: `Unknown frontmatter field '${key}' rejected by unknownFieldPolicy='reject'.`,\n        }),\n      );\n    } else if (unknownFieldPolicy === 'warn') {\n      diagnostics.push(\n        Object.freeze({\n          kind: 'unknown-field',\n          field: key,\n          severity: 'warn',\n          message: `Unknown frontmatter field '${key}'. Will be preserved as opaque metadata.`,\n        }),\n      );\n    }\n  }\n\n  return Object.freeze({\n    raw: Object.freeze({ ...frontmatter }),\n    diagnostics: Object.freeze(diagnostics),\n    resolved: Object.freeze({\n      name,\n      description,\n      license,\n      compatibility,\n      metadata,\n      allowedTools,\n      disableModelInvocation,\n      trustLevel,\n      runtimeCompat,\n      sensitivity,\n      sensitivityDefaults,\n      sandbox,\n      handoffInputFilter,\n      anthropicSpec,\n      version,\n      tools,\n    }),\n  });\n}\n\n/**\n * Parse the `allowed-tools` field. Accepts either a string (with\n * whitespace-separated entries) or a string array. Returns `null` for\n * unsupported shapes so the validator can attach a typed diagnostic.\n *\n * @stable\n */\nexport function parseAllowedToolsValue(value: unknown): ReadonlyArray<string> | null {\n  if (Array.isArray(value)) {\n    if (!value.every((entry) => typeof entry === 'string' && entry.trim().length > 0)) {\n      return null;\n    }\n    return Object.freeze(value.map((entry) => entry.trim()) as string[]);\n  }\n  if (typeof value === 'string') {\n    const tokens = value\n      .split(/\\s+/u)\n      .map((tok) => tok.trim())\n      .filter((tok) => tok.length > 0);\n    if (tokens.length === 0) return null;\n    return Object.freeze(tokens);\n  }\n  return null;\n}\n\n/**\n * Parse the `handoff-input-filter` field into a structured\n * declaration. Returns `null` for unsupported shapes; callers should\n * attach a diagnostic when the return value is `null` and the source\n * value was non-undefined.\n *\n * @stable\n */\nexport function parseHandoffInputFilter(value: unknown): HandoffInputFilterDeclaration | null {\n  if (typeof value === 'string') {\n    const trimmed = value.trim();\n    if (trimmed === 'lastUser') return Object.freeze({ kind: 'lastUser' });\n    if (trimmed === 'summary') return Object.freeze({ kind: 'summary' });\n    if (trimmed === 'full') return Object.freeze({ kind: 'full' });\n    const lastN = /^lastN-(\\d+)$/u.exec(trimmed);\n    if (lastN !== null) {\n      const n = Number.parseInt(lastN[1] ?? '0', 10);\n      if (Number.isFinite(n) && n > 0) return Object.freeze({ kind: 'lastN', n });\n    }\n    return null;\n  }\n  if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n    const obj = value as Record<string, unknown>;\n    if (Array.isArray(obj.compose)) {\n      const steps: HandoffInputFilterStep[] = [];\n      for (const raw of obj.compose) {\n        const step = parseHandoffInputFilterStep(raw);\n        if (step === null) return null;\n        steps.push(step);\n      }\n      return Object.freeze({ kind: 'compose', steps: Object.freeze(steps) });\n    }\n  }\n  return null;\n}\n\nfunction parseHandoffInputFilterStep(raw: unknown): HandoffInputFilterStep | null {\n  if (typeof raw === 'string') {\n    if (raw === 'lastUser') return Object.freeze({ kind: 'lastUser' });\n    if (raw === 'summary') return Object.freeze({ kind: 'summary' });\n    if (raw === 'stripReasoning') return Object.freeze({ kind: 'stripReasoning' });\n    return null;\n  }\n  if (raw !== null && typeof raw === 'object' && !Array.isArray(raw)) {\n    const obj = raw as Record<string, unknown>;\n    if (typeof obj.lastN === 'number' && Number.isFinite(obj.lastN) && obj.lastN > 0) {\n      return Object.freeze({ kind: 'lastN', n: obj.lastN });\n    }\n    if (\n      obj.stripSensitiveOutputs !== undefined &&\n      typeof obj.stripSensitiveOutputs === 'object' &&\n      obj.stripSensitiveOutputs !== null\n    ) {\n      const inner = obj.stripSensitiveOutputs as Record<string, unknown>;\n      const keepTier = typeof inner.keepTier === 'string' ? inner.keepTier : undefined;\n      return Object.freeze({\n        kind: 'stripSensitiveOutputs',\n        ...(keepTier === undefined ? {} : { keepTier }),\n      });\n    }\n    if (typeof obj.lastUser === 'boolean') return Object.freeze({ kind: 'lastUser' });\n    if (typeof obj.summary === 'boolean') return Object.freeze({ kind: 'summary' });\n    if (typeof obj.stripReasoning === 'boolean') return Object.freeze({ kind: 'stripReasoning' });\n  }\n  return null;\n}\n\n/**\n * Parse the `tools` field. Accepts either an array of strings (tool\n * names — the loader resolves modules through naming convention) or\n * an array of objects with `name`, `module`, `description`, `tags`.\n * Returns `null` for unsupported shapes.\n *\n * @stable\n */\nexport function parseToolsField(value: unknown): ReadonlyArray<SkillToolDeclaration> | null {\n  if (!Array.isArray(value)) return null;\n  const out: SkillToolDeclaration[] = [];\n  for (const entry of value) {\n    if (typeof entry === 'string') {\n      if (entry.trim().length === 0) return null;\n      out.push(Object.freeze({ name: entry.trim() }));\n      continue;\n    }\n    if (entry !== null && typeof entry === 'object' && !Array.isArray(entry)) {\n      const obj = entry as Record<string, unknown>;\n      if (typeof obj.name !== 'string' || obj.name.trim().length === 0) return null;\n      const declaration: Mutable<SkillToolDeclaration> = { name: obj.name.trim() };\n      if (typeof obj.module === 'string' && obj.module.trim().length > 0)\n        declaration.module = obj.module.trim();\n      if (typeof obj.description === 'string') declaration.description = obj.description;\n      if (Array.isArray(obj.tags) && obj.tags.every((t) => typeof t === 'string')) {\n        declaration.tags = Object.freeze([...(obj.tags as string[])]);\n      }\n      out.push(Object.freeze(declaration as SkillToolDeclaration));\n      continue;\n    }\n    return null;\n  }\n  return Object.freeze(out);\n}\n\n/**\n * Best-effort semver-range satisfaction check. Supports the patterns\n * the framework actually emits (`^x.y.z`, `~x.y.z`, `>=x.y.z`,\n * `>x.y.z`, `<=x.y.z`, `<x.y.z`, plain `x.y.z`, the AND combinator\n * with whitespace) without pulling a runtime dependency on `semver`.\n * Unrecognised inputs return `false` so the validator emits a typed\n * diagnostic.\n *\n * @stable\n */\nexport function isRuntimeCompatSatisfied(range: string, version: string): boolean {\n  const versionTuple = parseSemver(version);\n  if (versionTuple === null) return false;\n  const expressions = range.split(/\\s+/u).filter((seg) => seg.length > 0);\n  for (const expression of expressions) {\n    if (!evaluateSemverExpression(expression, versionTuple)) return false;\n  }\n  return true;\n}\n\nfunction evaluateSemverExpression(\n  expression: string,\n  version: readonly [number, number, number],\n): boolean {\n  if (expression.startsWith('^')) {\n    const target = parseSemver(expression.slice(1));\n    if (target === null) return false;\n    if (target[0] === 0 && target[1] === 0) {\n      return version[0] === 0 && version[1] === 0 && version[2] === target[2];\n    }\n    if (target[0] === 0) {\n      return version[0] === 0 && version[1] === target[1] && cmpTuple(version, target) >= 0;\n    }\n    return version[0] === target[0] && cmpTuple(version, target) >= 0;\n  }\n  if (expression.startsWith('~')) {\n    const target = parseSemver(expression.slice(1));\n    if (target === null) return false;\n    return version[0] === target[0] && version[1] === target[1] && cmpTuple(version, target) >= 0;\n  }\n  if (expression.startsWith('>=')) {\n    const target = parseSemver(expression.slice(2));\n    return target !== null && cmpTuple(version, target) >= 0;\n  }\n  if (expression.startsWith('>')) {\n    const target = parseSemver(expression.slice(1));\n    return target !== null && cmpTuple(version, target) > 0;\n  }\n  if (expression.startsWith('<=')) {\n    const target = parseSemver(expression.slice(2));\n    return target !== null && cmpTuple(version, target) <= 0;\n  }\n  if (expression.startsWith('<')) {\n    const target = parseSemver(expression.slice(1));\n    return target !== null && cmpTuple(version, target) < 0;\n  }\n  if (expression === '*') return true;\n  const target = parseSemver(expression);\n  return target !== null && cmpTuple(version, target) === 0;\n}\n\nfunction parseSemver(value: string): [number, number, number] | null {\n  const trimmed = value.trim();\n  // Strip optional `v` prefix and any pre-release / build metadata —\n  // we only care about the canonical `MAJOR.MINOR.PATCH` triple.\n  const stripped = trimmed.replace(/^v/u, '').split(/[-+]/u, 1)[0] ?? '';\n  const parts = stripped.split('.');\n  if (parts.length < 1 || parts.length > 3) return null;\n  const [major, minor, patch] = [parts[0] ?? '0', parts[1] ?? '0', parts[2] ?? '0'];\n  if (!/^\\d+$/u.test(major) || !/^\\d+$/u.test(minor) || !/^\\d+$/u.test(patch)) return null;\n  return [Number.parseInt(major, 10), Number.parseInt(minor, 10), Number.parseInt(patch, 10)];\n}\n\nfunction cmpTuple(\n  a: readonly [number, number, number],\n  b: readonly [number, number, number],\n): number {\n  if (a[0] !== b[0]) return a[0] - b[0];\n  if (a[1] !== b[1]) return a[1] - b[1];\n  return a[2] - b[2];\n}\n\nfunction isRecognisedField(field: string): boolean {\n  if (getKnownField(field) !== undefined) return true;\n  if (getGraphorinMapping(field) !== undefined) return true;\n  if (field === 'metadata') return true;\n  return false;\n}\n\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] };\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { ActivatedSkill, FieldResolution, FrontmatterDiagnostic, FrontmatterValidatorPolicy, HandoffInputFilterDeclaration, HandoffInputFilterStep, InlineSkill, InlineSkillTool, ResolvedSkillTrustPolicy, Skill, SkillMetadata, SkillResource, SkillSignatureVerificationResult, SkillSource, SkillToolDeclaration, SkillTrustLevel, SkillTrustLevelValue, SkillsTrustLevel, SlashCommandActivation, SupplyChainSkillSource, UnknownFieldPolicy } from "./types/index.js";
+import { isSlashCommand, parseSlashCommand } from "./activation/index.js";
+import { GraphorinSkillsError, GraphorinSkillsErrorKind, InputFilterRequiredError, SkillFrontmatterConflictError, SkillLoadError, SkillManifestParseError, SkillNameCollisionError, SkillRequiredFieldMissingError, SkillRuntimeCompatError, SlashCommandParseError } from "./errors/index.js";
+import { SplitSkillMd, ValidateFrontmatterOptions, ValidatedFrontmatter, isRuntimeCompatSatisfied, parseAllowedToolsValue, parseFrontmatterYaml, parseHandoffInputFilter, parseToolsField, resolveSkillField, splitSkillMd, validateFrontmatter } from "./frontmatter/index.js";
+import { LoadSkillOptions, LoadSkillsOptions, loadSkillFromSource, loadSkills, requireHandoffInputFilter } from "./loader/index.js";
+import { MigrateFrontmatterOptions, MigrationResult, MigrationRewrite, migrateFrontmatter, sortKeysAnthropicFirst } from "./migration/index.js";
+import { StampedSkillTool, stampSkillTool, stampSkillToolFromMetadata } from "./registry/bridge.js";
+import { ActivationRequest, ParsedActivationTrigger, RegisteredToolDeclaration, SkillRegistry, SkillRegistryOptions, SkillToolStamper, createSkillRegistry, parseActivationTrigger } from "./registry/index.js";
+import { FieldStability, GraphorinFieldPolicy, GraphorinMappingEntry, KnownFieldEntry, SpecSnapshot, _setSpecSnapshotForTesting, compareAuthorSpecHint, getGraphorinMapping, getKnownField, getSpecSnapshot } from "./spec/index.js";
+
+//#region src/index.d.ts
+
+/**
+ * `@graphorin/skills` — skills surface for the Graphorin framework.
+ *
+ * The package owns:
+ *
+ * - `SKILL.md` loader with three-tier progressive disclosure
+ *   (metadata always available; body and resources lazy-loaded).
+ * - Frontmatter validator implementing the field-resolution
+ *   algorithm and conflict policy from ADR-043.
+ * - Bundled snapshot of the publicly published `SKILL.md` packaging-
+ *   format specification + the framework-specific extension
+ *   catalogue.
+ * - Slash-command parser (`/skill:<name>`) + auto-activation
+ *   metadata generator.
+ * - `SkillRegistry` with name-collision detection, activation
+ *   resolution, and a typed tool-declaration surface the agent
+ *   runtime bridges into the `@graphorin/tools` registry.
+ * - Idempotent `migrateFrontmatter` library that rewrites legacy
+ *   `graphorin-*` fields onto their upstream equivalents per the
+ *   bundled mapping table.
+ *
+ * Stable sub-paths:
+ *
+ * ```ts
+ * import { loadSkills, loadSkillFromSource } from '@graphorin/skills/loader';
+ * import { createSkillRegistry } from '@graphorin/skills/registry';
+ * import { validateFrontmatter, resolveSkillField } from '@graphorin/skills/frontmatter';
+ * import { migrateFrontmatter } from '@graphorin/skills/migration';
+ * import { parseSlashCommand } from '@graphorin/skills/activation';
+ * import { getSpecSnapshot, getKnownField } from '@graphorin/skills/spec';
+ * import { SkillFrontmatterConflictError } from '@graphorin/skills/errors';
+ * ```
+ *
+ * @packageDocumentation
+ */
+/** Canonical version constant. Mirrors the `package.json` version. */
+declare const VERSION = "0.5.0";
+//#endregion
+export { ActivatedSkill, ActivationRequest, FieldResolution, FieldStability, FrontmatterDiagnostic, FrontmatterValidatorPolicy, GraphorinFieldPolicy, GraphorinMappingEntry, GraphorinSkillsError, GraphorinSkillsErrorKind, HandoffInputFilterDeclaration, HandoffInputFilterStep, InlineSkill, InlineSkillTool, InputFilterRequiredError, KnownFieldEntry, LoadSkillOptions, LoadSkillsOptions, MigrateFrontmatterOptions, MigrationResult, MigrationRewrite, ParsedActivationTrigger, RegisteredToolDeclaration, ResolvedSkillTrustPolicy, Skill, SkillFrontmatterConflictError, SkillLoadError, SkillManifestParseError, SkillMetadata, SkillNameCollisionError, SkillRegistry, SkillRegistryOptions, SkillRequiredFieldMissingError, SkillResource, SkillRuntimeCompatError, SkillSignatureVerificationResult, SkillSource, SkillToolDeclaration, SkillToolStamper, SkillTrustLevel, SkillTrustLevelValue, SkillsTrustLevel, SlashCommandActivation, SlashCommandParseError, SpecSnapshot, SplitSkillMd, StampedSkillTool, SupplyChainSkillSource, UnknownFieldPolicy, VERSION, ValidateFrontmatterOptions, ValidatedFrontmatter, _setSpecSnapshotForTesting, compareAuthorSpecHint, createSkillRegistry, getGraphorinMapping, getKnownField, getSpecSnapshot, isRuntimeCompatSatisfied, isSlashCommand, loadSkillFromSource, loadSkills, migrateFrontmatter, parseActivationTrigger, parseAllowedToolsValue, parseFrontmatterYaml, parseHandoffInputFilter, parseSlashCommand, parseToolsField, requireHandoffInputFilter, resolveSkillField, sortKeysAnthropicFirst, splitSkillMd, stampSkillTool, stampSkillToolFromMetadata, validateFrontmatter };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqCA;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,OAAA"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { GraphorinSkillsError, InputFilterRequiredError, SkillFrontmatterConflictError, SkillLoadError, SkillManifestParseError, SkillNameCollisionError, SkillRequiredFieldMissingError, SkillRuntimeCompatError, SlashCommandParseError } from "./errors/index.js";
+import { isSlashCommand, parseSlashCommand } from "./activation/index.js";
+import { _setSpecSnapshotForTesting, compareAuthorSpecHint, getGraphorinMapping, getKnownField, getSpecSnapshot } from "./spec/index.js";
+import { isRuntimeCompatSatisfied, parseAllowedToolsValue, parseFrontmatterYaml, parseHandoffInputFilter, parseToolsField, resolveSkillField, splitSkillMd, validateFrontmatter } from "./frontmatter/index.js";
+import { loadSkillFromSource, loadSkills, requireHandoffInputFilter } from "./loader/index.js";
+import { migrateFrontmatter, sortKeysAnthropicFirst } from "./migration/index.js";
+import { stampSkillTool, stampSkillToolFromMetadata } from "./registry/bridge.js";
+import { createSkillRegistry, parseActivationTrigger } from "./registry/index.js";
+
+//#region src/index.ts
+/**
+* `@graphorin/skills` — skills surface for the Graphorin framework.
+*
+* The package owns:
+*
+* - `SKILL.md` loader with three-tier progressive disclosure
+*   (metadata always available; body and resources lazy-loaded).
+* - Frontmatter validator implementing the field-resolution
+*   algorithm and conflict policy from ADR-043.
+* - Bundled snapshot of the publicly published `SKILL.md` packaging-
+*   format specification + the framework-specific extension
+*   catalogue.
+* - Slash-command parser (`/skill:<name>`) + auto-activation
+*   metadata generator.
+* - `SkillRegistry` with name-collision detection, activation
+*   resolution, and a typed tool-declaration surface the agent
+*   runtime bridges into the `@graphorin/tools` registry.
+* - Idempotent `migrateFrontmatter` library that rewrites legacy
+*   `graphorin-*` fields onto their upstream equivalents per the
+*   bundled mapping table.
+*
+* Stable sub-paths:
+*
+* ```ts
+* import { loadSkills, loadSkillFromSource } from '@graphorin/skills/loader';
+* import { createSkillRegistry } from '@graphorin/skills/registry';
+* import { validateFrontmatter, resolveSkillField } from '@graphorin/skills/frontmatter';
+* import { migrateFrontmatter } from '@graphorin/skills/migration';
+* import { parseSlashCommand } from '@graphorin/skills/activation';
+* import { getSpecSnapshot, getKnownField } from '@graphorin/skills/spec';
+* import { SkillFrontmatterConflictError } from '@graphorin/skills/errors';
+* ```
+*
+* @packageDocumentation
+*/
+/** Canonical version constant. Mirrors the `package.json` version. */
+const VERSION = "0.5.0";
+
+//#endregion
+export { GraphorinSkillsError, InputFilterRequiredError, SkillFrontmatterConflictError, SkillLoadError, SkillManifestParseError, SkillNameCollisionError, SkillRequiredFieldMissingError, SkillRuntimeCompatError, SlashCommandParseError, VERSION, _setSpecSnapshotForTesting, compareAuthorSpecHint, createSkillRegistry, getGraphorinMapping, getKnownField, getSpecSnapshot, isRuntimeCompatSatisfied, isSlashCommand, loadSkillFromSource, loadSkills, migrateFrontmatter, parseActivationTrigger, parseAllowedToolsValue, parseFrontmatterYaml, parseHandoffInputFilter, parseSlashCommand, parseToolsField, requireHandoffInputFilter, resolveSkillField, sortKeysAnthropicFirst, splitSkillMd, stampSkillTool, stampSkillToolFromMetadata, validateFrontmatter };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@graphorin/skills` — skills surface for the Graphorin framework.\n *\n * The package owns:\n *\n * - `SKILL.md` loader with three-tier progressive disclosure\n *   (metadata always available; body and resources lazy-loaded).\n * - Frontmatter validator implementing the field-resolution\n *   algorithm and conflict policy from ADR-043.\n * - Bundled snapshot of the publicly published `SKILL.md` packaging-\n *   format specification + the framework-specific extension\n *   catalogue.\n * - Slash-command parser (`/skill:<name>`) + auto-activation\n *   metadata generator.\n * - `SkillRegistry` with name-collision detection, activation\n *   resolution, and a typed tool-declaration surface the agent\n *   runtime bridges into the `@graphorin/tools` registry.\n * - Idempotent `migrateFrontmatter` library that rewrites legacy\n *   `graphorin-*` fields onto their upstream equivalents per the\n *   bundled mapping table.\n *\n * Stable sub-paths:\n *\n * ```ts\n * import { loadSkills, loadSkillFromSource } from '@graphorin/skills/loader';\n * import { createSkillRegistry } from '@graphorin/skills/registry';\n * import { validateFrontmatter, resolveSkillField } from '@graphorin/skills/frontmatter';\n * import { migrateFrontmatter } from '@graphorin/skills/migration';\n * import { parseSlashCommand } from '@graphorin/skills/activation';\n * import { getSpecSnapshot, getKnownField } from '@graphorin/skills/spec';\n * import { SkillFrontmatterConflictError } from '@graphorin/skills/errors';\n * ```\n *\n * @packageDocumentation\n */\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.5.0';\n\nexport * from './activation/index.js';\nexport * from './errors/index.js';\nexport * from './frontmatter/index.js';\nexport * from './loader/index.js';\nexport * from './migration/index.js';\nexport * from './registry/index.js';\nexport * from './spec/index.js';\nexport * from './types/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,UAAU"}

package/dist/loader/index.d.ts

@@ -0,0 +1,55 @@
+import { FrontmatterValidatorPolicy, HandoffInputFilterDeclaration, Skill, SkillMetadata, SkillSource, UnknownFieldPolicy } from "../types/index.js";
+import { SupplyChainPolicy } from "@graphorin/security/supply-chain";
+
+//#region src/loader/index.d.ts
+
+/** Options forwarded to {@link loadSkillFromSource}. */
+interface LoadSkillOptions {
+  readonly conflictPolicy?: FrontmatterValidatorPolicy;
+  readonly unknownFieldPolicy?: UnknownFieldPolicy;
+  readonly runtimeVersion?: string;
+  readonly supplyChainPolicy?: SupplyChainPolicy;
+  readonly signal?: AbortSignal;
+  /** Override the bundled MIME-type guesser for resource files. */
+  readonly mediaTypeFor?: (path: string) => string | undefined;
+}
+/** Aggregate options accepted by {@link loadSkills}. */
+interface LoadSkillsOptions extends LoadSkillOptions {
+  /**
+   * Fail fast if any source produces a {@link SkillLoadError}. When
+   * `false` (default) the loader logs the source path on the
+   * diagnostic and continues with the next source.
+   */
+  readonly throwOnSourceError?: boolean;
+}
+/**
+ * Load a single skill from any supported source. The loader runs the
+ * full frontmatter validator and resolves the supply-chain trust
+ * policy so the returned {@link Skill} is ready to be inserted into a
+ * `SkillRegistry`.
+ *
+ * @stable
+ */
+declare function loadSkillFromSource(source: SkillSource, options?: LoadSkillOptions): Promise<Skill>;
+/**
+ * Load multiple skills concurrently. The sources are loaded in parallel and
+ * the returned array preserves input order. When `throwOnSourceError === false`
+ * (default) a failing source is logged and skipped; otherwise the first
+ * rejection propagates out unchanged.
+ *
+ * @stable
+ */
+declare function loadSkills(sources: ReadonlyArray<SkillSource>, options?: LoadSkillsOptions): Promise<ReadonlyArray<Skill>>;
+/**
+ * Required handoff-filter declaration helper. Returns the typed
+ * declaration the loader parsed from frontmatter; throws
+ * {@link InputFilterRequiredError} when the skill is untrusted and the
+ * field is missing. Used by the agent runtime in Phase 12 right
+ * before instantiating an untrusted skill's sub-agent.
+ *
+ * @stable
+ */
+declare function requireHandoffInputFilter(metadata: SkillMetadata): HandoffInputFilterDeclaration;
+//#endregion
+export { LoadSkillOptions, LoadSkillsOptions, loadSkillFromSource, loadSkills, requireHandoffInputFilter };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/loader/index.ts"],"sourcesContent":[],"mappings":";;;;;;UAyEiB,gBAAA;4BACW;gCACI;;+BAED;oBACX;;;;;UAMH,iBAAA,SAA0B;;;;;;;;;;;;;;;;iBAwCrB,mBAAA,SACZ,uBACC,mBACR,QAAQ;;;;;;;;;iBAmEW,UAAA,UACX,cAAc,wBACd,oBACR,QAAQ,cAAc;;;;;;;;;;iBA6kBT,yBAAA,WAAoC,gBAAgB"}