@ai-outfitter/outfitter 0.3.0

package/dist/schemas/profile.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://outfitter.dev/schemas/profile.schema.json",
+  "title": "Outfitter profile",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*[a-z0-9]$|^[a-z0-9]$"
+    },
+    "label": { "type": "string" },
+    "inherits": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z0-9][a-z0-9._-]*[a-z0-9]$|^[a-z0-9]$"
+      }
+    },
+    "state_persistence": {
+      "type": "object",
+      "additionalProperties": {
+        "enum": ["symlink", "discard", "warn", "error", "prompt"]
+      }
+    },
+    "controls": {
+      "type": "object",
+      "properties": {
+        "model": { "type": "string" },
+        "provider": { "type": "string" },
+        "thinking": { "type": "string" },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "session_directory": { "type": "string" },
+        "extensions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "prompt_template": { "type": "string" },
+        "system_prompt": { "type": "string" },
+        "append_system_prompt": { "type": "string" },
+        "environment": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "pi": {
+          "type": "object",
+          "properties": {
+            "model": { "type": "string" },
+            "provider": { "type": "string" },
+            "thinking": { "type": "string" },
+            "args": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "session_directory": { "type": "string" },
+            "extensions": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "skills": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "prompt_template": { "type": "string" },
+            "system_prompt": { "type": "string" },
+            "append_system_prompt": { "type": "string" },
+            "allow_external_deepwork_jobs": { "type": "boolean" },
+            "environment": {
+              "type": "object",
+              "additionalProperties": { "type": "string" }
+            }
+          },
+          "additionalProperties": true
+        },
+        "claude": {
+          "type": "object",
+          "properties": {
+            "model": { "type": "string" },
+            "provider": { "type": "string" },
+            "thinking": { "type": "string" },
+            "args": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "session_directory": { "type": "string" },
+            "extensions": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "skills": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "prompt_template": { "type": "string" },
+            "system_prompt": { "type": "string" },
+            "append_system_prompt": { "type": "string" },
+            "environment": {
+              "type": "object",
+              "additionalProperties": { "type": "string" }
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/dist/schemas/settings.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://outfitter.dev/schemas/settings.schema.json",
+  "title": "Outfitter settings",
+  "type": "object",
+  "properties": {
+    "default_profile": { "type": "string", "minLength": 1 },
+    "default_agent": { "enum": ["pi", "claude"] },
+    "cache_directory": { "type": "string", "minLength": 1 },
+    "profile_sources": {
+      "type": "array",
+      "items": { "$ref": "profile-source.schema.json" }
+    },
+    "remote_settings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "oneOf": [
+          { "required": ["uri", "path"], "not": { "required": ["github"] } },
+          { "required": ["github", "path"], "not": { "required": ["uri"] } }
+        ],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "uri": { "type": "string", "minLength": 1 },
+          "github": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" },
+          "ref": { "type": "string", "minLength": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "custom_settings": {
+      "type": "object",
+      "description": "Arbitrary YAML-compatible values exposed to Outfitter compositeProfile templates as outfitter.custom_settings."
+    }
+  },
+  "additionalProperties": true
+}

package/dist/settings/Settings.d.ts

@@ -0,0 +1,17 @@
+import type { ProfileSourceReference, RemoteSourceReference } from '../profiles/ProfileSource.js';
+export type RemoteSettingsReference = RemoteSourceReference & {
+    readonly path: string;
+};
+export type SettingsValue = string | number | boolean | null | readonly SettingsValue[] | {
+    readonly [key: string]: SettingsValue;
+};
+export type CustomSettings = Readonly<Record<string, SettingsValue>>;
+export interface Settings {
+    readonly defaultProfile?: string;
+    readonly defaultAgent?: string;
+    readonly profileSources?: readonly ProfileSourceReference[];
+    readonly remoteSettings?: readonly RemoteSettingsReference[];
+    readonly cacheDirectory?: string;
+    readonly customSettings?: CustomSettings;
+}
+export declare const emptySettings: () => Settings;

package/dist/settings/Settings.js

@@ -0,0 +1,5 @@
+export const emptySettings = () => ({
+    profileSources: [],
+    remoteSettings: [],
+});
+//# sourceMappingURL=Settings.js.map

package/dist/settings/Settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Settings.js","sourceRoot":"","sources":["../../src/settings/Settings.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,aAAa,GAAG,GAAa,EAAE,CAAC,CAAC;IAC5C,cAAc,EAAE,EAAE;IAClB,cAAc,EAAE,EAAE;CACnB,CAAC,CAAC"}

package/dist/settings/SettingsLoader.d.ts

@@ -0,0 +1,33 @@
+import type { ValidationIssue } from '../validation/SchemaValidator.js';
+import type { RemoteSettingsReference, Settings } from './Settings.js';
+export interface SettingsLocation {
+    readonly scope: 'user' | 'project' | 'project-local' | 'remote';
+    readonly path: string;
+}
+export interface SettingsLoadPlan {
+    readonly locations: readonly SettingsLocation[];
+}
+export interface LoadedSettingsFile {
+    readonly location: SettingsLocation;
+    readonly settings: Settings;
+}
+export interface SettingsLoadResult {
+    readonly files: readonly LoadedSettingsFile[];
+    readonly issues: readonly SettingsLoadIssue[];
+}
+export interface LoadedSettings extends SettingsLoadResult {
+    readonly settings: Settings;
+}
+export interface SettingsLoadIssue extends ValidationIssue {
+    readonly filePath: string;
+}
+export interface SettingsDiscoveryInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+}
+export declare const createSettingsLoadPlan: (locations: readonly SettingsLocation[]) => SettingsLoadPlan;
+export declare const discoverSettingsLoadPlan: (input: SettingsDiscoveryInput) => SettingsLoadPlan;
+export declare const discoverRemoteSettingsLoadPlan: (homeDirectory: string, remoteSettings: readonly RemoteSettingsReference[]) => SettingsLoadPlan;
+export declare const loadSettingsFiles: (plan: SettingsLoadPlan) => SettingsLoadResult;
+export declare const loadSettings: (plan: SettingsLoadPlan) => LoadedSettings;
+export declare const loadSettingsWithCachedRemoteSettings: (input: SettingsDiscoveryInput, remoteSettingsReferencesOverride?: readonly RemoteSettingsReference[]) => LoadedSettings;

package/dist/settings/SettingsLoader.js

@@ -0,0 +1,129 @@
+// Discovers, parses, validates, and converts Outfitter settings.yml files.
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { createRemoteRepositoryCachePath, resolveRemoteRepositorySubpath } from '../profiles/ProfileCache.js';
+import { validateSchema } from '../validation/SchemaValidator.js';
+import { parseYamlDocument } from '../validation/YamlDocument.js';
+import { mergeSettingsStack } from './SettingsMerger.js';
+export const createSettingsLoadPlan = (locations) => ({
+    locations,
+});
+export const discoverSettingsLoadPlan = (input) => createSettingsLoadPlan([
+    { scope: 'user', path: join(input.homeDirectory, '.outfitter', 'settings.yml') },
+    { scope: 'project', path: join(input.projectDirectory, '.outfitter', 'settings.yml') },
+    { scope: 'project-local', path: join(input.projectDirectory, '.outfitter', 'local', 'settings.yml') },
+]);
+export const discoverRemoteSettingsLoadPlan = (homeDirectory, remoteSettings) => discoverRemoteSettingsLocations(homeDirectory, remoteSettings).plan;
+export const loadSettingsFiles = (plan) => {
+    const files = [];
+    const issues = [];
+    for (const location of plan.locations) {
+        if (existsSync(location.path)) {
+            addSettingsFile(location, files, issues);
+        }
+    }
+    return { files, issues };
+};
+export const loadSettings = (plan) => {
+    const result = loadSettingsFiles(plan);
+    return {
+        ...result,
+        settings: mergeSettingsStack(result.files.map((file) => file.settings)),
+    };
+};
+export const loadSettingsWithCachedRemoteSettings = (input, remoteSettingsReferencesOverride) => {
+    const localSettings = loadSettings(discoverSettingsLoadPlan(input));
+    const remoteSettingsReferences = remoteSettingsReferencesOverride ?? localSettings.settings.remoteSettings;
+    if (localSettings.issues.length > 0 || remoteSettingsReferences.length === 0) {
+        return localSettings;
+    }
+    const remoteSettingsLocations = discoverRemoteSettingsLocations(input.homeDirectory, remoteSettingsReferences);
+    const remoteSettings = loadSettings(remoteSettingsLocations.plan);
+    const files = [...remoteSettings.files, ...localSettings.files];
+    const issues = [...remoteSettingsLocations.issues, ...remoteSettings.issues, ...localSettings.issues];
+    return {
+        files,
+        issues,
+        settings: mergeSettingsStack(files.map((file) => file.settings)),
+    };
+};
+const discoverRemoteSettingsLocations = (homeDirectory, remoteSettings) => {
+    const locations = [];
+    const issues = [];
+    for (const [index, source] of remoteSettings.entries()) {
+        try {
+            locations.push({
+                scope: 'remote',
+                path: resolveRemoteRepositorySubpath(createRemoteRepositoryCachePath(homeDirectory, source), source.path),
+            });
+        }
+        catch (error) {
+            issues.push({
+                filePath: `remote_settings[${index}]`,
+                path: `/remote_settings/${index}/path`,
+                message: formatRemoteSettingsPathError(error),
+            });
+        }
+    }
+    return { plan: createSettingsLoadPlan(locations), issues };
+};
+const formatRemoteSettingsPathError = (error) => {
+    /* v8 ignore next -- repository subpath validation throws Error instances. */
+    if (!(error instanceof Error)) {
+        return String(error);
+    }
+    return error.message;
+};
+const addSettingsFile = (location, files, issues) => {
+    const parsed = parseYamlDocument(readFileSync(location.path, 'utf8'), location.path);
+    if (!parsed.ok) {
+        issues.push({ filePath: location.path, path: parsed.issue.path, message: parsed.issue.message });
+        return;
+    }
+    const validation = validateSchema('settings', parsed.document);
+    if (!validation.valid) {
+        issues.push(...validation.issues.map((issue) => ({ filePath: location.path, ...issue })));
+        return;
+    }
+    files.push({
+        location,
+        settings: convertSettingsDocument(parsed.document, dirname(location.path)),
+    });
+};
+const convertSettingsDocument = (document, settingsDirectory) => ({
+    defaultProfile: document.default_profile,
+    defaultAgent: document.default_agent,
+    profileSources: document.profile_sources?.map((source) => convertProfileSource(source, settingsDirectory)),
+    remoteSettings: document.remote_settings?.map(convertRemoteSettingsSource),
+    cacheDirectory: document.cache_directory === undefined
+        ? undefined
+        : resolveConfigDirectory(document.cache_directory, settingsDirectory),
+    customSettings: document.custom_settings,
+});
+const convertRemoteSettingsSource = (source) => {
+    if (source.uri !== undefined) {
+        return { uri: source.uri, ref: source.ref, path: source.path };
+    }
+    return { github: source.github, ref: source.ref, path: source.path };
+};
+const convertProfileSource = (source, settingsDirectory) => {
+    const filters = {
+        only: source.only,
+        except: source.except,
+    };
+    if (source.uri !== undefined) {
+        return { ...filters, uri: source.uri, ref: source.ref, path: source.path };
+    }
+    if (source.github !== undefined) {
+        return { ...filters, github: source.github, ref: source.ref, path: source.path };
+    }
+    return { ...filters, path: resolveProfileSourcePath(source.path, settingsDirectory) };
+};
+const resolveProfileSourcePath = (sourcePath, settingsDirectory) => resolveConfigDirectory(sourcePath, settingsDirectory);
+const resolveConfigDirectory = (configuredPath, settingsDirectory) => {
+    if (isAbsolute(configuredPath)) {
+        return configuredPath;
+    }
+    return resolve(settingsDirectory, configuredPath);
+};
+//# sourceMappingURL=SettingsLoader.js.map

package/dist/settings/SettingsLoader.js.map

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

package/dist/settings/SettingsMerger.d.ts

@@ -0,0 +1,2 @@
+import type { Settings } from './Settings.js';
+export declare const mergeSettingsStack: (settingsStack: readonly Settings[]) => Settings;

package/dist/settings/SettingsMerger.js

@@ -0,0 +1,31 @@
+// Provides deterministic Settings merge scaffolding.
+import { mergeObjectsWithPolicy } from '../merge/SettingsValueMerger.js';
+import { emptySettings } from './Settings.js';
+export const mergeSettingsStack = (settingsStack) => {
+    let defaultProfile;
+    let defaultAgent;
+    let profileSources;
+    let remoteSettings;
+    let cacheDirectory;
+    let customSettings;
+    for (const settings of settingsStack) {
+        defaultProfile = settings.defaultProfile ?? defaultProfile;
+        defaultAgent = settings.defaultAgent ?? defaultAgent;
+        profileSources = settings.profileSources ?? profileSources;
+        remoteSettings = settings.remoteSettings ?? remoteSettings;
+        cacheDirectory = settings.cacheDirectory ?? cacheDirectory;
+        customSettings = mergeOptionalCustomSettings(customSettings, settings.customSettings);
+    }
+    return {
+        ...emptySettings(),
+        defaultProfile,
+        defaultAgent,
+        profileSources: profileSources ?? [],
+        remoteSettings: remoteSettings ?? [],
+        cacheDirectory,
+        customSettings: customSettings ?? {},
+    };
+};
+const mergeOptionalCustomSettings = (lowerPrecedence, higherPrecedence) => higherPrecedence === undefined ? lowerPrecedence : mergeCustomSettings(lowerPrecedence, higherPrecedence);
+const mergeCustomSettings = (lowerPrecedence, higherPrecedence) => mergeObjectsWithPolicy(lowerPrecedence, higherPrecedence);
+//# sourceMappingURL=SettingsMerger.js.map

package/dist/settings/SettingsMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsMerger.js","sourceRoot":"","sources":["../../src/settings/SettingsMerger.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAkC,EAAY,EAAE;IACjF,IAAI,cAAkC,CAAC;IACvC,IAAI,YAAgC,CAAC;IACrC,IAAI,cAA0C,CAAC;IAC/C,IAAI,cAA0C,CAAC;IAC/C,IAAI,cAAkC,CAAC;IACvC,IAAI,cAA0C,CAAC;IAE/C,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,YAAY,CAAC;QAErD,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,2BAA2B,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACxF,CAAC;IAED,OAAO;QACL,GAAG,aAAa,EAAE;QAClB,cAAc;QACd,YAAY;QACZ,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,cAAc;QACd,cAAc,EAAE,cAAc,IAAI,EAAE;KACrC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAClC,eAA2C,EAC3C,gBAA4C,EAChB,EAAE,CAC9B,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAE5G,MAAM,mBAAmB,GAAG,CAC1B,eAA2C,EAC3C,gBAAgC,EAChB,EAAE,CAAC,sBAAsB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/validation/SchemaValidator.d.ts

@@ -0,0 +1,11 @@
+export type SchemaName = 'settings' | 'profile' | 'profile-source';
+export interface ValidationIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly issues: readonly ValidationIssue[];
+}
+export declare const createValidationResult: (issues: readonly ValidationIssue[]) => ValidationResult;
+export declare const validateSchema: (schemaName: SchemaName, document: unknown) => ValidationResult;

package/dist/validation/SchemaValidator.js

@@ -0,0 +1,36 @@
+// Validates parsed Outfitter YAML documents against bundled JSON Schemas.
+import { readFileSync } from 'node:fs';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+const readSchema = (schemaFileName) => JSON.parse(readFileSync(new URL(`../schemas/${schemaFileName}`, import.meta.url), 'utf8'));
+const settingsSchema = readSchema('settings.schema.json');
+const profileSchema = readSchema('profile.schema.json');
+const profileSourceSchema = readSchema('profile-source.schema.json');
+const createAjv = () => {
+    const ajv = new Ajv2020({ allErrors: true });
+    ajv.addSchema(profileSourceSchema, 'profile-source.schema.json');
+    ajv.addSchema(profileSchema, 'profile.schema.json');
+    ajv.addSchema(settingsSchema, 'settings.schema.json');
+    return ajv;
+};
+const ajv = createAjv();
+const validators = {
+    settings: ajv.compile(settingsSchema),
+    profile: ajv.compile(profileSchema),
+    'profile-source': ajv.compile(profileSourceSchema),
+};
+export const createValidationResult = (issues) => ({
+    valid: issues.length === 0,
+    issues,
+});
+export const validateSchema = (schemaName, document) => {
+    const validate = validators[schemaName];
+    if (validate(document)) {
+        return createValidationResult([]);
+    }
+    return createValidationResult(validate.errors.map(formatAjvError));
+};
+const formatAjvError = (error) => ({
+    path: error.instancePath === '' ? '/' : error.instancePath,
+    message: String(error.message),
+});
+//# sourceMappingURL=SchemaValidator.js.map

package/dist/validation/SchemaValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidator.js","sourceRoot":"","sources":["../../src/validation/SchemaValidator.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAc3C,MAAM,UAAU,GAAG,CAAC,cAAsB,EAAW,EAAE,CACrD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,cAAc,cAAc,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7F,MAAM,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAC1D,MAAM,aAAa,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;AACxD,MAAM,mBAAmB,GAAG,UAAU,CAAC,4BAA4B,CAAC,CAAC;AAErE,MAAM,SAAS,GAAG,GAAY,EAAE;IAC9B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,SAAS,CAAC,mBAAgC,EAAE,4BAA4B,CAAC,CAAC;IAC9E,GAAG,CAAC,SAAS,CAAC,aAA0B,EAAE,qBAAqB,CAAC,CAAC;IACjE,GAAG,CAAC,SAAS,CAAC,cAA2B,EAAE,sBAAsB,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB,MAAM,UAAU,GAAyC;IACvD,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,cAA2B,CAAC;IAClD,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,aAA0B,CAAC;IAChD,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,mBAAgC,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAkC,EAAoB,EAAE,CAAC,CAAC;IAC/F,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;IAC1B,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAsB,EAAE,QAAiB,EAAoB,EAAE;IAC5F,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAExC,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,OAAO,sBAAsB,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,sBAAsB,CAAE,QAAQ,CAAC,MAAiC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;AACjG,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAkB,EAAmB,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY;IAC1D,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;CAC/B,CAAC,CAAC"}

package/dist/validation/YamlDocument.d.ts

@@ -0,0 +1,13 @@
+export interface ParsedYamlDocument {
+    readonly ok: true;
+    readonly document: unknown;
+}
+export interface YamlParseFailure {
+    readonly ok: false;
+    readonly issue: {
+        readonly path: string;
+        readonly message: string;
+    };
+}
+export type YamlParseResult = ParsedYamlDocument | YamlParseFailure;
+export declare const parseYamlDocument: (content: string, issuePath: string) => YamlParseResult;

package/dist/validation/YamlDocument.js

@@ -0,0 +1,11 @@
+// Parses YAML text into Outfitter validation-friendly document results.
+import { parse } from 'yaml';
+export const parseYamlDocument = (content, issuePath) => {
+    try {
+        return { ok: true, document: parse(content) };
+    }
+    catch (error) {
+        return { ok: false, issue: { path: issuePath, message: String(error) } };
+    }
+};
+//# sourceMappingURL=YamlDocument.js.map

package/dist/validation/YamlDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"YamlDocument.js","sourceRoot":"","sources":["../../src/validation/YamlDocument.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAiB7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,SAAiB,EAAmB,EAAE;IACvF,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC3E,CAAC;AACH,CAAC,CAAC"}

package/doc/.deepreview

@@ -0,0 +1,30 @@
+controllable_elements_matrix:
+  description: "Review controllable element mappings and support-status claims for judgment-based accuracy."
+  match:
+    include:
+      - "controllable-elements.md"
+  review:
+    strategy: individual
+    instructions: |
+      Review doc/controllable-elements.md for judgment-based mapping accuracy.
+      This rule provides judgment-based review coverage for OFTR-007.1,
+      OFTR-007.2, and OFTR-007.3 concerns that cannot be validated
+      deterministically by the controllable_elements_matrix DeepSchema.
+
+      Deterministic facts such as table shape, one row per defined term, allowed
+      status values, and status definition presence are handled by the
+      controllable_elements_matrix DeepSchema. Do not duplicate those exact
+      checks here.
+
+      Check the following judgment-based concerns:
+      1. Pi mechanism descriptions accurately reflect pi terminology and native
+         behavior.
+      2. Non-pi mappings are clearly framed as roadmap/experimental unless a
+         supported adapter exists.
+      3. Support status claims do not overstate tested Outfitter behavior.
+      4. Defined controllable elements are meaningful product-boundary concepts,
+         not implementation-only details.
+
+      Output Format:
+      - PASS: Mappings and support-status claims are accurate and appropriately qualified.
+      - FAIL: Issues found. List each inaccurate or overstated mapping/status claim with a line reference.