@n-dx/core 0.1.0

package/packages/rex/dist/schema/validate.d.ts

@@ -0,0 +1,194 @@
+import { z, ZodError } from "zod";
+export type ValidationResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    errors: ZodError;
+};
+export declare const RequirementSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    category: z.ZodEnum<[import("./v1.js").RequirementCategory, ...import("./v1.js").RequirementCategory[]]>;
+    validationType: z.ZodEnum<[import("./v1.js").RequirementValidationType, ...import("./v1.js").RequirementValidationType[]]>;
+    acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
+    validationCommand: z.ZodOptional<z.ZodString>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    priority: z.ZodOptional<z.ZodEnum<[import("./v1.js").Priority, ...import("./v1.js").Priority[]]>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    acceptanceCriteria: string[];
+    category: import("./v1.js").RequirementCategory;
+    validationType: import("./v1.js").RequirementValidationType;
+    description?: string | undefined;
+    priority?: import("./v1.js").Priority | undefined;
+    validationCommand?: string | undefined;
+    threshold?: number | undefined;
+}, {
+    id: string;
+    title: string;
+    acceptanceCriteria: string[];
+    category: import("./v1.js").RequirementCategory;
+    validationType: import("./v1.js").RequirementValidationType;
+    description?: string | undefined;
+    priority?: import("./v1.js").Priority | undefined;
+    validationCommand?: string | undefined;
+    threshold?: number | undefined;
+}>;
+export declare const PRDItemSchema: z.ZodType<Record<string, unknown>>;
+export declare const PRDDocumentSchema: z.ZodObject<{
+    schema: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    items: z.ZodArray<z.ZodType<Record<string, unknown>, z.ZodTypeDef, Record<string, unknown>>, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    schema: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    items: z.ZodArray<z.ZodType<Record<string, unknown>, z.ZodTypeDef, Record<string, unknown>>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    schema: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+    items: z.ZodArray<z.ZodType<Record<string, unknown>, z.ZodTypeDef, Record<string, unknown>>, "many">;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const RexConfigSchema: z.ZodObject<{
+    schema: z.ZodString;
+    project: z.ZodString;
+    adapter: z.ZodString;
+    validate: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodString>;
+    sourcevision: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    budget: z.ZodOptional<z.ZodObject<{
+        tokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodNumber>;
+        warnAt: z.ZodOptional<z.ZodNumber>;
+        abort: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        tokens?: number | undefined;
+        cost?: number | undefined;
+        warnAt?: number | undefined;
+        abort?: boolean | undefined;
+    }, {
+        tokens?: number | undefined;
+        cost?: number | undefined;
+        warnAt?: number | undefined;
+        abort?: boolean | undefined;
+    }>>;
+    loe: z.ZodOptional<z.ZodObject<{
+        taskThresholdWeeks: z.ZodOptional<z.ZodNumber>;
+        maxDecompositionDepth: z.ZodOptional<z.ZodNumber>;
+        proposalCeiling: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        taskThresholdWeeks?: number | undefined;
+        maxDecompositionDepth?: number | undefined;
+        proposalCeiling?: number | undefined;
+    }, {
+        taskThresholdWeeks?: number | undefined;
+        maxDecompositionDepth?: number | undefined;
+        proposalCeiling?: number | undefined;
+    }>>;
+    future: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    schema: z.ZodString;
+    project: z.ZodString;
+    adapter: z.ZodString;
+    validate: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodString>;
+    sourcevision: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    budget: z.ZodOptional<z.ZodObject<{
+        tokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodNumber>;
+        warnAt: z.ZodOptional<z.ZodNumber>;
+        abort: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        tokens?: number | undefined;
+        cost?: number | undefined;
+        warnAt?: number | undefined;
+        abort?: boolean | undefined;
+    }, {
+        tokens?: number | undefined;
+        cost?: number | undefined;
+        warnAt?: number | undefined;
+        abort?: boolean | undefined;
+    }>>;
+    loe: z.ZodOptional<z.ZodObject<{
+        taskThresholdWeeks: z.ZodOptional<z.ZodNumber>;
+        maxDecompositionDepth: z.ZodOptional<z.ZodNumber>;
+        proposalCeiling: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        taskThresholdWeeks?: number | undefined;
+        maxDecompositionDepth?: number | undefined;
+        proposalCeiling?: number | undefined;
+    }, {
+        taskThresholdWeeks?: number | undefined;
+        maxDecompositionDepth?: number | undefined;
+        proposalCeiling?: number | undefined;
+    }>>;
+    future: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    schema: z.ZodString;
+    project: z.ZodString;
+    adapter: z.ZodString;
+    validate: z.ZodOptional<z.ZodString>;
+    test: z.ZodOptional<z.ZodString>;
+    sourcevision: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    budget: z.ZodOptional<z.ZodObject<{
+        tokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodNumber>;
+        warnAt: z.ZodOptional<z.ZodNumber>;
+        abort: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        tokens?: number | undefined;
+        cost?: number | undefined;
+        warnAt?: number | undefined;
+        abort?: boolean | undefined;
+    }, {
+        tokens?: number | undefined;
+        cost?: number | undefined;
+        warnAt?: number | undefined;
+        abort?: boolean | undefined;
+    }>>;
+    loe: z.ZodOptional<z.ZodObject<{
+        taskThresholdWeeks: z.ZodOptional<z.ZodNumber>;
+        maxDecompositionDepth: z.ZodOptional<z.ZodNumber>;
+        proposalCeiling: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        taskThresholdWeeks?: number | undefined;
+        maxDecompositionDepth?: number | undefined;
+        proposalCeiling?: number | undefined;
+    }, {
+        taskThresholdWeeks?: number | undefined;
+        maxDecompositionDepth?: number | undefined;
+        proposalCeiling?: number | undefined;
+    }>>;
+    future: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const LogEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    event: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    timestamp: z.ZodString;
+    event: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    timestamp: z.ZodString;
+    event: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare function validateDocument(data: unknown): ValidationResult<z.infer<typeof PRDDocumentSchema>>;
+export declare function validateConfig(data: unknown): ValidationResult<z.infer<typeof RexConfigSchema>>;
+export declare function validateLogEntry(data: unknown): ValidationResult<z.infer<typeof LogEntrySchema>>;
+/**
+ * Format Zod validation errors into clear, actionable messages.
+ *
+ * Each error includes the field path and what was expected, making it
+ * easy to pinpoint and fix the issue.
+ */
+export declare function formatValidationErrors(errors: ZodError): string[];

package/packages/rex/dist/schema/validate.js

@@ -0,0 +1,136 @@
+import { z } from "zod";
+import { SCHEMA_VERSION, isCompatibleSchema, VALID_STATUSES, VALID_LEVELS, VALID_PRIORITIES, VALID_REQUIREMENT_CATEGORIES, VALID_VALIDATION_TYPES, } from "./v1.js";
+/** Helper: convert a Set<string> to a z.enum()-compatible tuple. */
+function setToEnumValues(s) {
+    const arr = [...s];
+    return arr;
+}
+const ItemStatusSchema = z.enum(setToEnumValues(VALID_STATUSES));
+const ItemLevelSchema = z.enum(setToEnumValues(VALID_LEVELS));
+const PrioritySchema = z.enum(setToEnumValues(VALID_PRIORITIES));
+const ProposalNodeKindSchema = z.enum(["epic", "feature", "task"]);
+const RequirementCategorySchema = z.enum(setToEnumValues(VALID_REQUIREMENT_CATEGORIES));
+const RequirementValidationTypeSchema = z.enum(setToEnumValues(VALID_VALIDATION_TYPES));
+export const RequirementSchema = z
+    .object({
+    id: z.string(),
+    title: z.string(),
+    description: z.string().optional(),
+    category: RequirementCategorySchema,
+    validationType: RequirementValidationTypeSchema,
+    acceptanceCriteria: z.array(z.string()),
+    validationCommand: z.string().optional(),
+    threshold: z.number().optional(),
+    priority: PrioritySchema.optional(),
+})
+    .strict();
+export const PRDItemSchema = z.lazy(() => z
+    .object({
+    id: z.string(),
+    title: z.string(),
+    status: ItemStatusSchema,
+    level: ItemLevelSchema,
+    description: z.string().optional(),
+    acceptanceCriteria: z.array(z.string()).optional(),
+    priority: PrioritySchema.optional(),
+    tags: z.array(z.string()).optional(),
+    source: z.string().optional(),
+    blockedBy: z.array(z.string()).optional(),
+    requirements: z.array(RequirementSchema).optional(),
+    startedAt: z.string().optional(),
+    completedAt: z.string().optional(),
+    failureReason: z.string().optional(),
+    resolutionType: z.enum(["code-change", "config-override", "acknowledgment", "deferred", "unclassified"]).optional(),
+    resolutionDetail: z.string().optional(),
+    mergedProposals: z.array(z.object({
+        proposalNodeKey: z.string(),
+        proposalTitle: z.string(),
+        proposalKind: ProposalNodeKindSchema,
+        reason: z.string(),
+        score: z.number(),
+        mergedAt: z.string(),
+        source: z.literal("smart-add"),
+    }).strict()).optional(),
+    children: z.array(PRDItemSchema).optional(),
+})
+    .passthrough());
+export const PRDDocumentSchema = z
+    .object({
+    schema: z.string().refine(isCompatibleSchema, {
+        message: `Incompatible PRD schema version, expected "${SCHEMA_VERSION}"`,
+    }),
+    title: z.string(),
+    items: z.array(PRDItemSchema),
+})
+    .passthrough();
+const BudgetThresholdsSchema = z
+    .object({
+    tokens: z.number().int().nonnegative().optional(),
+    cost: z.number().nonnegative().optional(),
+    warnAt: z.number().min(0).max(100).optional(),
+    abort: z.boolean().optional(),
+})
+    .strict();
+const LoEConfigSchema = z
+    .object({
+    taskThresholdWeeks: z.number().positive("taskThresholdWeeks must be a positive number").optional(),
+    maxDecompositionDepth: z.number().int().positive("maxDecompositionDepth must be a positive integer").optional(),
+    proposalCeiling: z.number().int().positive("proposalCeiling must be a positive integer").optional(),
+})
+    .strict();
+export const RexConfigSchema = z
+    .object({
+    schema: z.string(),
+    project: z.string(),
+    adapter: z.string(),
+    validate: z.string().optional(),
+    test: z.string().optional(),
+    sourcevision: z.string().optional(),
+    model: z.string().optional(),
+    budget: BudgetThresholdsSchema.optional(),
+    loe: LoEConfigSchema.optional(),
+    future: z.record(z.unknown()).optional(),
+})
+    .passthrough();
+export const LogEntrySchema = z
+    .object({
+    timestamp: z.string(),
+    event: z.string(),
+    itemId: z.string().optional(),
+    detail: z.string().optional(),
+})
+    .passthrough();
+export function validateDocument(data) {
+    const result = PRDDocumentSchema.safeParse(data);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: result.error };
+}
+export function validateConfig(data) {
+    const result = RexConfigSchema.safeParse(data);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: result.error };
+}
+export function validateLogEntry(data) {
+    const result = LogEntrySchema.safeParse(data);
+    if (result.success) {
+        return { ok: true, data: result.data };
+    }
+    return { ok: false, errors: result.error };
+}
+/**
+ * Format Zod validation errors into clear, actionable messages.
+ *
+ * Each error includes the field path and what was expected, making it
+ * easy to pinpoint and fix the issue.
+ */
+export function formatValidationErrors(errors) {
+    return errors.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+        return `${path}: ${issue.message}`;
+    });
+}
+//# sourceMappingURL=validate.js.map

