@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/constants/step-tools.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STEP_CHAIN_PARENT = exports.STEP_TOOL_REGISTRY = exports.WORKFLOW_TOOLS = void 0;
+exports.getToolsForStep = getToolsForStep;
+exports.WORKFLOW_TOOLS = {
+    web_search: { id: 'web_search', description: 'OpenAI built-in web search.', proposalOnly: false, category: 'read' },
+    file_search: { id: 'file_search', description: 'OpenAI built-in file/vector store search.', proposalOnly: false, category: 'read' },
+    db_introspect: { id: 'db_introspect', description: 'Read-only Supabase schema introspection.', proposalOnly: false, category: 'read' },
+    db_validate_migration: { id: 'db_validate_migration', description: 'Dry-run a migration SQL against a temp clone (read-only).', proposalOnly: false, category: 'read' },
+    repo_scan: { id: 'repo_scan', description: 'Scan a connected repository for files / structure.', proposalOnly: false, category: 'read' },
+    repo_get_file_tree: { id: 'repo_get_file_tree', description: 'Return the file tree of a connected repo.', proposalOnly: false, category: 'read' },
+    code_write_proposal: { id: 'code_write_proposal', description: 'Propose code changes (no commit). Persisted as a proposal.', proposalOnly: true, category: 'propose' },
+    github_create_pr_proposal: { id: 'github_create_pr_proposal', description: 'Propose a GitHub PR (recorded; no PR is opened in this sprint).', proposalOnly: true, category: 'propose' },
+    knowledge_query: { id: 'knowledge_query', description: 'Query the project knowledge base.', proposalOnly: false, category: 'read' },
+    query_route_inventory: { id: 'query_route_inventory', description: 'Read-only page/API route inventory from repo scan.', proposalOnly: false, category: 'read' },
+    query_workflow_registry: { id: 'query_workflow_registry', description: 'Read-only workflow registry entries from repo scan.', proposalOnly: false, category: 'read' },
+    query_code_relationships: { id: 'query_code_relationships', description: 'Read-only knowledge graph edges for code relationships.', proposalOnly: false, category: 'read' },
+};
+/** Tools allowed PER WORKFLOW STEP. SSOT — no route file may hardcode tools. */
+exports.STEP_TOOL_REGISTRY = {
+    specify: ['web_search', 'file_search'],
+    plan: ['web_search', 'file_search'],
+    schema: ['db_introspect', 'db_validate_migration'],
+    repository: ['repo_scan', 'repo_get_file_tree', 'query_route_inventory', 'query_workflow_registry', 'query_code_relationships'],
+    implement: ['code_write_proposal', 'github_create_pr_proposal'],
+    knowledge: ['file_search', 'knowledge_query'],
+    // Default empty for steps not yet wired:
+    api: [],
+    ui: [],
+    constitution: [],
+    tasks: [],
+    review: [],
+    compliance: [],
+    analytics: [],
+    pipeline: [],
+};
+/** Resolve the allowed tool list for a workflow step. Returns [] for unknown steps. */
+function getToolsForStep(stepId) {
+    return exports.STEP_TOOL_REGISTRY[stepId] ?? [];
+}
+/** Prior workflow step (by workflow_step_id) used for OpenAI previous_response_id chaining. */
+exports.STEP_CHAIN_PARENT = {
+    specify: undefined,
+    plan: 'specify',
+    schema: 'plan',
+    api: 'schema',
+    ui: 'plan',
+    constitution: 'specify',
+    tasks: 'plan',
+    implement: 'tasks',
+    review: 'implement',
+    compliance: 'review',
+};

package/dist/constants/workflow-agent-defaults.d.ts

@@ -0,0 +1,4 @@
+/** Display label for spec/generate when DB agent name and role title are absent. */
+export declare const SPEC_GENERATE_DEFAULT_AGENT_DISPLAY_NAME: string;
+/** Display label for constitution/generate when role resolution yields no title. */
+export declare const CONSTITUTION_GENERATE_DEFAULT_AGENT_DISPLAY_NAME: string;

