@gitgov/core 1.0.0

package/dist/src/types/generated/feedback_record.d.ts

@@ -0,0 +1,43 @@
+/**
+ * This file was automatically generated from feedback_record_schema.json.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */
+/**
+ * Canonical schema for feedback records
+ */
+export interface FeedbackRecord {
+    /**
+     * Unique identifier for the feedback entry
+     */
+    id: string;
+    /**
+     * The type of entity this feedback refers to
+     */
+    entityType: 'task' | 'execution' | 'changelog' | 'feedback';
+    /**
+     * The ID of the entity this feedback refers to
+     */
+    entityId: string;
+    /**
+     * The semantic intent of the feedback
+     */
+    type: 'blocking' | 'suggestion' | 'question' | 'approval' | 'clarification' | 'assignment';
+    /**
+     * The lifecycle status of the feedback
+     */
+    status: 'open' | 'acknowledged' | 'resolved' | 'wontfix';
+    /**
+     * The content of the feedback
+     */
+    content: string;
+    /**
+     * The Actor ID of the agent responsible for addressing the feedback
+     */
+    assignee?: string;
+    /**
+     * The ID of another feedback record that this one resolves or responds to
+     */
+    resolvesFeedbackId?: string;
+}
+//# sourceMappingURL=feedback_record.d.ts.map

package/dist/src/types/generated/feedback_record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback_record.d.ts","sourceRoot":"","sources":["../../../../src/types/generated/feedback_record.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,CAAC;IAC3F;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/src/types/generated/feedback_record.js

@@ -0,0 +1,7 @@
+/**
+ * This file was automatically generated from feedback_record_schema.json.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */
+export {};
+//# sourceMappingURL=feedback_record.js.map

package/dist/src/types/generated/feedback_record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback_record.js","sourceRoot":"","sources":["../../../../src/types/generated/feedback_record.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/types/generated/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * GitGovernance Protocol Types
+ *
+ * Auto-generated from JSON schemas. Do not edit manually.
+ * Run 'pnpm compile:types' to update.
+ */
+export * from "./actor_record";
+export * from "./agent_record";
+export * from "./changelog_record";
+export * from "./cycle_record";
+export * from "./execution_record";
+export * from "./feedback_record";
+export * from "./task_record";
+export * from "./workflow_methodology_record";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/generated/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/generated/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,+BAA+B,CAAC"}

package/dist/src/types/generated/index.js

@@ -0,0 +1,15 @@
+/**
+ * GitGovernance Protocol Types
+ *
+ * Auto-generated from JSON schemas. Do not edit manually.
+ * Run 'pnpm compile:types' to update.
+ */
+export * from "./actor_record";
+export * from "./agent_record";
+export * from "./changelog_record";
+export * from "./cycle_record";
+export * from "./execution_record";
+export * from "./feedback_record";
+export * from "./task_record";
+export * from "./workflow_methodology_record";
+//# sourceMappingURL=index.js.map

package/dist/src/types/generated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/generated/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,+BAA+B,CAAC"}

package/dist/src/types/generated/task_record.d.ts

@@ -0,0 +1,47 @@
+/**
+ * This file was automatically generated from task_record_schema.json.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */
+/**
+ * Canonical schema for task records as defined in task_protocol.md
+ */
+export interface TaskRecord {
+    /**
+     * Unique identifier for the task
+     */
+    id: string;
+    /**
+     * A brief, human-readable title for the task. Used to generate the ID slug.
+     */
+    title: string;
+    /**
+     * Optional. The IDs of the strategic cycles this task belongs to.
+     */
+    cycleIds?: string[];
+    /**
+     * Current state of the task in the institutional flow
+     */
+    status: 'draft' | 'review' | 'ready' | 'active' | 'done' | 'archived' | 'paused' | 'discarded';
+    /**
+     * Strategic or tactical priority level
+     */
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    /**
+     * Functional, technical or strategic summary of the objective
+     */
+    description: string;
+    /**
+     * List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer'). Can be an empty array.
+     */
+    tags: string[];
+    /**
+     * Valid links or files, when mentioned
+     */
+    references?: string[];
+    /**
+     * Additional comments, decisions made or added context
+     */
+    notes?: string;
+}
+//# sourceMappingURL=task_record.d.ts.map

