@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/schemas/index.d.ts

@@ -1,24 +1,26 @@
 /**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
  * Licensed under the Apache License, Version 2.0
  *
  * Schemas barrel export
  * Re-exports all Zod schemas and derived TypeScript types.
  */
 import { z } from 'zod';
-export * from './analysis.js';
-export * from './cbp-loops.js';
-export * from './cbp-mandate.js';
-export * from './index-refs.schema.js';
+export * from './counters.schema.js';
+export * from './item-id.js';
 export * from './project.js';
 export * from './relationships.js';
+export * from './task-workflow.js';
+export * from './test-profile.js';
+export * from './test-workflow.js';
+export * from './workflow-definition-v2.js';
 /**
  * Methodology types
  */
 export declare const Methodology: z.ZodEnum<{
+    hybrid: "hybrid";
     scrum: "scrum";
     waterfall: "waterfall";
-    hybrid: "hybrid";
 }>;
 export type Methodology = z.infer<typeof Methodology>;
 /**
@@ -26,15 +28,19 @@ export type Methodology = z.infer<typeof Methodology>;
  * Scrum: epic, story, task, bug, spike, test
  * Waterfall: requirement, feature, task, bug, test
  * Hybrid: all of the above
+ * Cross-cutting in every methodology: doc, decision (DEC), question (QST) — EPIC-059
  */
 export declare const ItemType: z.ZodEnum<{
+    bug: "bug";
+    decision: "decision";
+    doc: "doc";
     epic: "epic";
-    story: "story";
-    task: "task";
-    requirement: "requirement";
     feature: "feature";
-    bug: "bug";
+    question: "question";
+    requirement: "requirement";
     spike: "spike";
+    story: "story";
+    task: "task";
     test: "test";
 }>;
 export type ItemType = z.infer<typeof ItemType>;
@@ -42,14 +48,14 @@ export type ItemType = z.infer<typeof ItemType>;
  * Item status lifecycle
  */
 export declare const ItemStatus: z.ZodEnum<{
-    draft: "draft";
-    planned: "planned";
-    "in-progress": "in-progress";
-    review: "review";
-    done: "done";
     blocked: "blocked";
     cancelled: "cancelled";
+    done: "done";
+    draft: "draft";
+    "in-progress": "in-progress";
     obsolete: "obsolete";
+    planned: "planned";
+    review: "review";
 }>;
 export type ItemStatus = z.infer<typeof ItemStatus>;
 /**
@@ -60,33 +66,38 @@ export type ItemStatus = z.infer<typeof ItemStatus>;
  * Q4: Not Urgent + Not Important = Eliminate/Later
  */
 export declare const EisenhowerQuadrant: z.ZodEnum<{
-    "urgent-important": "urgent-important";
     "not-urgent-important": "not-urgent-important";
-    "urgent-not-important": "urgent-not-important";
     "not-urgent-not-important": "not-urgent-not-important";
+    "urgent-important": "urgent-important";
+    "urgent-not-important": "urgent-not-important";
 }>;
 export type EisenhowerQuadrant = z.infer<typeof EisenhowerQuadrant>;
 /**
  * Relationship types between items
  */
 export declare const RelationType: z.ZodEnum<{
-    implements: "implements";
-    "implemented-by": "implemented-by";
-    blocks: "blocks";
     "blocked-by": "blocked-by";
-    "tested-by": "tested-by";
-    tests: "tests";
-    "relates-to": "relates-to";
+    blocks: "blocks";
+    "canonical-for": "canonical-for";
     "depends-on": "depends-on";
+    "derived-from": "derived-from";
+    "documented-by": "documented-by";
+    documents: "documents";
+    "implemented-by": "implemented-by";
+    implements: "implements";
+    "relates-to": "relates-to";
     "required-by": "required-by";
-    supersedes: "supersedes";
     "superseded-by": "superseded-by";
+    supersedes: "supersedes";
+    "tested-by": "tested-by";
+    tests: "tests";
 }>;
 export type RelationType = z.infer<typeof RelationType>;
 /**
- * Linked items structure
+ * Accept legacy items with a partial linked_items object without creating
+ * relationship edges or writing the normalized shape to disk.
  */