package/dist/constants/workflow-agent-defaults.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONSTITUTION_GENERATE_DEFAULT_AGENT_DISPLAY_NAME = exports.SPEC_GENERATE_DEFAULT_AGENT_DISPLAY_NAME = void 0;
+const AGENT_ROLES_1 = require("./AGENT_ROLES");
+function roleTitle(roleId) {
+    const r = AGENT_ROLES_1.AGENT_ROLES.find((x) => x.id === roleId);
+    if (r === undefined) {
+        throw new Error(`workflow-agent-defaults: missing role ${roleId}`);
+    }
+    return r.title;
+}
+/** Display label for spec/generate when DB agent name and role title are absent. */
+exports.SPEC_GENERATE_DEFAULT_AGENT_DISPLAY_NAME = roleTitle("spec-engineer");
+/** Display label for constitution/generate when role resolution yields no title. */
+exports.CONSTITUTION_GENERATE_DEFAULT_AGENT_DISPLAY_NAME = roleTitle("compliance-officer");

package/dist/constants/workflow-api-errors.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Workflow API error codes — SSOT for step preflight and guard responses.
+ */
+export declare const IMPLEMENT_BLOCKED_NO_TASKS: "IMPLEMENT_BLOCKED_NO_TASKS";
+export declare const IMPLEMENT_BLOCKED_NO_TASKS_MESSAGE: "Generate Tasks before running Implement.";

package/dist/constants/workflow-api-errors.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Workflow API error codes — SSOT for step preflight and guard responses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPLEMENT_BLOCKED_NO_TASKS_MESSAGE = exports.IMPLEMENT_BLOCKED_NO_TASKS = void 0;
+exports.IMPLEMENT_BLOCKED_NO_TASKS = "IMPLEMENT_BLOCKED_NO_TASKS";
+exports.IMPLEMENT_BLOCKED_NO_TASKS_MESSAGE = "Generate Tasks before running Implement.";

package/dist/constants/workflow-phase-groups.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Groups SSOT workflow step ids (`constants/workflow`) into coarse model-policy phases.
+ * `WORKFLOW_STEPS_BY_PHASE_GROUP` is derived from `WORKFLOW_PHASE_GROUP_BY_STEP` and
+ * preserves `WORKFLOW_STEPS` order (plus `monitor`).
+ */
+export declare const WORKFLOW_PHASE_GROUP_BY_STEP: {
+    readonly integrations: "planning";
+    readonly repo: "planning";
+    readonly ingest: "planning";
+    readonly team: "planning";
+    readonly specify: "planning";
+    readonly argument_map: "planning";
+    readonly plan: "planning";
+    readonly schema: "planning";
+    readonly counterclaim_framework: "planning";
+    readonly api: "planning";
+    readonly ui: "planning";
+    readonly tasks: "building";
+    readonly implement: "building";
+    readonly knowledge: "building";
+    readonly constitution: "verifying";
+    readonly guardian: "verifying";
+    readonly ci: "verifying";
+    readonly deployments: "verifying";
+    readonly review: "verifying";
+    readonly analytics: "verifying";
+    readonly compliance: "verifying";
+    readonly monitor: "verifying";
+};
+export declare const WORKFLOW_STEPS_BY_PHASE_GROUP: {
+    readonly planning: readonly string[];
+    readonly building: readonly string[];
+    readonly verifying: readonly string[];
+};

package/dist/constants/workflow-phase-groups.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_STEPS_BY_PHASE_GROUP = exports.WORKFLOW_PHASE_GROUP_BY_STEP = void 0;
+const workflow_1 = require("./workflow");
+/**
+ * Groups SSOT workflow step ids (`constants/workflow`) into coarse model-policy phases.
+ * `WORKFLOW_STEPS_BY_PHASE_GROUP` is derived from `WORKFLOW_PHASE_GROUP_BY_STEP` and
+ * preserves `WORKFLOW_STEPS` order (plus `monitor`).
+ */
+exports.WORKFLOW_PHASE_GROUP_BY_STEP = {
+    integrations: "planning",
+    repo: "planning",
+    ingest: "planning",
+    team: "planning",
+    specify: "planning",
+    argument_map: "planning",
+    plan: "planning",
+    schema: "planning",
+    counterclaim_framework: "planning",
+    api: "planning",
+    ui: "planning",
+    tasks: "building",
+    implement: "building",
+    knowledge: "building",
+    constitution: "verifying",
+    guardian: "verifying",
+    ci: "verifying",
+    deployments: "verifying",
+    review: "verifying",
+    analytics: "verifying",
+    compliance: "verifying",
+    monitor: "verifying",
+};
+const WORKFLOW_STEP_ORDER = [
+    ...workflow_1.WORKFLOW_STEPS.map((s) => s.id),
+    "monitor",
+];
+function stepsForPhase(phase) {
+    const byStep = exports.WORKFLOW_PHASE_GROUP_BY_STEP;
+    return WORKFLOW_STEP_ORDER.filter((s) => byStep[s] === phase);
+}
+exports.WORKFLOW_STEPS_BY_PHASE_GROUP = {
+    planning: stepsForPhase("planning"),
+    building: stepsForPhase("building"),
+    verifying: stepsForPhase("verifying"),
+};

