@toolproof-npm/schema 0.1.49 → 0.1.52

package/dist/genesis/generated/types/types.d.ts

@@ -5,24 +5,24 @@
  * via the `definition` "BranchStep".
  */
 export type BranchStep =
- StepKind & {
+ {
   /**
    * @minItems 1
    */
   cases: [Conditional, ...Conditional[]];
   identity: BranchStepIdentity;
   kind: "branch";
-};
+} & StepKind;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "WorkStep".
  */
 export type WorkStep =
- StepKind & {
+ {
   execution: Execution;
   identity: WorkStepIdentity;
   kind: "work";
-};
+} & StepKind;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "Execution".
@@ -80,7 +80,6 @@ export type Documented =
  */
 export type ExtractionSchema =
  {
-} & {
   $schema: "https://json-schema.org/draft/2020-12/schema";
   $defs?: Record<string, unknown>;
   type: "object";
@@ -90,17 +89,18 @@ export type ExtractionSchema =
   additionalProperties?: false;
   unevaluatedProperties?: false;
   $anchor: string;
+} & {
 };
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "ForStep".
  */
 export type ForStep =
- StepKind & {
+ {
   case: Conditional;
   identity: ForStepIdentity;
   kind: "for";
-};
+} & StepKind;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "ForStepIdentity".
@@ -116,7 +116,6 @@ export type ForStepIdentity =
  */
 export type IdentitySchema =
  {
-} & {
   $schema?: "https://json-schema.org/draft/2020-12/schema";
   type: "string" | "number" | "integer" | "boolean";
   $anchor?: string;
@@ -129,6 +128,7 @@ export type IdentitySchema =
   maxLength?: number;
   minLength?: number;
   pattern?: string;
+} & {
 };
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
@@ -176,7 +176,6 @@ export type JsonData =
  */
 export type MeritSchema =
  {
-} & {
   $schema?: "https://json-schema.org/draft/2020-12/schema";
   type?: "number" | "integer";
   $anchor?: string;
@@ -190,6 +189,7 @@ export type MeritSchema =
   maximum?: number;
   minimum?: number;
   multipleOf?: number;
+} & {
 } & MeritSchema1;
 export type MeritSchema1 =
   | {
@@ -206,10 +206,11 @@ export type MeritSchema1 =
  * via the `definition` "Resource".
  */
 export type Resource =
- ResourceMetaBase & {
-  extractedData: {
-    [k: string]: JsonData;
-  };
+ {
+} & ResourceMetaBase & {
+    extractedData: {
+      [k: string]: JsonData;
+    };
 };
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
@@ -222,15 +223,6 @@ export type ResourceMetaBase =
     kind: "materialized";
 } & Timestamp &
   Path;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "ResourceBase".
- */
-export type ResourceBase =
- {
-  identity: ResourceIdentity;
-  resourceTypeRef: ResourceTypeIdentity;
-};
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "ResourceFormat".
@@ -261,7 +253,8 @@ export type ResourceMetaBase1 =
  * via the `definition` "ResourceMissing".
  */
 export type ResourceMissing =
- ResourceBase &
+ {
+} & ResourceBase &
   ResourceKind & {
     kind: "missing";
 };
@@ -270,7 +263,8 @@ export type ResourceMissing =
  * via the `definition` "ResourcePotentialInput".
  */
 export type ResourcePotentialInput =
- ResourceBase &
+ {
+} & ResourceBase &
   CreationContextWrapper &
   ResourceKind & {
     kind: "potential-input";
@@ -280,7 +274,8 @@ export type ResourcePotentialInput =
  * via the `definition` "ResourcePotentialOutput".
  */
 export type ResourcePotentialOutput =
- ResourceBase &
+ {
+} & ResourceBase &
   CreationContextWrapper &
   ResourceKind & {
     kind: "potential-output";
@@ -311,15 +306,6 @@ export type StatefulStrategy =
  */
 export type StatefulStrategyIdentity =
  `STATEFUL_STRATEGY-${string}`;
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StatelessStrategy".
- */
-export type StatelessStrategy =
- {
-  identity: StatelessStrategyIdentity;
-  steps: Step[];
-};
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StatelessStrategyIdentity".
@@ -337,11 +323,11 @@ export type Step =
  * via the `definition` "WhileStep".
  */
 export type WhileStep =
- StepKind & {
+ {
   case: Conditional;
   identity: WhileStepIdentity;
   kind: "while";
-};
+} & StepKind;
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "WhileStepIdentity".
@@ -351,13 +337,6 @@ export type WhileStepIdentity =
 
 export interface GenesisJson {
 }
-/**
- * This interface was referenced by `GenesisJson`'s JSON-Schema
- * via the `definition` "StepKind".
- */
-export interface StepKind {
-  kind: "work" | "branch" | "while" | "for";
-}
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "Conditional".
@@ -382,6 +361,13 @@ export interface RoleBindings {
  * via the `definition` "RoleBindingMap".
  */
 export type RoleBindingMap = Record<ResourceRoleIdentity, ResourceIdentity>;
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StepKind".
+ */
+export interface StepKind {
+  kind: "work" | "branch" | "while" | "for";
+}
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "CreationContext".
@@ -483,6 +469,14 @@ export interface MeritSchemaRef {
 export interface Path {
   path: string;
 }
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "ResourceBase".
+ */
+export interface ResourceBase {
+  identity: ResourceIdentity;
+  resourceTypeRef: ResourceTypeIdentity;
+}
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "ResourceKind".
@@ -504,6 +498,14 @@ export interface Timestamp {
 export interface RoleBindingsWrapper1 {
   roleBindings: RoleBindings;
 }
+/**
+ * This interface was referenced by `GenesisJson`'s JSON-Schema
+ * via the `definition` "StatelessStrategy".
+ */
+export interface StatelessStrategy {
+  identity: StatelessStrategyIdentity;
+  steps: Step[];
+}
 /**
  * This interface was referenced by `GenesisJson`'s JSON-Schema
  * via the `definition` "StrategyStateWrapper".
@@ -580,7 +582,6 @@ export type Documented =
  Named & Described;
 export type ExtractionSchema =
  {
-} & {
   $schema: "https://json-schema.org/draft/2020-12/schema";
   $defs?: Record<string, unknown>;
   type: "object";
@@ -590,6 +591,7 @@ export type ExtractionSchema =
   additionalProperties?: false;
   unevaluatedProperties?: false;
   $anchor: string;
+} & {
 };
 
 export interface Named {
@@ -609,21 +611,16 @@ export type Normalized =
 } & StrategyStateWrapper;
 export type StatefulStrategyIdentity =
  `STATEFUL_STRATEGY-${string}`;
-export type StatelessStrategy =
- {
-  identity: StatelessStrategyIdentity;
-  steps: Step[];
-};
 export type StatelessStrategyIdentity =
  `STATELESS_STRATEGY-${string}`;
 export type Step =
  WorkStep | BranchStep | WhileStep | ForStep;
 export type WorkStep =
- StepKind & {
+ {
   execution: Execution;
   identity: WorkStepIdentity;
   kind: "work";
-};
+} & StepKind;
 export type Execution =
  {
   identity: ExecutionIdentity;
@@ -638,46 +635,43 @@ export type ResourceIdentity =
 export type WorkStepIdentity =
  `WORKSTEP-${string}`;
 export type BranchStep =
- StepKind & {
+ {
   /**
    * @minItems 1
    */
   cases: [Conditional, ...Conditional[]];
   identity: BranchStepIdentity;
   kind: "branch";
-};
+} & StepKind;
 export type BranchStepIdentity =
  `BRANCHSTEP-${string}`;
 export type WhileStep =
- StepKind & {
+ {
   case: Conditional;
   identity: WhileStepIdentity;
   kind: "while";
-};
+} & StepKind;
 export type WhileStepIdentity =
  `WHILESTEP-${string}`;
 export type ForStep =
- StepKind & {
+ {
   case: Conditional;
   identity: ForStepIdentity;
   kind: "for";
-};
+} & StepKind;
 export type ForStepIdentity =
  `FORSTEP-${string}`;
 export type ResourceMissing =
- ResourceBase &
+ {
+} & ResourceBase &
   ResourceKind & {
     kind: "missing";
 };
-export type ResourceBase =
- {
-  identity: ResourceIdentity;
-  resourceTypeRef: ResourceTypeIdentity;
-};
 export type ResourceTypeIdentity =
  `TYPE-${string}`;
 export type ResourcePotentialInput =
- ResourceBase &
+ {
+} & ResourceBase &
   CreationContextWrapper &
   ResourceKind & {
     kind: "potential-input";
@@ -685,16 +679,18 @@ export type ResourcePotentialInput =
 export type ResourceRoleIdentity =
  `ROLE-${string}`;
 export type ResourcePotentialOutput =
- ResourceBase &
+ {
+} & ResourceBase &
   CreationContextWrapper &
   ResourceKind & {
     kind: "potential-output";
 };
 export type Resource =
- ResourceMetaBase & {
-  extractedData: {
-    [k: string]: JsonData;
-  };
+ {
+} & ResourceMetaBase & {
+    extractedData: {
+      [k: string]: JsonData;
+    };
 };
 export type ResourceMetaBase =
  ResourceBase &
@@ -713,8 +709,9 @@ export type JsonData =
       [k: string]: JsonData;
     };
 
-export interface StepKind {
-  kind: "work" | "branch" | "while" | "for";
+export interface StatelessStrategy {
+  identity: StatelessStrategyIdentity;
+  steps: Step[];
 }
 export interface RoleBindingsWrapper {
   roleBindings: RoleBindings;
@@ -724,6 +721,9 @@ export interface RoleBindings {
   outputBindingMap: RoleBindingMap;
 }
 export type RoleBindingMap = Record<ResourceRoleIdentity, ResourceIdentity>;
+export interface StepKind {
+  kind: "work" | "branch" | "while" | "for";
+}
 export interface Conditional {
   what: WorkStep;
   when: WorkStep;
@@ -732,6 +732,10 @@ export interface StrategyStateWrapper {
   strategyState: StrategyState;
 }
 export type StrategyState = Record<ExecutionIdentity, Record<ResourceRoleIdentity, ResourceMissing | ResourcePotentialInput | ResourcePotentialOutput | Resource>>;
+export interface ResourceBase {
+  identity: ResourceIdentity;
+  resourceTypeRef: ResourceTypeIdentity;
+}
 export interface ResourceKind {
   kind: "missing" | "potential-input" | "potential-output" | "materialized";
 }
@@ -749,75 +753,159 @@ export interface Path {
   path: string;
 }
 
-export type Normalized =
- {
-  identity: StatelessStrategyIdentity;
-  steps: Step[];
-};
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "StatelessStrategyIdentity".
+ */
 export type StatelessStrategyIdentity =
  `STATELESS_STRATEGY-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "Step".
+ */
 export type Step =
  WorkStep | BranchStep | WhileStep | ForStep;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "WorkStep".
+ */
 export type WorkStep =
- StepKind & {
+ {
   execution: Execution;
   identity: WorkStepIdentity;
   kind: "work";
-};
+} & StepKind;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "Execution".
+ */
 export type Execution =
  {
   identity: ExecutionIdentity;
   jobRef: JobIdentity;
 } & RoleBindingsWrapper;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "ExecutionIdentity".
+ */
 export type ExecutionIdentity =
  `EXECUTION-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "JobIdentity".
+ */
 export type JobIdentity =
  `JOB-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "ResourceIdentity".
+ */
 export type ResourceIdentity =
  `RESOURCE-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "WorkStepIdentity".
+ */
 export type WorkStepIdentity =
  `WORKSTEP-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "BranchStep".
+ */
 export type BranchStep =
- StepKind & {
+ {
   /**
    * @minItems 1
    */
   cases: [Conditional, ...Conditional[]];
   identity: BranchStepIdentity;
   kind: "branch";
-};
+} & StepKind;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "BranchStepIdentity".
+ */
 export type BranchStepIdentity =
  `BRANCHSTEP-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "WhileStep".
+ */
 export type WhileStep =
- StepKind & {
+ {
   case: Conditional;
   identity: WhileStepIdentity;
   kind: "while";
-};
+} & StepKind;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "WhileStepIdentity".
+ */
 export type WhileStepIdentity =
  `WHILESTEP-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "ForStep".
+ */
 export type ForStep =
- StepKind & {
+ {
   case: Conditional;
   identity: ForStepIdentity;
   kind: "for";
-};
+} & StepKind;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "ForStepIdentity".
+ */
 export type ForStepIdentity =
  `FORSTEP-${string}`;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "ResourceRoleIdentity".
+ */
+export type ResourceRoleIdentity =
+ `ROLE-${string}`;
 
-export interface StepKind {
-  kind: "work" | "branch" | "while" | "for";
+export interface Normalized {
+  identity: StatelessStrategyIdentity;
+  steps: Step[];
 }
 export interface RoleBindingsWrapper {
   roleBindings: RoleBindings;
 }
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "RoleBindings".
+ */
 export interface RoleBindings {
   inputBindingMap: RoleBindingMap;
   outputBindingMap: RoleBindingMap;
 }
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "RoleBindingMap".
+ */
 export type RoleBindingMap = Record<ResourceRoleIdentity, ResourceIdentity>;
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "StepKind".
+ */
+export interface StepKind {
+  kind: "work" | "branch" | "while" | "for";
+}
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "Conditional".
+ */
 export interface Conditional {
   what: WorkStep;
   when: WorkStep;
 }
+/**
+ * This interface was referenced by `Normalized`'s JSON-Schema
+ * via the `definition` "RoleBindingsWrapper".
+ */
+export interface RoleBindingsWrapper1 {
+  roleBindings: RoleBindings;
+}
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { default as GenesisSchema } from './genesis/generated/schemas/Genesis.js';
-export { default as Genesis } from './genesis/resourceTypes/Genesis.js';
+export { default as GenesisResourceType } from './genesis/generated/resource-type-envelopes/Genesis.js';
 export { default as JobSchema } from './genesis/generated/schemas/Job.js';
 export type { Resource_ResourceFormat as Resource_ResourceFormatJson } from './genesis/generated/types/Resource_ResourceFormat.js';
 export type { Resource_ResourceType as Resource_ResourceTypeJson } from './genesis/generated/types/Resource_ResourceType.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 // Re-export JSON schemas via .ts shims to avoid .json re-exports in declarations
 export { default as GenesisSchema } from './genesis/generated/schemas/Genesis.js';
-export { default as Genesis } from './genesis/resourceTypes/Genesis.js';
+export { default as GenesisResourceType } from './genesis/generated/resource-type-envelopes/Genesis.js';
 export { default as JobSchema } from './genesis/generated/schemas/Job.js';
 // Re-export brand factories so consumers can construct branded identities at runtime.
 export { unsafeBrand, asResourceTypeIdentity, asResourceRoleIdentity, asExecutionIdentity, asResourceIdentity, asWorkStepIdentity, asBranchStepIdentity, asForStepIdentity, asResourceFormatIdentity, asWhileStepIdentity, asStatelessStrategyIdentity, asStatefulStrategyIdentity, asResourceTypeIdentities, asResourceRoleIdentities, asExecutionIdentities, asResourceIdentities, asWorkStepIdentities, asBranchStepIdentities, asForStepIdentities, asResourceFormatIdentities, asWhileStepIdentities, asStatelessStrategyIdentities, asStatefulStrategyIdentities, } from './scripts/brandFactories.js';

package/dist/scripts/_lib/config.d.ts

@@ -10,6 +10,7 @@ export declare class SchemaConfig {
     private readonly root;
     private readonly sourceDir;
     private readonly sourceFile;
+    private readonly normalizedDir;
     private readonly outputDir;
     private readonly typesSrcDir;
     private readonly typesDistDir;
@@ -20,6 +21,9 @@ export declare class SchemaConfig {
     getSourceDir(): string;
     getSourceFile(): string;
     getSourcePath(): string;
+    getNormalizedDir(): string;
+    getNormalizedSourceFile(): string;
+    getNormalizedSourcePath(): string;
     getOutputDir(): string;
     getOutputPath(filename: string): string;
     getTypesSrcDir(): string;

package/dist/scripts/_lib/config.js

@@ -18,8 +18,11 @@ export class SchemaConfig {
     constructor() {
         // Environment variables with sensible defaults
         this.root = getEnv('TP_SCHEMA_ROOT', process.cwd());
-        this.sourceDir = getEnv('TP_SCHEMA_SOURCE_DIR', 'src/genesis/resourceTypes');
+        this.sourceDir = getEnv('TP_SCHEMA_SOURCE_DIR', 'src/genesis');
         this.sourceFile = getEnv('TP_SCHEMA_SOURCE_FILE', 'Genesis.json');
+        // Intermediate, generated artifact produced by rewriteAnchors.
+        // This should NOT live next to the source-of-truth schemas.
+        this.normalizedDir = getEnv('TP_SCHEMA_NORMALIZED_DIR', 'src/genesis/generated/resourceTypes');
         this.outputDir = getEnv('TP_SCHEMA_OUTPUT_DIR', 'src/genesis/generated/schemas');
         this.typesSrcDir = getEnv('TP_SCHEMA_TYPES_SRC_DIR', 'src/genesis/generated/types');
         this.typesDistDir = getEnv('TP_SCHEMA_TYPES_DIST_DIR', 'dist/genesis/generated/types');
@@ -41,6 +44,20 @@ export class SchemaConfig {
     getSourcePath() {
         return path.join(this.getSourceDir(), this.sourceFile);
     }
+    getNormalizedDir() {
+        return path.isAbsolute(this.normalizedDir)
+            ? this.normalizedDir
+            : path.join(this.root, this.normalizedDir);
+    }
+    getNormalizedSourceFile() {
+        // 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() {
+        return path.join(this.getNormalizedDir(), this.getNormalizedSourceFile());
+    }
     getOutputDir() {
         return path.isAbsolute(this.outputDir)
             ? this.outputDir

package/dist/scripts/extractSchemas.js

@@ -25,8 +25,8 @@ function parseArgs() {
     }
     // Use config defaults if not provided via CLI
     if (!inPath) {
-        // Use normalized version with anchor refs rewritten to pointers
-        inPath = config.getSourcePath().replace('.json', '.normalized.json');
+        // Use generated/normalized version with anchor refs rewritten to pointers
+        inPath = config.getNormalizedSourcePath();
     }
     if (!outPath) {
         outPath = config.getOutputPath(config.getSourceFile());

package/dist/scripts/generateResourceEnvelopes.js

@@ -18,7 +18,7 @@ import { getConfig } from './_lib/config.js';
 async function main() {
     const config = getConfig();
     // Use normalized version with anchor refs rewritten to pointers
-    const genesisSourcePath = config.getSourcePath().replace('.json', '.normalized.json');
+    const genesisSourcePath = config.getNormalizedSourcePath();
     const outputPath = path.join(config.getRoot(), 'src', 'genesis', 'generated', 'resources', 'Genesis.json');
     if (!fs.existsSync(genesisSourcePath)) {
         console.error(`Genesis source file not found at ${genesisSourcePath}`);

package/dist/scripts/generateSchemaShims.js

@@ -18,6 +18,7 @@ async function main() {
     const config = getConfig();
     const schemasDir = config.getOutputDir();
     const resourcesDir = path.join(path.dirname(schemasDir), 'resources');
+    const generatedResourceTypesDir = config.getNormalizedDir();
     // Process schemas directory
     let totalCount = 0;
     if (fs.existsSync(schemasDir)) {
@@ -55,6 +56,26 @@ async function main() {
     else {
         console.warn(`Resources directory not found at ${resourcesDir}`);
     }
+    // Genesis (normalized) shim
+    // We treat the normalized Genesis.json under src/genesis/generated/resourceTypes as the
+    // public import target, and generate a shim right next to it.
+    try {
+        const genesisJsonPath = config.getNormalizedSourcePath();
+        if (fs.existsSync(genesisJsonPath)) {
+            fs.mkdirSync(generatedResourceTypesDir, { recursive: true });
+            const outPath = path.join(generatedResourceTypesDir, 'Genesis.ts');
+            const content = `import schema from './Genesis.json' with { type: 'json' };\nexport default schema;\n`;
+            fs.writeFileSync(outPath, content, 'utf-8');
+            console.log(`Generated Genesis.ts in ${generatedResourceTypesDir}`);
+            totalCount++;
+        }
+        else {
+            console.warn(`Genesis source JSON not found at ${genesisJsonPath}; skipping Genesis.ts shim`);
+        }
+    }
+    catch (e) {
+        console.warn('Failed to generate Genesis.ts shim:', e);
+    }
     console.log(`Generated ${totalCount} total TypeScript shims`);
 }
 main().catch((e) => {