@proletariat/cli 0.3.95 → 0.3.96

package/dist/lib/work-lifecycle/settings.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Work lifecycle settings — column, priority, and review gate configuration.
+ */
+import type { ReviewGateMode } from '../pmo/types.js';
+/**
+ * Database interface for settings access (compatible with better-sqlite3)
+ */
+interface DatabaseLike {
+    prepare(sql: string): {
+        get(...params: unknown[]): unknown;
+        run(...params: unknown[]): unknown;
+    };
+}
+/**
+ * Default column names for work commands (Linear-style workflow)
+ *
+ * Linear-style: Backlog → Planned → In Progress → Review → Done
+ * - planned: Move tickets here when scheduled/assigned
+ * - in_progress: Move tickets here when work starts
+ * - review: Move tickets here when work is ready for review
+ * - done: Move tickets here when work is complete (reviewed/merged)
+ */
+export declare const DEFAULT_WORK_COLUMNS: {
+    readonly planned: "Planned";
+    readonly in_progress: "In Progress";
+    readonly review: "Review";
+    readonly done: "Done";
+};
+export type WorkColumnType = keyof typeof DEFAULT_WORK_COLUMNS;
+/**
+ * Get a work column setting from pmo_settings with fallback to default.
+ * Column matching is case-insensitive.
+ *
+ * Settings keys:
+ * - column_in_progress: Column to move tickets to when work starts
+ * - column_review: Column to move tickets to when work is ready for review
+ * - column_done: Column to move tickets to when work is complete
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @returns The configured column name, or the default if not set
+ */
+export declare function getWorkColumnSetting(db: DatabaseLike, columnType: WorkColumnType): string;
+/**
+ * Set a work column setting in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @param columnName - Name of the column to use
+ */
+export declare function setWorkColumnSetting(db: DatabaseLike, columnType: WorkColumnType, columnName: string): void;
+/**
+ * Find a column by configured name (case-insensitive match).
+ * Returns the actual column name from the board if found, null otherwise.
+ *
+ * @param columnNames - Array of column names from the board
+ * @param targetColumn - The column name to find (from settings or default)
+ * @returns The matching column name, or null if not found
+ */
+export declare function findColumnByName(columnNames: string[], targetColumn: string): string | null;
+/**
+ * Default priority scale (backwards compatible with hardcoded P0-P3).
+ */
+export declare const DEFAULT_PRIORITIES: readonly ["P0", "P1", "P2", "P3"];
+/**
+ * Get the workspace priority scale from pmo_settings.
+ * Returns the user-defined priority scale, or DEFAULT_PRIORITIES if not set.
+ *
+ * Priority values are ordered strings - position in array determines sort order.
+ * Index 0 is highest priority.
+ *
+ * @param db - Database instance
+ * @returns Array of priority strings ordered from highest to lowest
+ */
+export declare function getWorkspacePriorities(db: DatabaseLike): string[];
+/**
+ * Set the workspace priority scale in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param priorities - Array of priority strings ordered from highest to lowest
+ */
+export declare function setWorkspacePriorities(db: DatabaseLike, priorities: string[]): void;
+/**
+ * Check if a value is a valid priority for the workspace.
+ *
+ * @param db - Database instance
+ * @param value - Value to check
+ * @returns true if the value is in the workspace priority scale
+ */
+export declare function isValidWorkspacePriority(db: DatabaseLike, value: string): boolean;
+/**
+ * Get the sort index for a priority value.
+ * Returns the position in the priority array (0 = highest priority).
+ * Returns Infinity for unknown priorities (sorts last).
+ *
+ * @param db - Database instance
+ * @param value - Priority value
+ * @returns Sort index (lower = higher priority)
+ */
+export declare function getPrioritySortIndex(db: DatabaseLike, value: string | undefined | null): number;
+/**
+ * Valid review gate modes.
+ */
+export declare const REVIEW_GATE_MODES: readonly ReviewGateMode[];
+/**
+ * Default review gate mode for workspace.
+ */
+export declare const DEFAULT_REVIEW_GATE: ReviewGateMode;
+/**
+ * Get the workspace review gate default from pmo_settings.
+ * Returns the configured mode, or 'required' if not set.
+ *
+ * @param db - Database instance
+ * @returns The configured review gate mode
+ */
+export declare function getReviewGateSetting(db: DatabaseLike): ReviewGateMode;
+/**
+ * Set the workspace review gate default in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param mode - Review gate mode to set
+ */
+export declare function setReviewGateSetting(db: DatabaseLike, mode: ReviewGateMode): void;
+/**
+ * Check if a value is a valid review gate mode.
+ */
+export declare function isValidReviewGateMode(value: string): value is ReviewGateMode;
+/**
+ * Resolve the effective review gate mode given the hierarchy of overrides.
+ * Most specific wins: per-spawn > per-action > workspace default.
+ *
+ * @param spawnOverride - Value from --review-gate flag on `prlt work start`
+ * @param actionOverride - Value from the action's review_gate column
+ * @param db - Database instance for workspace default lookup
+ * @returns The resolved review gate mode
+ */
+export declare function resolveReviewGate(spawnOverride: ReviewGateMode | undefined, actionOverride: ReviewGateMode | undefined, db: DatabaseLike): ReviewGateMode;
+export {};