package/dist/constants/workflow-registry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * NeuraLoom Workflow Constants - SSOT for Project Workflow
+ * Constitutional compliance: Single source of truth for workflow steps and navigation
+ * SP29-P0: Enhanced with phase-based registry for unified navigation
+ * Writing Mode: WorkflowKind discriminator for project-level mode switching
+ */
+export declare const WORKFLOW_KINDS: readonly ["software", "film", "fiction", "nonfiction", "book", "technical_report", "scientific_paper", "research_brief", "white_paper", "philosophical_manuscript"];
+export type WorkflowKind = (typeof WORKFLOW_KINDS)[number];
+export declare const WRITING_KINDS: ReadonlyArray<WorkflowKind>;
+export declare const isWritingKind: (k: WorkflowKind | string | undefined | null) => boolean;
+export interface WorkflowStepDefinition {
+    id: string;
+    name: string;
+    title: string;
+    description: string;
+    phase: number;
+    order: number;
+    path: string;
+    icon?: string;
+    isOptional?: boolean;
+    dependencies?: string[];
+    agentRole?: string;
+    estimatedHours?: number;
+    applicableKinds?: ReadonlyArray<WorkflowKind>;
+    labelByKind?: Partial<Record<WorkflowKind, {
+        title: string;
+        description: string;
+    }>>;
+}
+export interface WorkflowPhaseDefinition {
+    id: string;
+    number: number;
+    title: string;
+    description: string;
+    icon: string;
+    color: string;
+    steps: WorkflowStepDefinition[];
+}
+export interface WorkflowRegistry {
+    version: string;
+    phases: WorkflowPhaseDefinition[];
+    totalSteps: number;
+}
+export declare const WORKFLOW_STEPS: WorkflowStepDefinition[];
+/**
+ * Channel-only deprecated quality-spine steps (WORKFLOW_CHANNEL_REGISTRY).
+ * Superseded by canonical Ingest — excluded from operator nav progress denominators.
+ */
+export declare const SOFTWARE_CHANNEL_DEPRECATED_STEP_IDS: readonly ["scan", "architecture-control"];
+/**
+ * Operator sidebar spine for software projects: WORKFLOW_STEPS ids applicable to `software` kind
+ * (includes ingest when present). Dual-spine honesty: progress UI counts these, not the 12-step
+ * quality channel or deprecated scan/architecture-control entries.
+ */
+export declare const SOFTWARE_OPERATOR_NAV_STEP_IDS: readonly string[];
+/** Canonical id for `/projects/[id]/<step>` routes and workflow UI (includes pipeline-only stubs). */
+export type WorkflowStepId = (typeof WORKFLOW_STEPS)[number]['id'] | 'monitor' | 'intent' | 'development' | 'script' | 'preproduction' | 'generation' | 'postproduction' | 'review' | 'release'
+/** @deprecated Legacy film spine */
+ | 'structure' | 'ontology';
+/**
+ * SP29-P0: Central Workflow Registry
+ * Groups steps into phases for unified navigation and orchestration
+ * v2.0.0: Logical reordering - Constitution after Design phase
+ */
+export declare const WORKFLOW_REGISTRY: WorkflowRegistry;
+/**
+ * Get workflow step by ID
+ */
+export declare function getWorkflowStep(stepId: string): WorkflowStepDefinition | null;
+/**
+ * Get next workflow step
+ */
+export declare function getNextStep(currentStepId: string): WorkflowStepDefinition | null;
+/**
+ * Get previous workflow step
+ */
+export declare function getPreviousStep(currentStepId: string): WorkflowStepDefinition | null;

package/dist/constants/workflow-registry.js