package/dist/src/types/generated/task_record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_record.d.ts","sourceRoot":"","sources":["../../../../src/types/generated/task_record.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC/F;;OAEG;IACH,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/types/generated/task_record.js

@@ -0,0 +1,7 @@
+/**
+ * This file was automatically generated from task_record_schema.json.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */
+export {};
+//# sourceMappingURL=task_record.js.map

package/dist/src/types/generated/task_record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_record.js","sourceRoot":"","sources":["../../../../src/types/generated/task_record.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/types/generated/workflow_methodology_record.d.ts

@@ -0,0 +1,211 @@
+/**
+ * This file was automatically generated from workflow_methodology_record_schema.json.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */
+/**
+ * Complete schema for workflow methodology configuration files that define state transitions, signatures, and view configurations
+ */
+export interface WorkflowMethodologyRecord {
+    /**
+     * JSON Schema reference
+     */
+    $schema?: string;
+    /**
+     * Semantic version of the methodology configuration
+     */
+    version: string;
+    /**
+     * Human-readable name of the methodology
+     */
+    name: string;
+    /**
+     * Brief description of the methodology's purpose and scope
+     */
+    description?: string;
+    /**
+     * Defines valid state transitions and their requirements
+     */
+    state_transitions: {
+        [k: string]: {
+            /**
+             * Valid source states for this transition
+             *
+             * @minItems 1
+             */
+            from: [
+                'draft' | 'review' | 'ready' | 'active' | 'done' | 'archived' | 'paused' | 'discarded',
+                ...('draft' | 'review' | 'ready' | 'active' | 'done' | 'archived' | 'paused' | 'discarded')[]
+            ];
+            requires: {
+                /**
+                 * CLI command that triggers this transition
+                 */
+                command?: string;
+                /**
+                 * System event that triggers this transition
+                 */
+                event?: string;
+                /**
+                 * Signature requirements keyed by guild
+                 */
+                signatures?: {
+                    [k: string]: {
+                        /**
+                         * Required signature role
+                         */
+                        role: string;
+                        /**
+                         * Required capability roles in actor record
+                         *
+                         * @minItems 1
+                         */
+                        capability_roles: [string, ...string[]];
+                        /**
+                         * Minimum number of required approvals
+                         */
+                        min_approvals: number;
+                        /**
+                         * Optional: restrict to specific actor type
+                         */
+                        actor_type?: 'human' | 'agent';
+                        /**
+                         * Optional: specific actors that can sign
+                         */
+                        specific_actors?: string[];
+                    } | undefined;
+                };
+                /**
+                 * List of custom rule identifiers to validate
+                 */
+                custom_rules?: string[];
+            };
+        } | undefined;
+    };
+    /**
+     * Definitions for custom validation rules
+     */
+    custom_rules?: {
+        [k: string]: {
+            /**
+             * Human-readable description of the rule
+             */
+            description: string;
+            /**
+             * Validation type identifier
+             */
+            validation: 'assignment_required' | 'sprint_capacity' | 'epic_complexity' | 'custom' | 'javascript';
+            /**
+             * Optional parameters for the validation rule
+             */
+            parameters?: {};
+            /**
+             * JavaScript function code for 'javascript' validation type. Must return Promise<boolean>
+             */
+            javascript_function?: string;
+            /**
+             * Path to external module for custom validation (alternative to javascript_function)
+             */
+            module_path?: string;
+        } | undefined;
+    };
+    /**
+     * Visual representation configurations for different view types
+     */
+    view_configs?: {
+        [k: string]: {
+            /**
+             * Column definitions mapping visual names to task states
+             */
+            columns: {
+                /**
+                 * @minItems 1
+                 */
+                [k: string]: [
+                    'draft' | 'review' | 'ready' | 'active' | 'done' | 'archived' | 'paused' | 'discarded',
+                    ...('draft' | 'review' | 'ready' | 'active' | 'done' | 'archived' | 'paused' | 'discarded')[]
+                ] | undefined;
+            };
+            /**
+             * Visual theme for this view configuration
+             */
+            theme?: 'default' | 'dark' | 'minimal' | 'corporate';
+            /**
+             * Layout direction for the view
+             */
+            layout?: 'horizontal' | 'vertical' | 'grid';
+        } | undefined;
+    };
+    /**
+     * Optional agent automation configuration for methodology
+     */
+    agent_integration?: {
+        /**
+         * Brief description of the agent integration
+         */
+        description?: string;
+        /**
+         * List of agents required for this methodology
+         */
+        required_agents?: {
+            /**
+             * Unique agent identifier
+             */
+            id: string;
+            /**
+             * Agent guild classification
+             */
+            gremio: 'design' | 'intelligence' | 'strategy' | 'operations' | 'quality';
+            engine: {
+                type: 'local';
+                runtime?: string;
+                entrypoint?: string;
+                function?: string;
+            } | {
+                type: 'api';
+                url?: string;
+                method?: 'POST' | 'GET';
+                auth?: {};
+            } | {
+                type: 'mcp';
+                url?: string;
+                auth?: {};
+            };
+            /**
+             * Event triggers for this agent
+             */
+            triggers?: {
+                /**
+                 * Event that triggers the agent
+                 */
+                event: string;
+                /**
+                 * Action the agent should perform
+                 */
+                action: string;
+            }[];
+            /**
+             * Knowledge files this agent depends on
+             */
+            knowledge_dependencies?: string[];
+        }[];
+        /**
+         * Automation rules linking triggers to agents
+         */
+        automation_rules?: {
+            /**
+             * Event or condition that triggers automation
+             */
+            trigger: string;
+            /**
+             * Agent ID that handles this automation
+             */
+            agent: string;
+            /**
+             * Specific action the agent should perform
+             */
+            action: string;
+        }[];
+    };
+}
+//# sourceMappingURL=workflow_methodology_record.d.ts.map

