@lwelliott/cortex-cli 1.0.3

package/dist/state-machines/sprint-state.js

@@ -0,0 +1,64 @@
+"use strict";
+// Sprint state machine
+// Encodes the PLANNING → IN EXECUTION → CLOSING → CLOSED transition table
+// Implements AD-0008: Centralized State Machines + Owner Validation
+// + FS-SS-004-0007 (transition sprint status)
+// + FS-SS-004-0008 (reject invalid sprint transition)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_SPRINT_STATUSES = void 0;
+exports.isValidSprintStatus = isValidSprintStatus;
+exports.getAllowedSprintTransitions = getAllowedSprintTransitions;
+exports.isValidSprintTransition = isValidSprintTransition;
+exports.getSprintAutoTimestamps = getSprintAutoTimestamps;
+/** Valid sprint status values */
+exports.VALID_SPRINT_STATUSES = [
+    'PLANNING',
+    'IN EXECUTION',
+    'CLOSING',
+    'CLOSED',
+];
+/**
+ * Transition table for sprint statuses.
+ * Maps each current status to the set of allowed target statuses.
+ */
+const TRANSITIONS = {
+    'PLANNING': ['IN EXECUTION'],
+    'IN EXECUTION': ['CLOSING'],
+    'CLOSING': ['CLOSED'],
+    'CLOSED': [], // Terminal state
+};
+/**
+ * Check if a given string is a valid SprintStatus value.
+ */
+function isValidSprintStatus(status) {
+    return exports.VALID_SPRINT_STATUSES.includes(status);
+}
+/**
+ * Get all allowed target statuses from a given current status.
+ */
+function getAllowedSprintTransitions(current) {
+    return TRANSITIONS[current] ?? [];
+}
+/**
+ * Check if a transition from current to target is valid.
+ */
+function isValidSprintTransition(current, target) {
+    return TRANSITIONS[current]?.includes(target) ?? false;
+}
+/**
+ * Auto-populate timestamps for sprint status transitions.
+ * - PLANNING → IN EXECUTION: set started_at
+ * - * → CLOSED: set closed_at
+ */
+function getSprintAutoTimestamps(current, target) {
+    const now = new Date().toISOString();
+    const result = {};
+    if (current !== 'IN EXECUTION' && target === 'IN EXECUTION') {
+        result.started_at = now;
+    }
+    if (target === 'CLOSED') {
+        result.closed_at = now;
+    }
+    return result;
+}
+//# sourceMappingURL=sprint-state.js.map

package/dist/state-machines/sprint-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-state.js","sourceRoot":"","sources":["../../src/state-machines/sprint-state.ts"],"names":[],"mappings":";AAAA,uBAAuB;AACvB,0EAA0E;AAC1E,oEAAoE;AACpE,8CAA8C;AAC9C,sDAAsD;;;AA0BtD,kDAEC;AAKD,kEAEC;AAKD,0DAEC;AAOD,0DAgBC;AA7DD,iCAAiC;AACpB,QAAA,qBAAqB,GAAmB;IACnD,UAAU;IACV,cAAc;IACd,SAAS;IACT,QAAQ;CACT,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAAyC;IACxD,UAAU,EAAE,CAAC,cAAc,CAAC;IAC5B,cAAc,EAAE,CAAC,SAAS,CAAC;IAC3B,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,QAAQ,EAAE,EAAE,EAAE,iBAAiB;CAChC,CAAC;AAEF;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAQ,6BAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,OAAqB;IAC/D,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,OAAqB,EAAE,MAAoB;IACjF,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,OAAqB,EACrB,MAAoB;IAEpB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAgD,EAAE,CAAC;IAE/D,IAAI,OAAO,KAAK,cAAc,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC5D,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/state-machines/task-state.d.ts

@@ -0,0 +1,31 @@
+import type { TaskStatus } from '../models/common';
+/** Valid task status values — Blocked removed per FS-SS-030-0004 */
+export declare const VALID_TASK_STATUSES: TaskStatus[];
+/**
+ * Check if a given string is a valid TaskStatus value.
+ */
+export declare function isValidTaskStatus(status: string): status is TaskStatus;
+/**
+ * Get all allowed target statuses from a given current status.
+ */
+export declare function getAllowedTaskTransitions(current: TaskStatus): TaskStatus[];
+/**
+ * Check if a transition from current to target is valid.
+ */
+export declare function isValidTaskTransition(current: TaskStatus, target: TaskStatus): boolean;
+/**
+ * Get the auto timestamps for a task state transition.
+ * - Any → In Progress: set started_at (if not already set)
+ * - Any → Done: set completed_at
+ */
+export declare function getTaskAutoTimestamps(current: TaskStatus, target: TaskStatus): {
+    started_at?: string;
+    completed_at?: string;
+};
+/**
+ * Captain-only stages for owner validation.
+ * Per AD-0008 (updated per URD-030): Planning and Release require captain.
+ */
+export declare const CAPTAIN_ONLY_STAGES: string[];
+export declare const CAPTAIN_ONLY_STATES: string[];
+//# sourceMappingURL=task-state.d.ts.map

package/dist/state-machines/task-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-state.d.ts","sourceRoot":"","sources":["../../src/state-machines/task-state.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,UAAU,EAO3C,CAAC;AAoBF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,UAAU,CAEtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,CAE3E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,UAAU,GACjB;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAahD;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAA4B,CAAC;AAGrE,eAAO,MAAM,mBAAmB,UAAsB,CAAC"}

