@toolproof-core/schema 1.0.9 → 1.0.11

package/src/index.ts

@@ -1,70 +1,77 @@
-// Re-export JSON schemas via .ts shims to avoid .json re-exports in declarations
-export { default as SchemaGenesis } from './generated/schemas/Genesis.js';
-export { default as SchemaJob } from './generated/schemas/standalone/Job.js';
-export { default as SchemaStrategyRun } from './generated/schemas/standalone/StrategyRun.js';
-export { default as ResourceTypeGenesis } from './generated/resources/Genesis.js';
-export { default as CONSTANTS } from './generated/constants/constants.js';
-
-
-export type {
-  Resource_Genesis as Resource_GenesisJson
-} from './generated/types/standalone/Resource_Genesis.js';
-export type {
-  Resource_ResourceType as Resource_ResourceTypeJson
-} from './generated/types/standalone/Resource_ResourceType.js';
-export type {
-  Resource_Job as Resource_JobJson
-} from './generated/types/standalone/Resource_Job.js';
-export type {
-  Resource_RawStrategy as Resource_RawStrategyJson
-} from './generated/types/standalone/Resource_RawStrategy.js';
-export type {
-  Resource_RunnableStrategy as Resource_RunnableStrategyJson
-} from './generated/types/standalone/Resource_RunnableStrategy.js';
-
-
-export type {
-  DocumentationFacet as DocumentationFacetJson,
-  NucleusFacet as NucleusFacetJson,
-  ResourceTypeIdentity as ResourceTypeIdentityJson,
-  ResourceType as ResourceTypeJson,
-  ResourceRoleIdentity as ResourceRoleIdentityJson,
-  ResourceRoleValue as ResourceRoleValueJson,
-  Conditional as ConditionalJson,
-  RoleMap as RoleMapJson,
-  Roles as RolesJson,
-  RoleBindings as RoleBindingsJson,
-  ResourceIdentity as ResourceIdentityJson,
-  JobStepIdentity as JobStepIdentityJson,
-  BranchStepIdentity as BranchStepIdentityJson,
-  WhileStepIdentity as WhileStepIdentityJson,
-  ForStepIdentity as ForStepIdentityJson,
-  JobStep as JobStepJson,
-  BranchStep as BranchStepJson,
-  WhileStep as WhileStepJson,
-  ForStep as ForStepJson,
-  StepKind as StepKindJson,
-  StepIdentity as StepIdentityJson,
-  Step as StepJson,
-  CreationContext as CreationContextJson,
-  ResourceMissing as ResourceMissingJson,
-  Resource as ResourceJson,
-  StrategyState as StrategyStateJson,
-  StepsFacet as StepsFacetJson,
-  RawStrategy as RawStrategyJson,
-  RunnableStrategyIdentity as RunnableStrategyIdentityJson,
-  RunnableStrategyStatus as RunnableStrategyStatusJson,
-  RunnableStrategy as RunnableStrategyJson,
-  RunnableStrategyUpdate as RunnableStrategyUpdateJson,
-  JobIdentity as JobIdentityJson,
-  Job as JobJson,
-  JsonData as JsonDataJson,
-  StrategyThreadIdentity as StrategyThreadIdentityJson,
-  StrategyThreadMap as StrategyThreadMapJson,
-  JobStepSocket as JobStepSocketJson,
-  Timestamp as TimestampJson,
-  StrategyRunIdentity as StrategyRunIdentityJson,
-  GoalIdentity as GoalIdentityJson,
-  Goal as GoalJson,
-  ShellMaterializedBase as ShellMaterializedBaseJson,
-} from './generated/types/types.js';
+// Re-export JSON schemas via .ts shims to avoid .json re-exports in declarations
+export { default as SchemaGenesis } from './generated/schemas/Genesis.js';
+export { default as SchemaResourceType } from './generated/schemas/standalone/ResourceType.js';
+export { default as SchemaJob } from './generated/schemas/standalone/Job.js';
+export { default as SchemaRunnableStrategy } from './generated/schemas/standalone/RunnableStrategy.js';
+export { default as SchemaStrategyRun } from './generated/schemas/standalone/StrategyRun.js';
+export { default as ResourceGenesis } from './generated/resources/Genesis.js';
+export { default as CONSTANTS } from './generated/artifacts/constants.js';
+export { default as MAPPINGS } from './generated/artifacts/mappings.js';
+
+
+export type {
+  Resource_Genesis as Resource_GenesisJson
+} from './generated/types/standalone/Resource_Genesis.js';
+export type {
+  Resource_ResourceType as Resource_ResourceTypeJson
+} from './generated/types/standalone/Resource_ResourceType.js';
+export type {
+  Resource_Job as Resource_JobJson
+} from './generated/types/standalone/Resource_Job.js';
+export type {
+  Resource_RawStrategy as Resource_RawStrategyJson
+} from './generated/types/standalone/Resource_RawStrategy.js';
+export type {
+  Resource_RunnableStrategy as Resource_RunnableStrategyJson
+} from './generated/types/standalone/Resource_RunnableStrategy.js';
+
+
+export type {
+  DocumentationFacetJson,
+  NucleusFacetJson,
+  ResourceTypeIdentityJson,
+  ResourceTypeJson,
+  ResourceRoleIdentityJson,
+  ResourceRoleValueJson,
+  ResourceRoleJson,
+  ConditionalJson,
+  RoleDictJson,
+  RolesJson,
+  RoleBindingsJson,
+  ResourceIdentityJson,
+  JobStepIdentityJson,
+  BranchStepIdentityJson,
+  WhileStepIdentityJson,
+  ForStepIdentityJson,
+  JobStepJson,
+  BranchStepJson,
+  WhileStepJson,
+  ForStepJson,
+  StepKindJson,
+  StepIdentityJson,
+  StepJson,
+  CreationContextJson,
+  ResourceMissingJson,
+  ResourceInputPotentialJson,
+  ResourceOutputPotentialJson,
+  ShellMaterializedBaseJson,
+  ResourceJson,
+  StrategyStateJson,
+  StepsFacetJson,
+  RawStrategyJson,
+  RunnableStrategyIdentityJson,
+  RunnableStrategyStatusJson,
+  RunnableStrategyJson,
+  RunnableStrategyUpdateJson,
+  JobIdentityJson,
+  JobJson,
+  JsonDataJson,
+  StrategyThreadIdentityJson,
+  StrategyThreadDictJson,
+  JobStepSocketJson,
+  TimestampJson,
+  StrategyRunIdentityJson,
+  GoalIdentityJson,
+  GoalJson,
+  ErrorJson,
+} from './generated/types/types.js';