package/dist/src/types/generated/workflow_methodology_record.d.ts.map

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

package/dist/src/types/generated/workflow_methodology_record.js

@@ -0,0 +1,7 @@
+/**
+ * This file was automatically generated from workflow_methodology_record_schema.json.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
+ * and run 'pnpm compile:types' to regenerate this file.
+ */
+export {};
+//# sourceMappingURL=workflow_methodology_record.js.map

package/dist/src/types/generated/workflow_methodology_record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_methodology_record.js","sourceRoot":"","sources":["../../../../src/types/generated/workflow_methodology_record.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./generated";
+export * from "./common.types";
+export * from "./embedded.types";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/src/types/index.js

@@ -0,0 +1,4 @@
+export * from "./generated";
+export * from "./common.types";
+export * from "./embedded.types";
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/src/utils/id_generator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Generates an Actor ID (e.g., 'human:camilo-velandia').
+ */
+export declare function generateActorId(type: 'human' | 'agent', displayName: string): string;
+/**
+ * Generates a Task ID (e.g., '12345-task-implement-auth').
+ */
+export declare function generateTaskId(title: string, timestamp: number): string;
+/**
+ * Generates a Cycle ID (e.g., '12345-cycle-release-v1').
+ */
+export declare function generateCycleId(title: string, timestamp: number): string;
+/**
+ * Generates an Execution ID (e.g., '12345-exec-commit-changes').
+ */
+export declare function generateExecutionId(title: string, timestamp: number): string;
+/**
+ * Generates a Changelog ID with entity type and slug (e.g., '12345-changelog-task-implement-auth').
+ */
+export declare function generateChangelogId(entityType: 'task' | 'cycle' | 'agent' | 'system' | 'configuration', entityId: string, timestamp: number): string;
+/**
+ * Generates a Feedback ID (e.g., '12345-feedback-code-review').
+ */
+export declare function generateFeedbackId(title: string, timestamp: number): string;
+/**
+ * Parses a timestamp-based record ID (e.g., '12345-task-slug') into its components.
+ */
+export declare function parseTimestampedId(id: string): {
+    timestamp: number;
+    prefix: string;
+    slug: string;
+} | null;
+/**
+ * Parses an Actor ID (e.g., 'human:camilo') into its components.
+ */
+export declare function parseActorId(id: string): {
+    type: 'human' | 'agent';
+    slug: string;
+} | null;
+/**
+ * Validates the format of a timestamp-based record ID.
+ */
+export declare function isValidTimestampedId(id: string): boolean;
+//# sourceMappingURL=id_generator.d.ts.map

package/dist/src/utils/id_generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id_generator.d.ts","sourceRoot":"","sources":["../../../src/utils/id_generator.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAapJ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWzG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASzF;AAOD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMxD"}

