@schnick371/devsteps-shared 0.0.1 → 0.5.1

package/dist/schemas/index.js

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+// Re-export project context schemas
+export * from './project.js';
+export * from './relationships.js';
+/**
+ * Methodology types
+ */
+export const Methodology = z.enum(['scrum', 'waterfall', 'hybrid']);
+/**
+ * Item types in devstepssystem
+ * Scrum: epic, story, task, bug, spike, test
+ * Waterfall: requirement, feature, task, bug, test
+ * Hybrid: all of the above
+ */
+export const ItemType = z.enum([
+    'epic',
+    'story',
+    'task',
+    'requirement',
+    'feature',
+    'bug',
+    'spike',
+    'test',
+]);
+/**
+ * Item status lifecycle
+ */
+export const ItemStatus = z.enum([
+    'draft',
+    'planned',
+    'in-progress',
+    'review',
+    'done',
+    'obsolete',
+    'blocked',
+    'cancelled',
+]);
+/**
+ * Priority levels
+ */
+export const Priority = z.enum(['critical', 'high', 'medium', 'low']);
+/**
+ * Eisenhower Matrix quadrants for prioritization
+ * Q1: Urgent + Important = Do First
+ * Q2: Not Urgent + Important = Schedule/Plan
+ * Q3: Urgent + Not Important = Delegate
+ * Q4: Not Urgent + Not Important = Eliminate/Later
+ */
+export const EisenhowerQuadrant = z.enum([
+    'urgent-important', // Q1: Do First
+    'not-urgent-important', // Q2: Schedule
+    'urgent-not-important', // Q3: Delegate
+    'not-urgent-not-important', // Q4: Eliminate
+]);
+/**
+ * Relationship types between items
+ */
+export const RelationType = z.enum([
+    'implements',
+    'implemented-by',
+    'tested-by',
+    'tests',
+    'blocks',
+    'blocked-by',
+    'relates-to',
+    'depends-on',
+    'required-by',
+    'supersedes',
+    'superseded-by',
+]);
+/**
+ * Linked items structure
+ */
+export const LinkedItems = z
+    .object({
+    implements: z.array(z.string()),
+    'implemented-by': z.array(z.string()),
+    'tested-by': z.array(z.string()),
+    tests: z.array(z.string()),
+    blocks: z.array(z.string()),
+    'blocked-by': z.array(z.string()),
+    'relates-to': z.array(z.string()),
+    'depends-on': z.array(z.string()),
+    'required-by': z.array(z.string()),
+    supersedes: z.array(z.string()),
+    'superseded-by': z.array(z.string()),
+})
+    .default({
+    implements: [],
+    'implemented-by': [],
+    'tested-by': [],
+    tests: [],
+    blocks: [],
+    'blocked-by': [],
+    'relates-to': [],
+    'depends-on': [],
+    'required-by': [],
+    supersedes: [],
+    'superseded-by': [],
+});
+/**
+ * Git commit reference
+ */
+export const GitCommit = z.object({
+    hash: z.string(),
+    message: z.string(),
+    author: z.string(),
+    timestamp: z.string(),
+    branch: z.string().optional(),
+});
+/**
+ * Core item schema - metadata stored as JSON
+ */
+export const ItemMetadata = z.object({
+    id: z.string().regex(/^(EPIC|STORY|TASK|REQ|FEAT|BUG|SPIKE|TEST)-\d{3,}$/),
+    type: ItemType,
+    category: z.string().default('general'),
+    title: z.string().min(1).max(200),
+    status: ItemStatus.default('draft'),
+    priority: Priority.default('medium'),
+    eisenhower: EisenhowerQuadrant.optional(),
+    superseded_by: z.string().optional(),
+    created: z.string().datetime(),
+    updated: z.string().datetime(),
+    author: z.string().email().optional(),
+    assignee: z.string().email().optional(),
+    affected_paths: z.array(z.string()).default([]),
+    linked_items: LinkedItems,
+    tags: z.array(z.string()).default([]),
+    estimated_effort: z.string().optional(),
+    actual_effort: z.string().optional(),
+    commits: z.array(GitCommit).default([]),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+});
+/**
+ * Configuration schema for .devsteps/config.json
+ */
+export const DevStepsConfig = z.object({
+    version: z.string().default('0.1.0'),
+    project_name: z.string(),
+    project_id: z.string(),
+    created: z.string().datetime(),
+    updated: z.string().datetime(),
+    settings: z
+        .object({
+        methodology: Methodology.default('scrum'),
+        auto_increment: z.boolean(),
+        git_integration: z.boolean(),
+        default_author: z.string().email().optional(),
+        item_types: z.array(ItemType),
+        item_prefixes: z.record(z.string(), z.string()),
+    })
+        .default({
+        methodology: 'scrum',
+        auto_increment: true,
+        git_integration: true,
+        item_types: ['epic', 'story', 'task', 'bug', 'spike', 'test'],
+        item_prefixes: {
+            epic: 'EPIC',
+            story: 'STORY',
+            task: 'TASK',
+            bug: 'BUG',
+            spike: 'SPIKE',
+            test: 'TEST',
+        },
+    }),
+});
+/**
+ * Index schema for .devsteps/index.json
+ */
+export const DevStepsIndex = z.object({
+    items: z.array(z.object({
+        id: z.string(),
+        type: ItemType,
+        title: z.string(),
+        status: ItemStatus,
+        priority: Priority,
+        updated: z.string().datetime(),
+    })),
+    last_updated: z.string().datetime(),
+    counters: z.record(z.string(), z.number()).default({}),
+    archived_items: z
+        .array(z.object({
+        id: z.string(),
+        type: ItemType,
+        title: z.string(),
+        archived_at: z.string().datetime(),
+        original_status: ItemStatus,
+    }))
+        .default([]),
+    stats: z
+        .object({
+        total: z.number(),
+        by_type: z.record(z.string(), z.number()),
+        by_status: z.record(z.string(), z.number()),
+        archived: z.number().optional(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/schemas/project.d.ts

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+/**
+ * Schema for PROJECT.md metadata section
+ */
+export declare const ProjectMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    created: z.ZodString;
+    last_updated: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for Quick Context (< 5K tokens target)
+ */
+export declare const QuickContextSchema: z.ZodObject<{
+    tech_stack: z.ZodRecord<z.ZodString, z.ZodString>;
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        purpose: z.ZodString;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    project_type: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for Standard Context (< 20K tokens target)
+ */
+export declare const StandardContextSchema: z.ZodObject<{
+    tech_stack: z.ZodRecord<z.ZodString, z.ZodString>;
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        purpose: z.ZodString;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    project_type: z.ZodString;
+    architecture: z.ZodString;
+    design_decisions: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        decision: z.ZodString;
+        rationale: z.ZodString;
+        tradeoffs: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    module_responsibilities: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for Deep Context (< 50K tokens target)
+ */
+export declare const DeepContextSchema: z.ZodObject<{
+    tech_stack: z.ZodRecord<z.ZodString, z.ZodString>;
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        purpose: z.ZodString;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    project_type: z.ZodString;
+    architecture: z.ZodString;
+    design_decisions: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        decision: z.ZodString;
+        rationale: z.ZodString;
+        tradeoffs: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    module_responsibilities: z.ZodRecord<z.ZodString, z.ZodString>;
+    coding_standards: z.ZodString;
+    testing_strategy: z.ZodString;
+    known_issues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    technical_debt: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Complete PROJECT.md structure
+ */
+export declare const ProjectContextSchema: z.ZodObject<{
+    metadata: z.ZodObject<{
+        name: z.ZodString;
+        created: z.ZodString;
+        last_updated: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>;
+    quick: z.ZodObject<{
+        tech_stack: z.ZodRecord<z.ZodString, z.ZodString>;
+        packages: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            purpose: z.ZodString;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        project_type: z.ZodString;
+    }, z.core.$strip>;
+    standard: z.ZodOptional<z.ZodObject<{
+        tech_stack: z.ZodRecord<z.ZodString, z.ZodString>;
+        packages: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            purpose: z.ZodString;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        project_type: z.ZodString;
+        architecture: z.ZodString;
+        design_decisions: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            decision: z.ZodString;
+            rationale: z.ZodString;
+            tradeoffs: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        module_responsibilities: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
+    deep: z.ZodOptional<z.ZodObject<{
+        tech_stack: z.ZodRecord<z.ZodString, z.ZodString>;
+        packages: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            purpose: z.ZodString;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        project_type: z.ZodString;
+        architecture: z.ZodString;
+        design_decisions: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            decision: z.ZodString;
+            rationale: z.ZodString;
+            tradeoffs: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        module_responsibilities: z.ZodRecord<z.ZodString, z.ZodString>;
+        coding_standards: z.ZodString;
+        testing_strategy: z.ZodString;
+        known_issues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        technical_debt: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectMetadata = z.infer<typeof ProjectMetadataSchema>;
+export type QuickContext = z.infer<typeof QuickContextSchema>;
+export type StandardContext = z.infer<typeof StandardContextSchema>;
+export type DeepContext = z.infer<typeof DeepContextSchema>;
+export type ProjectContext = z.infer<typeof ProjectContextSchema>;
+/**
+ * Context level type
+ */
+export type ContextLevel = 'quick' | 'standard' | 'deep';
+//# sourceMappingURL=project.d.ts.map

package/dist/schemas/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/schemas/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;iBAU7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAWhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;iBAK5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK/B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC"}

package/dist/schemas/project.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+/**
+ * Schema for PROJECT.md metadata section
+ */
+export const ProjectMetadataSchema = z.object({
+    name: z.string(),
+    created: z.string().datetime(),
+    last_updated: z.string().datetime(),
+    version: z.string(),
+});
+/**
+ * Schema for Quick Context (< 5K tokens target)
+ */
+export const QuickContextSchema = z.object({
+    tech_stack: z.record(z.string(), z.string()),
+    packages: z.array(z.object({
+        name: z.string(),
+        purpose: z.string(),
+        dependencies: z.array(z.string()).optional(),
+    })),
+    project_type: z.string(),
+});
+/**
+ * Schema for Standard Context (< 20K tokens target)
+ */
+export const StandardContextSchema = QuickContextSchema.extend({
+    architecture: z.string(),
+    design_decisions: z.array(z.object({
+        title: z.string(),
+        decision: z.string(),
+        rationale: z.string(),
+        tradeoffs: z.string().optional(),
+    })),
+    module_responsibilities: z.record(z.string(), z.string()),
+});
+/**
+ * Schema for Deep Context (< 50K tokens target)
+ */
+export const DeepContextSchema = StandardContextSchema.extend({
+    coding_standards: z.string(),
+    testing_strategy: z.string(),
+    known_issues: z.array(z.string()).optional(),
+    technical_debt: z.array(z.string()).optional(),
+});
+/**
+ * Complete PROJECT.md structure
+ */
+export const ProjectContextSchema = z.object({
+    metadata: ProjectMetadataSchema,
+    quick: QuickContextSchema,
+    standard: StandardContextSchema.optional(),
+    deep: DeepContextSchema.optional(),
+});
+//# sourceMappingURL=project.js.map

package/dist/schemas/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/schemas/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KAC7C,CAAC,CACH;IACD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IAC7D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CACvB,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC,CACH;IACD,uBAAuB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,MAAM,CAAC;IAC5D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,qBAAqB;IAC/B,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IAC1C,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}

package/dist/schemas/relationships.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Relationship type definitions
+ * Separates hierarchy relationships (strict validation) from flexible relationships (no validation)
+ */
+/**
+ * Hierarchy relationships enforce parent-child rules
+ * - implements/implemented-by: Epic → Story → Task structure
+ */
+export declare const HIERARCHY_RELATIONSHIPS: readonly ["implements", "implemented-by"];
+/**
+ * Flexible relationships allow connections between any item types
+ * - relates-to: Generic association
+ * - blocks/blocked-by: Blocking dependencies
+ * - depends-on/required-by: Technical dependencies
+ * - tested-by/tests: Testing relationships
+ * - supersedes/superseded-by: Version/replacement tracking
+ */
+export declare const FLEXIBLE_RELATIONSHIPS: readonly ["relates-to", "blocks", "blocked-by", "depends-on", "required-by", "tested-by", "tests", "supersedes", "superseded-by"];
+export type HierarchyRelation = (typeof HIERARCHY_RELATIONSHIPS)[number];
+export type FlexibleRelation = (typeof FLEXIBLE_RELATIONSHIPS)[number];
+export type RelationType = HierarchyRelation | FlexibleRelation;
+/**
+ * Check if a relation type requires hierarchy validation
+ */
+export declare function isHierarchyRelation(relationType: string): relationType is HierarchyRelation;
+/**
+ * Check if a relation type is flexible (no validation)
+ */
+export declare function isFlexibleRelation(relationType: string): relationType is FlexibleRelation;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/schemas/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/schemas/relationships.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,2CAA4C,CAAC;AAEjF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,mIAUzB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,iBAAiB,CAE3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,IAAI,gBAAgB,CAEzF"}

package/dist/schemas/relationships.js

@@ -0,0 +1,41 @@
+/**
+ * Relationship type definitions
+ * Separates hierarchy relationships (strict validation) from flexible relationships (no validation)
+ */
+/**
+ * Hierarchy relationships enforce parent-child rules
+ * - implements/implemented-by: Epic → Story → Task structure
+ */
+export const HIERARCHY_RELATIONSHIPS = ['implements', 'implemented-by'];
+/**
+ * Flexible relationships allow connections between any item types
+ * - relates-to: Generic association
+ * - blocks/blocked-by: Blocking dependencies
+ * - depends-on/required-by: Technical dependencies
+ * - tested-by/tests: Testing relationships
+ * - supersedes/superseded-by: Version/replacement tracking
+ */
+export const FLEXIBLE_RELATIONSHIPS = [
+    'relates-to',
+    'blocks',
+    'blocked-by',
+    'depends-on',
+    'required-by',
+    'tested-by',
+    'tests',
+    'supersedes',
+    'superseded-by',
+];
+/**
+ * Check if a relation type requires hierarchy validation
+ */
+export function isHierarchyRelation(relationType) {
+    return HIERARCHY_RELATIONSHIPS.includes(relationType);
+}
+/**
+ * Check if a relation type is flexible (no validation)
+ */
+export function isFlexibleRelation(relationType) {
+    return FLEXIBLE_RELATIONSHIPS.includes(relationType);
+}
+//# sourceMappingURL=relationships.js.map

package/dist/schemas/relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../src/schemas/relationships.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAU,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,WAAW;IACX,OAAO;IACP,YAAY;IACZ,eAAe;CACP,CAAC;AAMX;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,YAAiC,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,OAAO,sBAAsB,CAAC,QAAQ,CAAC,YAAgC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/types/commands.d.ts

@@ -0,0 +1,92 @@
+import type { ItemType, Priority } from '../schemas/index.js';
+/**
+ * Central type shortcuts mapping
+ */
+export declare const TYPE_SHORTCUTS: Record<string, ItemType>;
+/**
+ * Command argument types - central source of truth
+ */
+export interface AddItemCommandArgs {
+    type: string;
+    title: string;
+    description?: string;
+    category?: string;
+    priority?: string;
+    eisenhower?: string;
+    tags?: string[];
+    assignee?: string;
+    paths?: string[];
+}
+export interface UpdateItemCommandArgs {
+    id: string;
+    status?: string;
+    priority?: string;
+    eisenhower?: string;
+    superseded_by?: string;
+    title?: string;
+    description?: string;
+    assignee?: string;
+    tags?: string[];
+    paths?: string[];
+}
+export interface ListItemsCommandArgs {
+    type?: string;
+    status?: string;
+    priority?: string;
+    eisenhower?: string;
+    assignee?: string;
+    tags?: string[];
+    archived?: boolean;
+    limit?: string;
+}
+export interface SearchItemsCommandArgs {
+    query: string;
+    type?: string;
+    limit?: string;
+}
+export interface StatusCommandArgs {
+    detailed?: boolean;
+}
+export interface TraceCommandArgs {
+    id: string;
+    depth?: string;
+}
+export interface ExportCommandArgs {
+    format?: string;
+    output?: string;
+    types?: string[];
+}
+export interface ArchiveCommandArgs {
+    id: string;
+}
+export interface PurgeCommandArgs {
+    status?: string[];
+    type?: string;
+}
+/**
+ * Response types
+ */
+export interface CommandSuccessResponse {
+    success: true;
+    message: string;
+    [key: string]: unknown;
+}
+export interface CommandErrorResponse {
+    success: false;
+    error: string;
+}
+export type CommandResponse = CommandSuccessResponse | CommandErrorResponse;
+/**
+ * Index item summary type (from index.json)
+ */
+export interface IndexItem {
+    id: string;
+    type: ItemType;
+    title: string;
+    status: string;
+    priority: Priority;
+    updated: string;
+    tags?: string[];
+    category?: string;
+}
+//# sourceMappingURL=commands.d.ts.map

package/dist/types/commands.d.ts.map

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

package/dist/types/commands.js

@@ -0,0 +1,14 @@
+/**
+ * Central type shortcuts mapping
+ */
+export const TYPE_SHORTCUTS = {
+    epic: 'epic',
+    story: 'story',
+    task: 'task',
+    req: 'requirement',
+    feat: 'feature',
+    bug: 'bug',
+    spike: 'spike',
+    test: 'test',
+};
+//# sourceMappingURL=commands.js.map

package/dist/types/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,aAAa;IAClB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { ItemType, ItemStatus, Priority, RelationType, LinkedItems, GitCommit, ItemMetadata, DevStepsConfig, DevStepsIndex, } from '../schemas/index.js';
+export * from './commands.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export * from './commands.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAYA,cAAc,eAAe,CAAC"}