-export declare const LinkedItems: z.ZodDefault<z.ZodObject<{
+export declare const LinkedItems: z.ZodPreprocess<z.ZodDefault<z.ZodObject<{
     implements: z.ZodArray<z.ZodString>;
     'implemented-by': z.ZodArray<z.ZodString>;
     'tested-by': z.ZodArray<z.ZodString>;
@@ -98,59 +109,62 @@ export declare const LinkedItems: z.ZodDefault<z.ZodObject<{
     'required-by': z.ZodArray<z.ZodString>;
     supersedes: z.ZodArray<z.ZodString>;
     'superseded-by': z.ZodArray<z.ZodString>;
-}, z.core.$strip>>;
+    'canonical-for': z.ZodArray<z.ZodString>;
+    'derived-from': z.ZodArray<z.ZodString>;
+    'documented-by': z.ZodArray<z.ZodString>;
+    documents: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>, unknown>;
 export type LinkedItems = z.infer<typeof LinkedItems>;
 /**
- * Git commit reference
+ * Durable Git relation: only canonical full commit object IDs are stored.
+ * Legacy object entries are read as their hash during the schema transition.
  */
-export declare const GitCommit: z.ZodObject<{
-    hash: z.ZodString;
-    message: z.ZodString;
-    author: z.ZodString;
-    timestamp: z.ZodString;
-    branch: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type GitCommit = z.infer<typeof GitCommit>;
+export declare const CommitReferences: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodString>>, unknown>;
+export type CommitReferences = z.infer<typeof CommitReferences>;
 /**
  * Core item schema - metadata stored as JSON
  */
 export declare const ItemMetadata: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<{
+        bug: "bug";
+        decision: "decision";
+        doc: "doc";
         epic: "epic";
-        story: "story";
-        task: "task";
-        requirement: "requirement";
         feature: "feature";
-        bug: "bug";
+        question: "question";
+        requirement: "requirement";
         spike: "spike";
+        story: "story";
+        task: "task";
         test: "test";
     }>;
     category: z.ZodDefault<z.ZodString>;
     title: z.ZodString;
     status: z.ZodDefault<z.ZodEnum<{
-        draft: "draft";
-        planned: "planned";
-        "in-progress": "in-progress";
-        review: "review";
-        done: "done";
         blocked: "blocked";
         cancelled: "cancelled";
+        done: "done";
+        draft: "draft";
+        "in-progress": "in-progress";
         obsolete: "obsolete";
+        planned: "planned";
+        review: "review";
     }>>;
     eisenhower: z.ZodDefault<z.ZodEnum<{
-        "urgent-important": "urgent-important";
         "not-urgent-important": "not-urgent-important";
-        "urgent-not-important": "urgent-not-important";
         "not-urgent-not-important": "not-urgent-not-important";
+        "urgent-important": "urgent-important";
+        "urgent-not-important": "urgent-not-important";
     }>>;
     superseded_by: z.ZodOptional<z.ZodString>;
     created: z.ZodString;
     updated: z.ZodString;
+    reviewed_at: z.ZodOptional<z.ZodString>;
     author: z.ZodOptional<z.ZodString>;
     assignee: z.ZodOptional<z.ZodString>;
     affected_paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    linked_items: z.ZodDefault<z.ZodObject<{
+    linked_items: z.ZodPreprocess<z.ZodDefault<z.ZodObject<{
         implements: z.ZodArray<z.ZodString>;
         'implemented-by': z.ZodArray<z.ZodString>;
         'tested-by': z.ZodArray<z.ZodString>;
@@ -162,17 +176,20 @@ export declare const ItemMetadata: z.ZodObject<{
         'required-by': z.ZodArray<z.ZodString>;
         supersedes: z.ZodArray<z.ZodString>;
         'superseded-by': z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>;
+        'canonical-for': z.ZodArray<z.ZodString>;
+        'derived-from': z.ZodArray<z.ZodString>;
+        'documented-by': z.ZodArray<z.ZodString>;
+        documents: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>, unknown>;
     tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
     estimated_effort: z.ZodOptional<z.ZodString>;
     actual_effort: z.ZodOptional<z.ZodString>;
-    commits: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        hash: z.ZodString;
-        message: z.ZodString;
-        author: z.ZodString;
-        timestamp: z.ZodString;
-        branch: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+    commits: z.ZodPreprocess<z.ZodDefault<z.ZodArray<z.ZodString>>, unknown>;
+    test_profile: z.ZodOptional<z.ZodEnum<{
+        "autonomous-guide": "autonomous-guide";
+        "human-guided-guide": "human-guided-guide";
+    }>>;
+    process_definition: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type ItemMetadata = z.infer<typeof ItemMetadata>;
@@ -187,24 +204,37 @@ export declare const DevStepsConfig: z.ZodObject<{
     updated: z.ZodString;
     settings: z.ZodDefault<z.ZodObject<{
         methodology: z.ZodDefault<z.ZodEnum<{
+            hybrid: "hybrid";
             scrum: "scrum";
             waterfall: "waterfall";
-            hybrid: "hybrid";
         }>>;
         auto_increment: z.ZodBoolean;
         git_integration: z.ZodBoolean;
+        commit_hint: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodString]>>;
         default_author: z.ZodOptional<z.ZodString>;
+        done_by: z.ZodOptional<z.ZodEnum<{
+            acceptance: "acceptance";
+            "product-owner": "product-owner";
+        }>>;
+        closeout: z.ZodOptional<z.ZodObject<{
+            secret_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            artifact_dir: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         item_types: z.ZodArray<z.ZodEnum<{
+            bug: "bug";
+            decision: "decision";
+            doc: "doc";
             epic: "epic";
-            story: "story";
-            task: "task";
-            requirement: "requirement";
             feature: "feature";
-            bug: "bug";
+            question: "question";
+            requirement: "requirement";
             spike: "spike";
+            story: "story";
+            task: "task";
             test: "test";
         }>>;
         item_prefixes: z.ZodRecord<z.ZodString, z.ZodString>;
+        box_wip_limit: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type DevStepsConfig = z.infer<typeof DevStepsConfig>;
@@ -215,31 +245,34 @@ export declare const DevStepsIndex: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         type: z.ZodEnum<{
+            bug: "bug";
+            decision: "decision";
+            doc: "doc";
             epic: "epic";
-            story: "story";
-            task: "task";
-            requirement: "requirement";
             feature: "feature";
-            bug: "bug";
+            question: "question";
+            requirement: "requirement";
             spike: "spike";
+            story: "story";
+            task: "task";
             test: "test";
         }>;
         title: z.ZodString;
         status: z.ZodEnum<{
-            draft: "draft";
-            planned: "planned";
-            "in-progress": "in-progress";
-            review: "review";
-            done: "done";
             blocked: "blocked";
             cancelled: "cancelled";
+            done: "done";
+            draft: "draft";
+            "in-progress": "in-progress";
             obsolete: "obsolete";
+            planned: "planned";
+            review: "review";
         }>;
         eisenhower: z.ZodEnum<{
-            "urgent-important": "urgent-important";
             "not-urgent-important": "not-urgent-important";
-            "urgent-not-important": "urgent-not-important";
             "not-urgent-not-important": "not-urgent-not-important";
+            "urgent-important": "urgent-important";
+            "urgent-not-important": "urgent-not-important";
         }>;
         updated: z.ZodString;
     }, z.core.$strip>>;
@@ -248,26 +281,29 @@ export declare const DevStepsIndex: z.ZodObject<{
     archived_items: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         type: z.ZodEnum<{
+            bug: "bug";
+            decision: "decision";
+            doc: "doc";
             epic: "epic";
-            story: "story";
-            task: "task";
-            requirement: "requirement";
             feature: "feature";
-            bug: "bug";
+            question: "question";
+            requirement: "requirement";
             spike: "spike";
+            story: "story";
+            task: "task";
             test: "test";
         }>;
         title: z.ZodString;
         archived_at: z.ZodString;
         original_status: z.ZodEnum<{
-            draft: "draft";
-            planned: "planned";
-            "in-progress": "in-progress";
-            review: "review";
-            done: "done";
             blocked: "blocked";
             cancelled: "cancelled";
+            done: "done";
+            draft: "draft";
+            "in-progress": "in-progress";
             obsolete: "obsolete";
+            planned: "planned";
+            review: "review";
         }>;
     }, z.core.$strip>>>;
     stats: z.ZodOptional<z.ZodObject<{
@@ -278,4 +314,5 @@ export declare const DevStepsIndex: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type DevStepsIndex = z.infer<typeof DevStepsIndex>;
+export * from './coord.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,cAAc,eAAe,CAAC;AAE9B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,WAAW;;;;EAA2C,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;EASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;EASrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAYvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;kBA0BpB,CAAC;AACL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;iBAMpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAE5C;;GAEG;AAEH,eAAO,MAAM,WAAW;;;;EAA2C,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;EAYnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;EASrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;EAgBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAyCxD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;4BAIvB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAetD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iEAOe,CAAC;AAC7C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,cAAc,YAAY,CAAC"}

package/dist/schemas/index.js

@@ -1,21 +1,22 @@
 /**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
  * Licensed under the Apache License, Version 2.0
  *
  * Schemas barrel export
  * Re-exports all Zod schemas and derived TypeScript types.
  */
 import { z } from 'zod';
-// Context Budget Protocol schemas
-export * from './analysis.js';
-// CBP Loop control schemas: RejectionFeedback, IterationSignal, EscalationSignal
-export * from './cbp-loops.js';
-// CBP Tier-2 schemas: Mandate ↔ MandateResult (Tier-1 ↔ Tier-2)
-export * from './cbp-mandate.js';
-export * from './index-refs.schema.js';
+import { itemIdPattern } from './item-id.js';
+import { TestProfile } from './test-profile.js';
+export * from './counters.schema.js';
+export * from './item-id.js';
 // Re-export project context schemas
 export * from './project.js';
 export * from './relationships.js';
+export * from './task-workflow.js';
+export * from './test-profile.js';
+export * from './test-workflow.js';
+export * from './workflow-definition-v2.js';
 /**
  * Methodology types
  */
@@ -25,6 +26,7 @@ export const Methodology = z.enum(['scrum', 'waterfall', 'hybrid']);
  * Scrum: epic, story, task, bug, spike, test
  * Waterfall: requirement, feature, task, bug, test
  * Hybrid: all of the above
+ * Cross-cutting in every methodology: doc, decision (DEC), question (QST) — EPIC-059
  */
 export const ItemType = z.enum([
     'epic',
@@ -35,6 +37,9 @@ export const ItemType = z.enum([
     'bug',
     'spike',
     'test',
+    'doc',
+    'decision',
+    'question',
 ]);
 /**
  * Item status lifecycle
@@ -77,25 +82,15 @@ export const RelationType = z.enum([
     'required-by',
     'supersedes',
     'superseded-by',
+    'canonical-for',
+    'derived-from',
+    'documented-by',
+    'documents',
 ]);
 /**
  * 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({
+const linkedItemDefaults = {
     implements: [],
     'implemented-by': [],
     'tested-by': [],
@@ -107,22 +102,63 @@ export const LinkedItems = z
     'required-by': [],
     supersedes: [],
     'superseded-by': [],
+    'canonical-for': [],
+    'derived-from': [],
+    'documented-by': [],
+    documents: [],
+};
+const LinkedItemsShape = 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()),
+    'canonical-for': z.array(z.string()),
+    'derived-from': z.array(z.string()),
+    'documented-by': z.array(z.string()),
+    documents: z.array(z.string()),
 });
 /**
- * Git commit reference
+ * Accept legacy items with a partial linked_items object without creating
+ * relationship edges or writing the normalized shape to disk.
+ */
+export const LinkedItems = z.preprocess((value) => value === undefined ? value : { ...linkedItemDefaults, ...value }, LinkedItemsShape.default(linkedItemDefaults));
+/**
+ * Legacy Git commit reference shape accepted during schema migration.
  */
-export const GitCommit = z.object({
+const LegacyGitCommit = z.object({
     hash: z.string(),
     message: z.string(),
     author: z.string(),
     timestamp: z.string(),
     branch: z.string().optional(),
 });
+const CanonicalCommitHash = z.string().regex(/^[0-9a-f]{40}$/i, 'Expected a full Git SHA-1');
+/**
+ * Durable Git relation: only canonical full commit object IDs are stored.
+ * Legacy object entries are read as their hash during the schema transition.
+ */
+export const CommitReferences = z.preprocess((value) => {
+    if (!Array.isArray(value))
+        return value;
+    return value.map((entry) => {
+        if (typeof entry === 'string')
+            return entry.toLowerCase();
+        const legacy = LegacyGitCommit.safeParse(entry);
+        return legacy.success ? legacy.data.hash.toLowerCase() : entry;
+    });
+}, z.array(CanonicalCommitHash).default([]));
 /**
  * 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,}$/),
+    id: z.string().regex(itemIdPattern(3)),
     type: ItemType,
     category: z.string().default('general'),
     title: z.string().min(1).max(200),
@@ -131,6 +167,7 @@ export const ItemMetadata = z.object({
     superseded_by: z.string().optional(),
     created: z.string().datetime(),
     updated: z.string().datetime(),
+    reviewed_at: z.string().datetime().optional(),
     author: z.string().email().optional(),
     assignee: z.string().email().optional(),
     affected_paths: z.array(z.string()).default([]),
@@ -138,7 +175,9 @@ export const ItemMetadata = z.object({
     tags: z.array(z.string()).default([]),
     estimated_effort: z.string().optional(),
     actual_effort: z.string().optional(),
-    commits: z.array(GitCommit).default([]),
+    commits: CommitReferences,
+    test_profile: TestProfile.optional(),
+    process_definition: z.record(z.string(), z.unknown()).optional(),
     metadata: z.record(z.string(), z.unknown()).default({}),
 });
 /**
@@ -155,9 +194,24 @@ export const DevStepsConfig = z.object({
         methodology: Methodology.default('scrum'),
         auto_increment: z.boolean(),
         git_integration: z.boolean(),
+        /**
+         * Commit advice after add and completion (BUG-163): absent for the neutral default, `false`
+         * for none, or the project's template with {id}, {title}, {type}, {event}, {paths}.
+         */
+        commit_hint: z.union([z.literal(false), z.string().min(1).max(500)]).optional(),
         default_author: z.string().email().optional(),
+        /** Who may complete accepted items; absence retains legacy acceptance behavior. */
+        done_by: z.enum(['product-owner', 'acceptance']).optional(),
+        /** Session close-out (EPIC-061): extra secret path patterns and the gitignored artefact folder. */
+        closeout: z
+            .object({
+            secret_patterns: z.array(z.string()).optional(),
+            artifact_dir: z.string().optional(),
+        })
+            .optional(),
         item_types: z.array(ItemType),
         item_prefixes: z.record(z.string(), z.string()),
+        box_wip_limit: z.number().int().min(1).default(10),
     })
         .default({
         methodology: 'scrum',
@@ -172,6 +226,7 @@ export const DevStepsConfig = z.object({
             spike: 'SPIKE',
             test: 'TEST',
         },
+        box_wip_limit: 10,
     }),
 });
 /**
@@ -206,4 +261,5 @@ export const DevStepsIndex = z.object({
     })
         .optional(),
 });
+export * from './coord.js';
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

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

package/dist/schemas/item-id.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Item ID prefixes: the one map from item type to ID prefix, and the ID patterns built from it.
+ */
+import type { ItemType } from './index.js';
+/** ID prefix per item type; IDs, counter keys and every ID pattern derive from this map. */
+export declare const ITEM_TYPE_PREFIXES: Readonly<Record<ItemType, string>>;
+/**
+ * A work item ID such as `DEC-007`: group 1 is the prefix, group 2 the number with at least
+ * `minDigits` digits. An unlisted prefix never matches, so a new type needs its prefix above.
+ */
+export declare function itemIdPattern(minDigits?: number): RegExp;
+//# sourceMappingURL=item-id.d.ts.map

package/dist/schemas/item-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-id.d.ts","sourceRoot":"","sources":["../../src/schemas/item-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAYjE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,SAAI,GAAG,MAAM,CAGnD"}

package/dist/schemas/item-id.js

@@ -0,0 +1,29 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Item ID prefixes: the one map from item type to ID prefix, and the ID patterns built from it.
+ */
+/** ID prefix per item type; IDs, counter keys and every ID pattern derive from this map. */
+export const ITEM_TYPE_PREFIXES = {
+    epic: 'EPIC',
+    story: 'STORY',
+    task: 'TASK',
+    requirement: 'REQ',
+    feature: 'FEAT',
+    bug: 'BUG',
+    spike: 'SPIKE',
+    test: 'TEST',
+    doc: 'DOC',
+    decision: 'DEC',
+    question: 'QST',
+};
+/**
+ * A work item ID such as `DEC-007`: group 1 is the prefix, group 2 the number with at least
+ * `minDigits` digits. An unlisted prefix never matches, so a new type needs its prefix above.
+ */
+export function itemIdPattern(minDigits = 1) {
+    const prefixes = Object.values(ITEM_TYPE_PREFIXES).join('|');
+    return new RegExp(`^(${prefixes})-(\\d{${minDigits},})$`);
+}
+//# sourceMappingURL=item-id.js.map