package/src/scripts/_lib/config.ts

@@ -1,215 +1,207 @@
-/**
- * Configuration for schema generation scripts
- * All paths are configurable via environment variables
- * Provides sensible defaults for standard project structure
- */
-
-import path from 'path';
-
-/**
- * Get environment variable with optional default
- */
-function getEnv(name: string, defaultValue: string): string {
-  const value = process.env[name];
-  return value || defaultValue;
-}
-
-/**
- * Schema configuration with required environment variables
- */
-export class SchemaConfig {
-  // Base paths
-  private readonly root: string;
-  private readonly sourceDir: string;
-  private readonly sourceFile: string;
-  private readonly normalizedDir: string;
-  private readonly schemasDir: string;
-  private readonly constantsDir: string;
-  private readonly resourcesDir: string;
-  private readonly dependencyMapPath: string;
-  private readonly typesSrcDir: string;
-  private readonly typesDistDir: string;
-
-  // Schema metadata
-  private readonly baseUrl: string;
-  private readonly version: string;
-
-  constructor() {
-    // Environment variables with sensible defaults
-    this.root = getEnv('TP_SCHEMA_ROOT', process.cwd());
-    this.sourceDir = getEnv('TP_SCHEMA_SOURCE_DIR', 'src/');
-    this.sourceFile = getEnv('TP_SCHEMA_SOURCE_FILE', 'Genesis.json');
-    this.normalizedDir = getEnv('TP_SCHEMA_NORMALIZED_DIR', 'src/generated/normalized');
-    this.schemasDir = getEnv('TP_SCHEMA_SCHEMAS_DIR', 'src/generated/schemas');
-    this.constantsDir = getEnv('TP_SCHEMA_CONSTANTS_DIR', 'src/generated/constants');
-    this.resourcesDir = getEnv('TP_SCHEMA_RESOURCES_DIR', 'src/generated/resources');
-    this.dependencyMapPath = getEnv('TP_SCHEMA_DEPENDENCY_MAP_PATH', 'src/generated/dependencies/dependencyMap.json');
-    this.typesSrcDir = getEnv('TP_SCHEMA_TYPES_SRC_DIR', 'src/generated/types');
-    this.typesDistDir = getEnv('TP_SCHEMA_TYPES_DIST_DIR', 'dist/generated/types');
-    this.baseUrl = getEnv('TP_SCHEMA_BASE_URL', 'https://schemas.toolproof.com');
-    this.version = getEnv('TP_SCHEMA_VERSION', 'v0');
-  }
-
-  // Path getters
-  getRoot(): string {
-    return this.root;
-  }
-
-  getSourceDir(): string {
-    return path.isAbsolute(this.sourceDir)
-      ? this.sourceDir
-      : path.join(this.root, this.sourceDir);
-  }
-
-  getSourceFile(): string {
-    return this.sourceFile;
-  }
-
-  getSourcePath(): string {
-    return path.join(this.getSourceDir(), this.sourceFile);
-  }
-
-  getNormalizedDir(): string {
-    return path.isAbsolute(this.normalizedDir)
-      ? this.normalizedDir
-      : path.join(this.root, this.normalizedDir);
-  }
-
-  getNormalizedSourceFile(): string {
-    // We keep the same basename (Genesis.json) in the generated folder.
-    // The source-of-truth Genesis.json lives under `TP_SCHEMA_SOURCE_DIR`.
-    // The generated/normalized Genesis.json lives under `TP_SCHEMA_NORMALIZED_DIR`.
-    return this.sourceFile;
-  }
-
-  getNormalizedSourcePath(): string {
-    return path.join(this.getNormalizedDir(), this.getNormalizedSourceFile());
-  }
-
-  getSchemasDir(): string {
-    return path.isAbsolute(this.schemasDir)
-      ? this.schemasDir
-      : path.join(this.root, this.schemasDir);
-  }
-
-  getSchemaPath(filename: string): string {
-    return path.join(this.getSchemasDir(), filename);
-  }
-
-  getConstantsDir(): string {
-    return path.isAbsolute(this.constantsDir)
-      ? this.constantsDir
-      : path.join(this.root, this.constantsDir);
-  }
-
-  getConstantsPath(filename: string): string {
-    return path.join(this.getConstantsDir(), filename);
-  }
-
-  getStandaloneSchemaDir(): string {
-    return path.join(this.getSchemasDir(), 'standalone');
-  }
-
-  getStandaloneSchemaPath(filename: string): string {
-    return path.join(this.getStandaloneSchemaDir(), filename);
-  }
-
-  getTypesSrcDir(): string {
-    return path.isAbsolute(this.typesSrcDir)
-      ? this.typesSrcDir
-      : path.join(this.root, this.typesSrcDir);
-  }
-
-  getTypesDistDir(): string {
-    return path.isAbsolute(this.typesDistDir)
-      ? this.typesDistDir
-      : path.join(this.root, this.typesDistDir);
-  }
-
-  getTypesSrcPath(filename: string): string {
-    return path.join(this.getTypesSrcDir(), filename);
-  }
-
-  getTypesDistPath(filename: string): string {
-    return path.join(this.getTypesDistDir(), filename);
-  }
-
-  getStandaloneTypeSrcDir(): string {
-    return path.join(this.getTypesSrcDir(), 'standalone');
-  }
-
-  getStandaloneTypeDistDir(): string {
-    return path.join(this.getTypesDistDir(), 'standalone');
-  }
-
-  getStandaloneTypeSrcPath(filename: string): string {
-    return path.join(this.getStandaloneTypeSrcDir(), filename);
-  }
-
-  getStandaloneTypeDistPath(filename: string): string {
-    return path.join(this.getStandaloneTypeDistDir(), filename);
-  }
-
-  getResourcesDir(): string {
-    return path.isAbsolute(this.resourcesDir)
-      ? this.resourcesDir
-      : path.join(this.root, this.resourcesDir);
-  }
-
-  getDependencyMapPath(): string {
-    return path.isAbsolute(this.dependencyMapPath)
-      ? this.dependencyMapPath
-      : path.join(this.root, this.dependencyMapPath);
-  }
-
-  // Schema URL methods
-  getBaseUrl(): string {
-    return this.baseUrl;
-  }
-
-  getVersion(): string {
-    return this.version;
-  }
-
-  getSchemaId(schemaName: string): string {
-    return `${this.baseUrl}/${this.version}/${schemaName}.json`;
-  }
-
-  /**
-   * Check if a URL matches the configured schema base URL pattern
-   */
-  isSchemaUrl(url: string): boolean {
-    const baseUrlPattern = this.baseUrl.replace('https://', 'https?://');
-    return new RegExp(`^${baseUrlPattern}/`, 'i').test(url);
-  }
-
-  /**
-   * Extract schema name from URL (removes base URL and version prefix)
-   */
-  extractSchemaName(url: string): string {
-    // Remove base URL
-    let name = url.replace(new RegExp(`^${this.baseUrl}/`, 'i'), '');
-
-    // Remove version prefix (v0/, v1/, etc.)
-    name = name.replace(/^v\d+\//, '');
-
-    // Remove .json extension
-    name = name.replace(/\.json$/, '');
-
-    return name;
-  }
-}
-
-// Singleton instance
-let configInstance: SchemaConfig | null = null;
-
-/**
- * Get the schema configuration singleton
- * Throws error if required environment variables are not set
- */
-export function getConfig(): SchemaConfig {
-  if (!configInstance) {
-    configInstance = new SchemaConfig();
-  }
-  return configInstance;
-}
+/**
+ * Configuration for schema generation scripts
+ * All paths are configurable via environment variables
+ * Provides sensible defaults for standard project structure
+ */
+
+import path from 'path';
+
+/**
+ * Get environment variable with optional default
+ */
+function getEnv(name: string, defaultValue: string): string {
+  const value = process.env[name];
+  return value || defaultValue;
+}
+
+/**
+ * Schema configuration with required environment variables
+ */
+export class SchemaConfig {
+  // Base paths
+  private readonly root: string;
+  private readonly sourceDir: string;
+  private readonly sourceFile: string;
+  private readonly normalizedDir: string;
+  private readonly schemasDir: string;
+  private readonly artifactsDir: string;
+  private readonly resourcesDir: string;
+  private readonly typesSrcDir: string;
+  private readonly typesDistDir: string;
+
+  // Schema metadata
+  private readonly baseUrl: string;
+  private readonly version: string;
+
+  constructor() {
+    // Environment variables with sensible defaults
+    this.root = getEnv('TP_SCHEMA_ROOT', process.cwd());
+    this.sourceDir = getEnv('TP_SCHEMA_SOURCE_DIR', 'src/');
+    this.sourceFile = getEnv('TP_SCHEMA_SOURCE_FILE', 'Genesis.json');
+    this.normalizedDir = getEnv('TP_SCHEMA_NORMALIZED_DIR', 'src/generated/normalized');
+    this.schemasDir = getEnv('TP_SCHEMA_SCHEMAS_DIR', 'src/generated/schemas');
+    this.artifactsDir = getEnv('TP_SCHEMA_ARTIFACTS_DIR', 'src/generated/artifacts');
+    this.resourcesDir = getEnv('TP_SCHEMA_RESOURCES_DIR', 'src/generated/resources');
+    this.typesSrcDir = getEnv('TP_SCHEMA_TYPES_SRC_DIR', 'src/generated/types');
+    this.typesDistDir = getEnv('TP_SCHEMA_TYPES_DIST_DIR', 'dist/generated/types');
+    this.baseUrl = getEnv('TP_SCHEMA_BASE_URL', 'https://schemas.toolproof.com');
+    this.version = getEnv('TP_SCHEMA_VERSION', 'v1');
+  }
+
+  // Path getters
+  getRoot(): string {
+    return this.root;
+  }
+
+  getSourceDir(): string {
+    return path.isAbsolute(this.sourceDir)
+      ? this.sourceDir
+      : path.join(this.root, this.sourceDir);
+  }
+
+  getSourceFile(): string {
+    return this.sourceFile;
+  }
+
+  getSourcePath(): string {
+    return path.join(this.getSourceDir(), this.sourceFile);
+  }
+
+  getNormalizedDir(): string {
+    return path.isAbsolute(this.normalizedDir)
+      ? this.normalizedDir
+      : path.join(this.root, this.normalizedDir);
+  }
+
+  getNormalizedSourceFile(): string {
+    // We keep the same basename (Genesis.json) in the generated folder.
+    // The source-of-truth Genesis.json lives under `TP_SCHEMA_SOURCE_DIR`.
+    // The generated/normalized Genesis.json lives under `TP_SCHEMA_NORMALIZED_DIR`.
+    return this.sourceFile;
+  }
+
+  getNormalizedSourcePath(): string {
+    return path.join(this.getNormalizedDir(), this.getNormalizedSourceFile());
+  }
+
+  getSchemasDir(): string {
+    return path.isAbsolute(this.schemasDir)
+      ? this.schemasDir
+      : path.join(this.root, this.schemasDir);
+  }
+
+  getSchemaPath(filename: string): string {
+    return path.join(this.getSchemasDir(), filename);
+  }
+
+  getArtifactsDir(): string {
+    return path.isAbsolute(this.artifactsDir)
+      ? this.artifactsDir
+      : path.join(this.root, this.artifactsDir);
+  }
+
+  getArtifactsPath(filename: string): string {
+    return path.join(this.getArtifactsDir(), filename);
+  }
+
+  getStandaloneSchemaDir(): string {
+    return path.join(this.getSchemasDir(), 'standalone');
+  }
+
+  getStandaloneSchemaPath(filename: string): string {
+    return path.join(this.getStandaloneSchemaDir(), filename);
+  }
+
+  getTypesSrcDir(): string {
+    return path.isAbsolute(this.typesSrcDir)
+      ? this.typesSrcDir
+      : path.join(this.root, this.typesSrcDir);
+  }
+
+  getTypesDistDir(): string {
+    return path.isAbsolute(this.typesDistDir)
+      ? this.typesDistDir
+      : path.join(this.root, this.typesDistDir);
+  }
+
+  getTypesSrcPath(filename: string): string {
+    return path.join(this.getTypesSrcDir(), filename);
+  }
+
+  getTypesDistPath(filename: string): string {
+    return path.join(this.getTypesDistDir(), filename);
+  }
+
+  getStandaloneTypeSrcDir(): string {
+    return path.join(this.getTypesSrcDir(), 'standalone');
+  }
+
+  getStandaloneTypeDistDir(): string {
+    return path.join(this.getTypesDistDir(), 'standalone');
+  }
+
+  getStandaloneTypeSrcPath(filename: string): string {
+    return path.join(this.getStandaloneTypeSrcDir(), filename);
+  }
+
+  getStandaloneTypeDistPath(filename: string): string {
+    return path.join(this.getStandaloneTypeDistDir(), filename);
+  }
+
+  getResourcesDir(): string {
+    return path.isAbsolute(this.resourcesDir)
+      ? this.resourcesDir
+      : path.join(this.root, this.resourcesDir);
+  }
+
+  // Schema URL methods
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  getVersion(): string {
+    return this.version;
+  }
+
+  getSchemaId(schemaName: string): string {
+    return `${this.baseUrl}/${this.version}/${schemaName}.json`;
+  }
+
+  /**
+   * Check if a URL matches the configured schema base URL pattern
+   */
+  isSchemaUrl(url: string): boolean {
+    const baseUrlPattern = this.baseUrl.replace('https://', 'https?://');
+    return new RegExp(`^${baseUrlPattern}/`, 'i').test(url);
+  }
+
+  /**
+   * Extract schema name from URL (removes base URL and version prefix)
+   */
+  extractSchemaName(url: string): string {
+    // Remove base URL
+    let name = url.replace(new RegExp(`^${this.baseUrl}/`, 'i'), '');
+
+    // Remove version prefix (v0/, v1/, etc.)
+    name = name.replace(/^v\d+\//, '');
+
+    // Remove .json extension
+    name = name.replace(/\.json$/, '');
+
+    return name;
+  }
+}
+
+// Singleton instance
+let configInstance: SchemaConfig | null = null;
+
+/**
+ * Get the schema configuration singleton
+ * Throws error if required environment variables are not set
+ */
+export function getConfig(): SchemaConfig {
+  if (!configInstance) {
+    configInstance = new SchemaConfig();
+  }
+  return configInstance;
+}