package/dist/state-machines/task-state.js

@@ -0,0 +1,83 @@
+"use strict";
+// Task state machine (Kanban lifecycle)
+// Encodes freely reversible primary flow within a stage + Dropped escape
+// Implements AD-0008: Centralized State Machines + Owner Validation
+// + FS-SS-005-0002 (move task between states)
+// + FS-SS-005-0003 (enforce task state machine)
+// + FS-SS-005-0004 (reject invalid task transition)
+// + FS-SS-030-0002 (status reversal within stage)
+// + FS-SS-030-0004 (Blocked status removal)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAPTAIN_ONLY_STATES = exports.CAPTAIN_ONLY_STAGES = exports.VALID_TASK_STATUSES = void 0;
+exports.isValidTaskStatus = isValidTaskStatus;
+exports.getAllowedTaskTransitions = getAllowedTaskTransitions;
+exports.isValidTaskTransition = isValidTaskTransition;
+exports.getTaskAutoTimestamps = getTaskAutoTimestamps;
+/** Valid task status values — Blocked removed per FS-SS-030-0004 */
+exports.VALID_TASK_STATUSES = [
+    'Backlog',
+    'To Do',
+    'In Progress',
+    'In Review',
+    'Done',
+    'Dropped',
+];
+/**
+ * Transition table for task statuses within the same stage.
+ * Maps each current status to the set of allowed target statuses.
+ *
+ * Per FS-SS-030-0002:
+ * Within a stage, any non-Dropped status can transition to any other non-Dropped status
+ * (including reverse moves like Done → In Review). Dropped is the sole escape state,
+ * reachable from any non-Dropped state, and is terminal.
+ */
+const TRANSITIONS = {
+    'Backlog': ['To Do', 'In Progress', 'In Review', 'Done', 'Dropped'],
+    'To Do': ['Backlog', 'In Progress', 'In Review', 'Done', 'Dropped'],
+    'In Progress': ['Backlog', 'To Do', 'In Review', 'Done', 'Dropped'],
+    'In Review': ['Backlog', 'To Do', 'In Progress', 'Done', 'Dropped'],
+    'Done': ['Backlog', 'To Do', 'In Progress', 'In Review', 'Dropped'],
+    'Dropped': [], // Terminal abandon state
+};
+/**
+ * Check if a given string is a valid TaskStatus value.
+ */
+function isValidTaskStatus(status) {
+    return exports.VALID_TASK_STATUSES.includes(status);
+}
+/**
+ * Get all allowed target statuses from a given current status.
+ */
+function getAllowedTaskTransitions(current) {
+    return TRANSITIONS[current] ?? [];
+}
+/**
+ * Check if a transition from current to target is valid.
+ */
+function isValidTaskTransition(current, target) {
+    return TRANSITIONS[current]?.includes(target) ?? false;
+}
+/**
+ * Get the auto timestamps for a task state transition.
+ * - Any → In Progress: set started_at (if not already set)
+ * - Any → Done: set completed_at
+ */
+function getTaskAutoTimestamps(current, target) {
+    const now = new Date().toISOString();
+    const result = {};
+    if (current !== 'In Progress' && target === 'In Progress') {
+        result.started_at = now;
+    }
+    if (target === 'Done') {
+        result.completed_at = now;
+    }
+    return result;
+}
+/**
+ * Captain-only stages for owner validation.
+ * Per AD-0008 (updated per URD-030): Planning and Release require captain.
+ */
+exports.CAPTAIN_ONLY_STAGES = ['Planning', 'Release'];
+// Backward compatibility alias — tests may import CAPTAIN_ONLY_STATES
+exports.CAPTAIN_ONLY_STATES = exports.CAPTAIN_ONLY_STAGES;
+//# sourceMappingURL=task-state.js.map

package/dist/state-machines/task-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-state.js","sourceRoot":"","sources":["../../src/state-machines/task-state.ts"],"names":[],"mappings":";AAAA,wCAAwC;AACxC,yEAAyE;AACzE,oEAAoE;AACpE,8CAA8C;AAC9C,gDAAgD;AAChD,oDAAoD;AACpD,kDAAkD;AAClD,4CAA4C;;;AAmC5C,8CAEC;AAKD,8DAEC;AAKD,sDAEC;AAOD,sDAgBC;AAtED,oEAAoE;AACvD,QAAA,mBAAmB,GAAiB;IAC/C,SAAS;IACT,OAAO;IACP,aAAa;IACb,WAAW;IACX,MAAM;IACN,SAAS;CACV,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,GAAqC;IACpD,SAAS,EAAO,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC;IACxE,OAAO,EAAS,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC;IAC1E,aAAa,EAAG,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC;IACpE,WAAW,EAAK,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC;IACtE,MAAM,EAAU,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC;IAC3E,SAAS,EAAO,EAAE,EAAG,yBAAyB;CAC/C,CAAC;AAEF;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAc;IAC9C,OAAQ,2BAAyC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,OAAmB;IAC3D,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAmB,EAAE,MAAkB;IAC3E,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,OAAmB,EACnB,MAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAmD,EAAE,CAAC;IAElE,IAAI,OAAO,KAAK,aAAa,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC1D,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACU,QAAA,mBAAmB,GAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAErE,sEAAsE;AACzD,QAAA,mBAAmB,GAAG,2BAAmB,CAAC"}