package/packages/rex/dist/schema/validate.js.map

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

package/packages/rex/dist/store/adapter-registry.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Adapter registration system for rex store backends.
+ *
+ * Provides a registry for store adapter factories, config persistence,
+ * and store creation from registered adapters. Built-in adapters (file, notion)
+ * are registered automatically. Custom adapters can be registered at runtime.
+ *
+ * Adapter configurations are persisted in `.rex/adapters.json` so that
+ * configured adapters survive across CLI invocations.
+ *
+ * @module store/adapter-registry
+ */
+import type { PRDStore } from "./contracts.js";
+/** Schema for a single config field accepted by an adapter. */
+export interface AdapterConfigField {
+    /** Whether this field must be provided when creating the store. */
+    required: boolean;
+    /** Human-readable description shown in help output. */
+    description: string;
+    /** Whether this field contains sensitive data (tokens, secrets, passwords). */
+    sensitive?: boolean;
+}
+/**
+ * Factory function that creates a PRDStore instance.
+ *
+ * @param rexDir  The `.rex/` directory path.
+ * @param config  Key-value config entries for this adapter (tokens, IDs, etc.).
+ */
+export type AdapterFactory = (rexDir: string, config: Record<string, unknown>) => PRDStore;
+/**
+ * A complete adapter definition: metadata + factory.
+ *
+ * Register one of these via {@link AdapterRegistry.register}.
+ */
+export interface AdapterDefinition {
+    /** Unique adapter name (e.g. `"file"`, `"notion"`, `"postgres"`). */
+    name: string;
+    /** Short description for list/help output. */
+    description: string;
+    /** Config fields this adapter accepts. Used for validation and help. */
+    configSchema: Record<string, AdapterConfigField>;
+    /** Factory that produces a PRDStore from a rexDir and config. */
+    factory: AdapterFactory;
+}
+/** Metadata returned by {@link AdapterRegistry.list}. */
+export interface AdapterInfo {
+    name: string;
+    description: string;
+    builtIn: boolean;
+    configSchema: Record<string, AdapterConfigField>;
+}
+/** A persisted adapter configuration entry. */
+export interface AdapterConfig {
+    /** Adapter name (must match a registered adapter). */
+    name: string;
+    /** Key-value config for this adapter (tokens, database IDs, etc.). */
+    config: Record<string, unknown>;
+}
+/** Marker stored in adapters.json for sensitive fields. */
+interface RedactedField {
+    __redacted: true;
+    /** Environment variable to read at runtime. */
+    envVar: string;
+    /** Masked preview for display purposes. */
+    hint: string;
+}
+export declare function isRedactedField(v: unknown): v is RedactedField;
+/**
+ * Registry for store adapter definitions.
+ *
+ * Built-in adapters (`file`, `notion`) are always available.
+ * Custom adapters can be registered at runtime for extensibility.
+ */
+export declare class AdapterRegistry {
+    private adapters;
+    constructor();
+    /**
+     * Register a new store adapter.
+     *
+     * @throws If `name` is empty or already registered.
+     */
+    register(def: AdapterDefinition): void;
+    /**
+     * Remove a previously registered adapter.
+     *
+     * Built-in adapters (`file`, `notion`) cannot be unregistered.
+     *
+     * @throws If the adapter is built-in or not found.
+     */
+    unregister(name: string): void;
+    /** Get a registered adapter definition by name, or `undefined` if unknown. */
+    get(name: string): AdapterDefinition | undefined;
+    /** List all registered adapters with metadata. */
+    list(): AdapterInfo[];
+    /**
+     * Create a PRDStore from a registered adapter.
+     *
+     * Validates required config fields before calling the factory.
+     *
+     * @throws If the adapter is unknown or required config fields are missing.
+     */
+    create(adapterName: string, rexDir: string, config: Record<string, unknown>): PRDStore;
+    /**
+     * Create a store using a saved adapter config from `adapters.json`.
+     *
+     * Redacted sensitive fields are resolved from environment variables
+     * before passing the config to the adapter factory.
+     *
+     * @throws If no config exists for the adapter, or the adapter is unknown,
+     *         or required env vars for sensitive fields are not set.
+     */
+    createFromConfig(rexDir: string, adapterName: string): Promise<PRDStore>;
+    private adaptersPath;
+    private readAdaptersFile;
+    private writeAdaptersFile;
+    /**
+     * Save (or overwrite) an adapter configuration.
+     *
+     * If an entry for the same adapter name already exists, it is replaced.
+     * Sensitive fields (tokens, secrets) are redacted on disk and must be
+     * provided via environment variables at runtime.
+     */
+    saveAdapterConfig(rexDir: string, entry: AdapterConfig): Promise<void>;
+    /** Remove a saved adapter configuration. */
+    removeAdapterConfig(rexDir: string, name: string): Promise<void>;
+    /** Load all saved adapter configurations. */
+    loadAdapterConfigs(rexDir: string): Promise<AdapterConfig[]>;
+    /** Get saved config for a specific adapter, or `null` if not found. */
+    getAdapterConfig(rexDir: string, name: string): Promise<AdapterConfig | null>;
+}
+/**
+ * Get the default (process-wide) adapter registry.
+ *
+ * Lazily created on first call. Custom adapters registered here are
+ * available to `createStore` and the CLI.
+ */
+export declare function getDefaultRegistry(): AdapterRegistry;
+/**
+ * Reset the default registry (for testing only).
+ * @internal
+ */
+export declare function resetDefaultRegistry(): void;
+export {};