@@ -0,0 +1,421 @@
+"use strict";
+/**
+ * NeuraLoom Workflow Constants - SSOT for Project Workflow
+ * Constitutional compliance: Single source of truth for workflow steps and navigation
+ * SP29-P0: Enhanced with phase-based registry for unified navigation
+ * Writing Mode: WorkflowKind discriminator for project-level mode switching
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_REGISTRY = exports.SOFTWARE_OPERATOR_NAV_STEP_IDS = exports.SOFTWARE_CHANNEL_DEPRECATED_STEP_IDS = exports.WORKFLOW_STEPS = exports.isWritingKind = exports.WRITING_KINDS = exports.WORKFLOW_KINDS = void 0;
+exports.getWorkflowStep = getWorkflowStep;
+exports.getNextStep = getNextStep;
+exports.getPreviousStep = getPreviousStep;
+exports.WORKFLOW_KINDS = [
+    'software',
+    'film',
+    'fiction',
+    'nonfiction',
+    'book',
+    'technical_report',
+    'scientific_paper',
+    'research_brief',
+    'white_paper',
+    'philosophical_manuscript',
+];
+exports.WRITING_KINDS = [
+    'fiction',
+    'nonfiction',
+    'book',
+    'technical_report',
+    'scientific_paper',
+    'research_brief',
+    'white_paper',
+    'philosophical_manuscript',
+];
+const isWritingKind = (k) => k !== undefined && k !== null && exports.WRITING_KINDS.includes(k);
+exports.isWritingKind = isWritingKind;
+exports.WORKFLOW_STEPS = [
+    // Phase 1 – Foundation (Setup Infrastructure)
+    {
+        id: 'integrations',
+        name: 'Integrations',
+        title: 'Integrations',
+        description: 'Connect GitHub, Vercel, Supabase, Doppler',
+        phase: 1,
+        order: 1,
+        path: '/integrations',
+        icon: 'Link',
+        agentRole: 'integration-specialist',
+        estimatedHours: 1,
+        applicableKinds: ['software'],
+    },
+    {
+        id: 'repo',
+        name: 'Repository',
+        title: 'Repository',
+        description: 'Create and link GitHub repository',
+        phase: 1,
+        order: 2,
+        path: '/repo',
+        icon: 'GitBranch',
+        agentRole: 'devops-engineer',
+        estimatedHours: 1,
+        applicableKinds: ['software'],
+    },
+    {
+        id: 'ingest',
+        name: 'Ingest',
+        title: 'Ingest',
+        description: 'Map existing reality before generation',
+        phase: 1,
+        order: 2.5,
+        path: '/ingest',
+        icon: 'ScanSearch',
+        agentRole: 'repo-analyst',
+        estimatedHours: 1,
+        dependencies: ['repo'],
+        applicableKinds: ['software'],
+    },
+    {
+        id: 'team',
+        name: 'Team',
+        title: 'Team',
+        description: 'Add collaborators, roles, permissions',
+        phase: 1,
+        order: 3,
+        path: '/team',
+        icon: 'Users',
+        agentRole: 'team-coordinator',
+        estimatedHours: 1
+    },
+    // Phase 2 – Design (What to Build)
+    {
+        id: 'specify',
+        name: 'Specify',
+        title: 'Specify',
+        description: 'Write feature specifications with AI',
+        phase: 2,
+        order: 4,
+        path: '/specify',
+        icon: 'FileText',
+        agentRole: 'spec-engineer',
+        estimatedHours: 3
+    },
+    {
+        id: 'argument_map',
+        name: 'Argument Map',
+        title: 'Argument Map',
+        description: 'Map claim dependencies, rival explanations, and evidence requirements',
+        phase: 2,
+        order: 4.5,
+        path: '/argument_map',
+        icon: 'Network',
+        agentRole: 'spec-engineer',
+        estimatedHours: 2,
+        applicableKinds: [
+            'nonfiction',
+            'book',
+            'technical_report',
+            'scientific_paper',
+            'research_brief',
+            'white_paper',
+            'philosophical_manuscript',
+        ],
+    },
+    {
+        id: 'plan',
+        name: 'Plan',
+        title: 'Plan',
+        description: 'Architecture diagrams and dependencies',
+        phase: 2,
+        order: 5,
+        path: '/plan',
+        icon: 'Network',
+        agentRole: 'system-architect',
+        estimatedHours: 2
+    },
+    {
+        id: 'schema',
+        name: 'Schema',
+        title: 'Schema',
+        description: 'Database tables, migrations, RLS policies',
+        phase: 2,
+        order: 6,
+        path: '/schema',
+        icon: 'Database',
+        agentRole: 'database-architect',
+        estimatedHours: 2
+    },
+    {
+        id: 'counterclaim_framework',
+        name: 'Counterclaim Framework',
+        title: 'Counterclaim Framework',
+        description: 'Survey rival explanations, steelman arguments, and map rebuttal strategies',
+        phase: 2,
+        order: 6.5,
+        path: '/counterclaim_framework',
+        icon: 'ShieldAlert',
+        agentRole: 'spec-engineer',
+        estimatedHours: 2,
+        applicableKinds: [
+            'nonfiction',
+            'book',
+            'technical_report',
+            'scientific_paper',
+            'research_brief',
+            'white_paper',
+            'philosophical_manuscript',
+        ],
+    },
+    {
+        id: 'api',
+        name: 'API',
+        title: 'API',
+        description: 'REST endpoints and contracts',
+        phase: 2,
+        order: 7,
+        path: '/api',
+        icon: 'Route',
+        agentRole: 'api-developer',
+        estimatedHours: 2
+    },
+    {
+        id: 'ui',
+        name: 'UI',
+        title: 'UI',
+        description: 'Components, layouts, design system',
+        phase: 2,
+        order: 8,
+        path: '/ui',
+        icon: 'Palette',
+        agentRole: 'ui-designer',
+        estimatedHours: 2
+    },
+    // Phase 3 – Governance (Define Rules Based on Design)
+    {
+        id: 'constitution',
+        name: 'Constitution',
+        title: 'Constitution',
+        description: 'Define governance rules, RLS policies, and compliance requirements based on planned system',
+        phase: 3,
+        order: 9,
+        path: '/constitution',
+        icon: 'Scale',
+        agentRole: 'compliance-officer',
+        estimatedHours: 2
+    },
+    {
+        id: 'guardian',
+        name: 'Guardian',
+        title: 'Guardian Setup',
+        description: 'Configure automated compliance enforcement and validation rules',
+        phase: 3,
+        order: 10,
+        path: '/guardian',
+        icon: 'ShieldCheck',
+        agentRole: 'compliance-officer',
+        estimatedHours: 1
+    },
+    // Phase 4 – Build (Implementation)
+    {
+        id: 'tasks',
+        name: 'Tasks',
+        title: 'Tasks',
+        description: 'Break specs into work items',
+        phase: 4,
+        order: 11,
+        path: '/tasks',
+        icon: 'CheckSquare',
+        agentRole: 'task-analyst',
+        estimatedHours: 2
+    },
+    {
+        id: 'implement',
+        name: 'Implement',
+        title: 'Implement',
+        description: 'Write code, commit to repository',
+        phase: 4,
+        order: 12,
+        path: '/implement',
+        icon: 'Code',
+        agentRole: 'developer',
+        estimatedHours: 8
+    },
+    {
+        id: 'knowledge',
+        name: 'Knowledge',
+        title: 'Knowledge',
+        description: 'Document as you build, live traceability',
+        phase: 4,
+        order: 13,
+        path: '/knowledge',
+        icon: 'Brain',
+        agentRole: 'knowledge-manager',
+        estimatedHours: 2
+    },
+    // Phase 5 – Ship (Deployment & Validation)
+    {
+        id: 'ci',
+        name: 'CI/CD',
+        title: 'CI/CD',
+        description: 'Automated testing and validation',
+        phase: 5,
+        order: 14,
+        path: '/ci',
+        icon: 'GitPullRequest',
+        agentRole: 'qa-engineer',
+        estimatedHours: 2
+    },
+    {
+        id: 'deployments',
+        name: 'Deployments',
+        title: 'Deployments',
+        description: 'Deploy to staging and production',
+        phase: 5,
+        order: 15,
+        path: '/deployments',
+        icon: 'Rocket',
+        agentRole: 'devops-engineer',
+        estimatedHours: 2
+    },
+    {
+        id: 'review',
+        name: 'Review',
+        title: 'Review',
+        description: 'Post-deployment validation and retrospective',
+        phase: 5,
+        order: 16,
+        path: '/review',
+        icon: 'SearchCheck',
+        agentRole: 'code-reviewer',
+        estimatedHours: 2
+    },
+    // Phase 6 – Maintain (Ongoing Operations)
+    {
+        id: 'analytics',
+        name: 'Analytics',
+        title: 'Analytics',
+        description: 'Usage metrics and performance monitoring',
+        phase: 6,
+        order: 17,
+        path: '/analytics',
+        icon: 'BarChart3',
+        agentRole: 'data-analyst',
+        estimatedHours: 2
+    },
+    {
+        id: 'compliance',
+        name: 'Compliance',
+        title: 'Compliance',
+        description: 'Ongoing Guardian validation per project',
+        phase: 6,
+        order: 18,
+        path: '/compliance',
+        icon: 'FileCheck2',
+        agentRole: 'compliance-officer',
+        estimatedHours: 2
+    }
+];
+/**
+ * Channel-only deprecated quality-spine steps (WORKFLOW_CHANNEL_REGISTRY).
+ * Superseded by canonical Ingest — excluded from operator nav progress denominators.
+ */
+exports.SOFTWARE_CHANNEL_DEPRECATED_STEP_IDS = [
+    'scan',
+    'architecture-control',
+];
+/**
+ * Operator sidebar spine for software projects: WORKFLOW_STEPS ids applicable to `software` kind
+ * (includes ingest when present). Dual-spine honesty: progress UI counts these, not the 12-step
+ * quality channel or deprecated scan/architecture-control entries.
+ */
+exports.SOFTWARE_OPERATOR_NAV_STEP_IDS = exports.WORKFLOW_STEPS.filter((step) => (step.applicableKinds ?? exports.WORKFLOW_KINDS).includes('software')).map((step) => step.id);
+/**
+ * SP29-P0: Central Workflow Registry
+ * Groups steps into phases for unified navigation and orchestration
+ * v2.0.0: Logical reordering - Constitution after Design phase
+ */
+exports.WORKFLOW_REGISTRY = {
+    version: '2.0.0',
+    totalSteps: exports.WORKFLOW_STEPS.length,
+    phases: [
+        {
+            id: 'foundation',
+            number: 1,
+            title: 'Foundation',
+            description: 'Setup infrastructure and team',
+            icon: 'Shield',
+            color: 'primary',
+            steps: exports.WORKFLOW_STEPS.filter(s => s.phase === 1)
+        },
+        {
+            id: 'design',
+            number: 2,
+            title: 'Design',
+            description: 'Plan what to build',
+            icon: 'Target',
+            color: 'info',
+            steps: exports.WORKFLOW_STEPS.filter(s => s.phase === 2)
+        },
+        {
+            id: 'governance',
+            number: 3,
+            title: 'Governance',
+            description: 'Define rules based on design',
+            icon: 'ShieldCheck',
+            color: 'secondary',
+            steps: exports.WORKFLOW_STEPS.filter(s => s.phase === 3)
+        },
+        {
+            id: 'build',
+            number: 4,
+            title: 'Build',
+            description: 'Implement and document',
+            icon: 'Code',
+            color: 'success',
+            steps: exports.WORKFLOW_STEPS.filter(s => s.phase === 4)
+        },
+        {
+            id: 'ship',
+            number: 5,
+            title: 'Ship',
+            description: 'Test and deploy',
+            icon: 'Rocket',
+            color: 'warning',
+            steps: exports.WORKFLOW_STEPS.filter(s => s.phase === 5)
+        },
+        {
+            id: 'maintain',
+            number: 6,
+            title: 'Maintain',
+            description: 'Monitor and improve',
+            icon: 'BarChart3',
+            color: 'accent',
+            steps: exports.WORKFLOW_STEPS.filter(s => s.phase === 6)
+        }
+    ]
+};
+/**
+ * Get workflow step by ID
+ */
+function getWorkflowStep(stepId) {
+    return exports.WORKFLOW_STEPS.find(step => step.id === stepId) || null;
+}
+/**
+ * Get next workflow step
+ */
+function getNextStep(currentStepId) {
+    const currentStep = getWorkflowStep(currentStepId);
+    if (!currentStep)
+        return null;
+    return exports.WORKFLOW_STEPS.find(step => step.order === currentStep.order + 1) || null;
+}
+/**
+ * Get previous workflow step
+ */
+function getPreviousStep(currentStepId) {
+    const currentStep = getWorkflowStep(currentStepId);
+    if (!currentStep)
+        return null;
+    return exports.WORKFLOW_STEPS.find(step => step.order === currentStep.order - 1) || null;
+}