package/dist/lib/work-lifecycle/settings.js

@@ -0,0 +1,213 @@
+/**
+ * Work lifecycle settings — column, priority, and review gate configuration.
+ */
+// =============================================================================
+// Work Column Settings
+// =============================================================================
+/**
+ * Default column names for work commands (Linear-style workflow)
+ *
+ * Linear-style: Backlog → Planned → In Progress → Review → Done
+ * - planned: Move tickets here when scheduled/assigned
+ * - in_progress: Move tickets here when work starts
+ * - review: Move tickets here when work is ready for review
+ * - done: Move tickets here when work is complete (reviewed/merged)
+ */
+export const DEFAULT_WORK_COLUMNS = {
+    planned: 'Planned',
+    in_progress: 'In Progress',
+    review: 'Review',
+    done: 'Done',
+};
+/**
+ * Get a work column setting from pmo_settings with fallback to default.
+ * Column matching is case-insensitive.
+ *
+ * Settings keys:
+ * - column_in_progress: Column to move tickets to when work starts
+ * - column_review: Column to move tickets to when work is ready for review
+ * - column_done: Column to move tickets to when work is complete
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @returns The configured column name, or the default if not set
+ */
+export function getWorkColumnSetting(db, columnType) {
+    const settingKey = `column_${columnType}`;
+    const row = db.prepare(`SELECT value FROM pmo_settings WHERE key = ?`).get(settingKey);
+    return row?.value || DEFAULT_WORK_COLUMNS[columnType];
+}
+/**
+ * Set a work column setting in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param columnType - Type of column (in_progress, review, done)
+ * @param columnName - Name of the column to use
+ */
+export function setWorkColumnSetting(db, columnType, columnName) {
+    const settingKey = `column_${columnType}`;
+    db.prepare(`
+    INSERT INTO pmo_settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = ?
+  `).run(settingKey, columnName, columnName);
+}
+/**
+ * Find a column by configured name (case-insensitive match).
+ * Returns the actual column name from the board if found, null otherwise.
+ *
+ * @param columnNames - Array of column names from the board
+ * @param targetColumn - The column name to find (from settings or default)
+ * @returns The matching column name, or null if not found
+ */
+export function findColumnByName(columnNames, targetColumn) {
+    const targetLower = targetColumn.toLowerCase();
+    // First try exact match (case-insensitive)
+    const exactMatch = columnNames.find(col => col.toLowerCase() === targetLower);
+    if (exactMatch)
+        return exactMatch;
+    // Then try partial match (contains)
+    const partialMatch = columnNames.find(col => col.toLowerCase().includes(targetLower) ||
+        targetLower.includes(col.toLowerCase()));
+    return partialMatch || null;
+}
+// =============================================================================
+// Workspace Priority Settings
+// =============================================================================
+/**
+ * Default priority scale (backwards compatible with hardcoded P0-P3).
+ */
+export const DEFAULT_PRIORITIES = ['P0', 'P1', 'P2', 'P3'];
+/**
+ * Settings key for storing workspace priorities.
+ */
+const PRIORITIES_SETTING_KEY = 'priorities';
+/**
+ * Get the workspace priority scale from pmo_settings.
+ * Returns the user-defined priority scale, or DEFAULT_PRIORITIES if not set.
+ *
+ * Priority values are ordered strings - position in array determines sort order.
+ * Index 0 is highest priority.
+ *
+ * @param db - Database instance
+ * @returns Array of priority strings ordered from highest to lowest
+ */
+export function getWorkspacePriorities(db) {
+    const row = db.prepare(`SELECT value FROM pmo_settings WHERE key = ?`).get(PRIORITIES_SETTING_KEY);
+    if (!row)
+        return [...DEFAULT_PRIORITIES];
+    try {
+        const parsed = JSON.parse(row.value);
+        if (Array.isArray(parsed) && parsed.length > 0 && parsed.every((p) => typeof p === 'string')) {
+            return parsed;
+        }
+        return [...DEFAULT_PRIORITIES];
+    }
+    catch {
+        return [...DEFAULT_PRIORITIES];
+    }
+}
+/**
+ * Set the workspace priority scale in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param priorities - Array of priority strings ordered from highest to lowest
+ */
+export function setWorkspacePriorities(db, priorities) {
+    const value = JSON.stringify(priorities);
+    db.prepare(`
+    INSERT INTO pmo_settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = ?
+  `).run(PRIORITIES_SETTING_KEY, value, value);
+}
+/**
+ * Check if a value is a valid priority for the workspace.
+ *
+ * @param db - Database instance
+ * @param value - Value to check
+ * @returns true if the value is in the workspace priority scale
+ */
+export function isValidWorkspacePriority(db, value) {
+    const priorities = getWorkspacePriorities(db);
+    return priorities.includes(value);
+}
+/**
+ * Get the sort index for a priority value.
+ * Returns the position in the priority array (0 = highest priority).
+ * Returns Infinity for unknown priorities (sorts last).
+ *
+ * @param db - Database instance
+ * @param value - Priority value
+ * @returns Sort index (lower = higher priority)
+ */
+export function getPrioritySortIndex(db, value) {
+    if (!value)
+        return Infinity;
+    const priorities = getWorkspacePriorities(db);
+    const index = priorities.indexOf(value);
+    return index !== -1 ? index : Infinity;
+}
+// =============================================================================
+// Review Gate Settings
+// =============================================================================
+/**
+ * Valid review gate modes.
+ */
+export const REVIEW_GATE_MODES = ['required', 'auto', 'post'];
+/**
+ * Default review gate mode for workspace.
+ */
+export const DEFAULT_REVIEW_GATE = 'required';
+/**
+ * Settings key for workspace-level review gate default.
+ */
+const REVIEW_GATE_SETTING_KEY = 'review_gate';
+/**
+ * Get the workspace review gate default from pmo_settings.
+ * Returns the configured mode, or 'required' if not set.
+ *
+ * @param db - Database instance
+ * @returns The configured review gate mode
+ */
+export function getReviewGateSetting(db) {
+    const row = db.prepare(`SELECT value FROM pmo_settings WHERE key = ?`).get(REVIEW_GATE_SETTING_KEY);
+    const value = row?.value;
+    if (value === 'required' || value === 'auto' || value === 'post') {
+        return value;
+    }
+    return DEFAULT_REVIEW_GATE;
+}
+/**
+ * Set the workspace review gate default in pmo_settings.
+ *
+ * @param db - Database instance
+ * @param mode - Review gate mode to set
+ */
+export function setReviewGateSetting(db, mode) {
+    db.prepare(`
+    INSERT INTO pmo_settings (key, value) VALUES (?, ?)
+    ON CONFLICT(key) DO UPDATE SET value = ?
+  `).run(REVIEW_GATE_SETTING_KEY, mode, mode);
+}
+/**
+ * Check if a value is a valid review gate mode.
+ */
+export function isValidReviewGateMode(value) {
+    return REVIEW_GATE_MODES.includes(value);
+}
+/**
+ * Resolve the effective review gate mode given the hierarchy of overrides.
+ * Most specific wins: per-spawn > per-action > workspace default.
+ *
+ * @param spawnOverride - Value from --review-gate flag on `prlt work start`
+ * @param actionOverride - Value from the action's review_gate column
+ * @param db - Database instance for workspace default lookup
+ * @returns The resolved review gate mode
+ */
+export function resolveReviewGate(spawnOverride, actionOverride, db) {
+    if (spawnOverride)
+        return spawnOverride;
+    if (actionOverride)
+        return actionOverride;
+    return getReviewGateSetting(db);
+}
+//# sourceMappingURL=settings.js.map

package/dist/lib/work-lifecycle/settings.js.map

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