package/dist/src/utils/id_generator.js

@@ -0,0 +1,107 @@
+/**
+ * Sanitizes a string to be used in a GitGovernance ID slug.
+ * Converts to lower-case, replaces spaces with hyphens, and removes invalid characters.
+ */
+function sanitizeForId(name) {
+    return name
+        .toLowerCase()
+        .replace(/\s+/g, "-")
+        .replace(/[^a-z0-9-]/g, "")
+        .slice(0, 50); // Ensure slug is not too long
+}
+/**
+ * Generates an Actor ID (e.g., 'human:camilo-velandia').
+ */
+export function generateActorId(type, displayName) {
+    const slug = sanitizeForId(displayName);
+    return `${type}:${slug}`;
+}
+/**
+ * Generates a Task ID (e.g., '12345-task-implement-auth').
+ */
+export function generateTaskId(title, timestamp) {
+    const slug = sanitizeForId(title);
+    return `${timestamp}-task-${slug}`;
+}
+/**
+ * Generates a Cycle ID (e.g., '12345-cycle-release-v1').
+ */
+export function generateCycleId(title, timestamp) {
+    const slug = sanitizeForId(title);
+    return `${timestamp}-cycle-${slug}`;
+}
+/**
+ * Generates an Execution ID (e.g., '12345-exec-commit-changes').
+ */
+export function generateExecutionId(title, timestamp) {
+    const slug = sanitizeForId(title);
+    return `${timestamp}-exec-${slug}`;
+}
+/**
+ * Generates a Changelog ID with entity type and slug (e.g., '12345-changelog-task-implement-auth').
+ */
+export function generateChangelogId(entityType, entityId, timestamp) {
+    let entitySlug;
+    // For system and configuration, use the entityId directly as slug
+    if (entityType === 'system' || entityType === 'configuration') {
+        entitySlug = sanitizeForId(entityId);
+    }
+    else {
+        // For task, cycle, exec - extract slug from timestamped ID
+        const parsed = parseTimestampedId(entityId);
+        entitySlug = parsed ? parsed.slug : sanitizeForId(entityId);
+    }
+    return `${timestamp}-changelog-${entityType}-${entitySlug}`;
+}
+/**
+ * Generates a Feedback ID (e.g., '12345-feedback-code-review').
+ */
+export function generateFeedbackId(title, timestamp) {
+    const slug = sanitizeForId(title);
+    return `${timestamp}-feedback-${slug}`;
+}
+/**
+ * Parses a timestamp-based record ID (e.g., '12345-task-slug') into its components.
+ */
+export function parseTimestampedId(id) {
+    if (typeof id !== 'string')
+        return null;
+    const match = id.match(/^(\d+)-(\w+)-(.+)$/);
+    if (!match || !match[1] || !match[2] || !match[3]) {
+        return null;
+    }
+    return {
+        timestamp: parseInt(match[1], 10),
+        prefix: match[2],
+        slug: match[3],
+    };
+}
+/**
+ * Parses an Actor ID (e.g., 'human:camilo') into its components.
+ */
+export function parseActorId(id) {
+    if (typeof id !== 'string')
+        return null;
+    const parts = id.split(':');
+    if (parts.length < 2 || (parts[0] !== 'human' && parts[0] !== 'agent')) {
+        return null;
+    }
+    const type = parts[0];
+    const slug = parts.slice(1).join(':'); // Re-join in case slug contains ':'
+    return { type, slug };
+}
+/**
+ * Valid prefixes for timestamp-based record IDs.
+ */
+const VALID_PREFIXES = ['task', 'cycle', 'exec', 'changelog', 'feedback'];
+/**
+ * Validates the format of a timestamp-based record ID.
+ */
+export function isValidTimestampedId(id) {
+    const parsed = parseTimestampedId(id);
+    if (!parsed)
+        return false;
+    // Check if prefix is valid and slug is not empty
+    return VALID_PREFIXES.includes(parsed.prefix) && parsed.slug.length > 0;
+}
+//# sourceMappingURL=id_generator.js.map

package/dist/src/utils/id_generator.js.map

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

package/dist/src/utils/id_generator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=id_generator.test.d.ts.map

package/dist/src/utils/id_generator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id_generator.test.d.ts","sourceRoot":"","sources":["../../../src/utils/id_generator.test.ts"],"names":[],"mappings":""}