@ai-coders/context 0.5.2 → 0.6.1

package/dist/workflow/plans/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Plan-Workflow Integration Types
+ *
+ * Types for linking implementation plans to the PREVC workflow system.
+ * Plans provide the "what" and "how", workflow provides the "when" and tracking.
+ */
+import { PrevcPhase, PrevcRole, StatusType } from '../types';
+/**
+ * Plan phase mapping to PREVC phases
+ */
+export declare const PLAN_PHASE_TO_PREVC: Record<string, PrevcPhase>;
+/**
+ * Reference to a plan file
+ */
+export interface PlanReference {
+    /** Slug/identifier of the plan */
+    slug: string;
+    /** Path to the plan file relative to .context */
+    path: string;
+    /** Display title */
+    title: string;
+    /** Brief summary */
+    summary?: string;
+    /** When the plan was linked */
+    linkedAt: string;
+    /** Plan status */
+    status: 'active' | 'completed' | 'paused' | 'cancelled';
+}
+/**
+ * Step within a plan phase
+ */
+export interface PlanStep {
+    /** Step number within the phase */
+    order: number;
+    /** Step description */
+    description: string;
+    /** Assigned role/owner */
+    assignee?: PrevcRole | string;
+    /** Step status */
+    status: StatusType;
+    /** Output artifacts produced */
+    outputs?: string[];
+    /** Completion timestamp */
+    completedAt?: string;
+}
+/**
+ * Phase within a plan (maps to PREVC phases)
+ */
+export interface PlanPhase {
+    /** Phase identifier (e.g., "phase-1", "discovery") */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Mapped PREVC phase */
+    prevcPhase: PrevcPhase;
+    /** Steps in this phase */
+    steps: PlanStep[];
+    /** Phase status */
+    status: StatusType;
+    /** Commit checkpoint message */
+    commitCheckpoint?: string;
+    /** Start timestamp */
+    startedAt?: string;
+    /** Completion timestamp */
+    completedAt?: string;
+}
+/**
+ * Decision record within a plan
+ */
+export interface PlanDecision {
+    /** Decision identifier */
+    id: string;
+    /** Decision title */
+    title: string;
+    /** Decision description/rationale */
+    description: string;
+    /** Who made the decision */
+    decidedBy?: PrevcRole | string;
+    /** When the decision was made */
+    decidedAt?: string;
+    /** Related PREVC phase */
+    phase?: PrevcPhase;
+    /** Status: proposed, accepted, rejected, superseded */
+    status: 'proposed' | 'accepted' | 'rejected' | 'superseded';
+    /** Alternatives considered */
+    alternatives?: string[];
+    /** Consequences of this decision */
+    consequences?: string[];
+}
+/**
+ * Risk entry within a plan
+ */
+export interface PlanRisk {
+    /** Risk identifier */
+    id: string;
+    /** Risk description */
+    description: string;
+    /** Probability: low, medium, high */
+    probability: 'low' | 'medium' | 'high';
+    /** Impact: low, medium, high */
+    impact: 'low' | 'medium' | 'high';
+    /** Mitigation strategy */
+    mitigation?: string;
+    /** Owner responsible for mitigation */
+    owner?: PrevcRole | string;
+    /** Current status */
+    status: 'identified' | 'mitigated' | 'occurred' | 'closed';
+}
+/**
+ * Agent lineup entry with role description
+ */
+export interface AgentLineupEntry {
+    /** Agent type identifier */
+    type: string;
+    /** Role/responsibility in this plan */
+    role?: string;
+}
+/**
+ * Complete plan structure linked to workflow
+ */
+export interface LinkedPlan {
+    /** Plan reference info */
+    ref: PlanReference;
+    /** Plan phases with PREVC mapping */
+    phases: PlanPhase[];
+    /** Key decisions made during planning */
+    decisions: PlanDecision[];
+    /** Identified risks */
+    risks: PlanRisk[];
+    /** Agents involved in this plan (simple list) */
+    agents: string[];
+    /** Full agent lineup with roles (from frontmatter) */
+    agentLineup: AgentLineupEntry[];
+    /** Documentation touchpoints */
+    docs: string[];
+    /** Overall progress percentage */
+    progress: number;
+    /** Current active phase */
+    currentPhase?: string;
+}
+/**
+ * Plan tracking in workflow status
+ */
+export interface WorkflowPlans {
+    /** Currently active plans */
+    active: PlanReference[];
+    /** Completed plans */
+    completed: PlanReference[];
+    /** Current primary plan (if any) */
+    primary?: string;
+}
+/**
+ * Plan-workflow sync event
+ */
+export interface PlanSyncEvent {
+    /** Event type */
+    type: 'plan_linked' | 'plan_updated' | 'phase_completed' | 'decision_made' | 'risk_updated';
+    /** Plan slug */
+    planSlug: string;
+    /** Affected PREVC phase */
+    phase?: PrevcPhase;
+    /** Event timestamp */
+    timestamp: string;
+    /** Event details */
+    details?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/plans/types.d.ts.map

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

package/dist/workflow/plans/types.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Plan-Workflow Integration Types
+ *
+ * Types for linking implementation plans to the PREVC workflow system.
+ * Plans provide the "what" and "how", workflow provides the "when" and tracking.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLAN_PHASE_TO_PREVC = void 0;
+/**
+ * Plan phase mapping to PREVC phases
+ */
+exports.PLAN_PHASE_TO_PREVC = {
+    'discovery': 'P', // Discovery & Alignment → Planning
+    'alignment': 'P',
+    'review': 'R', // Architecture Review → Review
+    'architecture': 'R',
+    'implementation': 'E', // Implementation → Execution
+    'build': 'E',
+    'validation': 'V', // Validation → Validation
+    'testing': 'V',
+    'handoff': 'C', // Handoff → Confirmation
+    'deployment': 'C',
+};
+//# sourceMappingURL=types.js.map

package/dist/workflow/plans/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/workflow/plans/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;;GAEG;AACU,QAAA,mBAAmB,GAA+B;IAC7D,WAAW,EAAE,GAAG,EAAO,mCAAmC;IAC1D,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG,EAAU,+BAA+B;IACtD,cAAc,EAAE,GAAG;IACnB,gBAAgB,EAAE,GAAG,EAAE,6BAA6B;IACpD,OAAO,EAAE,GAAG;IACZ,YAAY,EAAE,GAAG,EAAM,0BAA0B;IACjD,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG,EAAS,yBAAyB;IAChD,YAAY,EAAE,GAAG;CAClB,CAAC"}

package/dist/workflow/prevcConfig.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PREVC Role Configuration
+ *
+ * Defines responsibilities, outputs, and specialists for each PREVC role.
+ */
+import { PrevcRole, RoleDefinition } from './types';
+/**
+ * Complete configuration for all PREVC roles
+ */
+export declare const ROLE_CONFIG: Record<PrevcRole, RoleDefinition>;
+/**
+ * Get the configuration for a specific role
+ */
+export declare function getRoleConfig(role: PrevcRole): RoleDefinition;
+/**
+ * Get all roles that participate in a specific phase
+ */
+export declare function getRolesForPhase(phase: string): PrevcRole[];
+/**
+ * Get all outputs for a specific role
+ */
+export declare function getOutputsForRole(role: PrevcRole): string[];
+/**
+ * Get all responsibilities for a specific role
+ */
+export declare function getResponsibilitiesForRole(role: PrevcRole): string[];
+//# sourceMappingURL=prevcConfig.d.ts.map

package/dist/workflow/prevcConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prevcConfig.d.ts","sourceRoot":"","sources":["../../src/workflow/prevcConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,cAAc,CAgHzD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,CAE7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAS3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAEpE"}

package/dist/workflow/prevcConfig.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * PREVC Role Configuration
+ *
+ * Defines responsibilities, outputs, and specialists for each PREVC role.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_CONFIG = void 0;
+exports.getRoleConfig = getRoleConfig;
+exports.getRolesForPhase = getRolesForPhase;
+exports.getOutputsForRole = getOutputsForRole;
+exports.getResponsibilitiesForRole = getResponsibilitiesForRole;
+/**
+ * Complete configuration for all PREVC roles
+ */
+exports.ROLE_CONFIG = {
+    planner: {
+        phase: 'P',
+        responsibilities: [
+            'Conduct discovery and requirements gathering',
+            'Create specifications and project scope',
+            'Define acceptance criteria',
+            'Generate PRD or Tech Spec',
+            'Identify risks and dependencies',
+        ],
+        outputs: ['prd', 'tech-spec', 'requirements'],
+        specialists: [],
+    },
+    designer: {
+        phase: ['P', 'R'],
+        responsibilities: [
+            'Create wireframes and prototypes',
+            'Define design system and components',
+            'Ensure accessibility and usability',
+            'Document UI/UX patterns',
+            'Validate user flows',
+        ],
+        outputs: ['wireframes', 'design-spec', 'ui-components'],
+        specialists: ['frontend-specialist'],
+    },
+    architect: {
+        phase: 'R',
+        responsibilities: [
+            'Define system architecture',
+            'Create ADRs (Architecture Decision Records)',
+            'Choose technologies and patterns',
+            'Ensure scalability and maintainability',
+            'Review technical impact of decisions',
+        ],
+        outputs: ['architecture', 'adr', 'tech-decisions'],
+        specialists: ['architect-specialist'],
+    },
+    developer: {
+        phase: 'E',
+        responsibilities: [
+            'Implement code according to specifications',
+            'Follow defined patterns and architecture',
+            'Create basic unit tests',
+            'Document code when necessary',
+            'Solve technical problems',
+        ],
+        outputs: ['code', 'unit-tests'],
+        specialists: [
+            'feature-developer',
+            'bug-fixer',
+            'backend-specialist',
+            'frontend-specialist',
+            'mobile-specialist',
+            'database-specialist',
+            'devops-specialist',
+        ],
+    },
+    qa: {
+        phase: 'V',
+        responsibilities: [
+            'Create and execute integration tests',
+            'Validate security and performance',
+            'Ensure quality gates',
+            'Report and track bugs',
+            'Validate acceptance criteria',
+        ],
+        outputs: ['test-report', 'qa-approval', 'bug-report'],
+        specialists: ['test-writer', 'security-auditor', 'performance-optimizer'],
+    },
+    reviewer: {
+        phase: 'V',
+        responsibilities: [
+            'Review code and architecture',
+            'Ensure compliance with standards',
+            'Suggest improvements and optimizations',
+            'Validate best practices',
+            'Approve or request changes',
+        ],
+        outputs: ['review-comments', 'approval'],
+        specialists: ['code-reviewer'],
+    },
+    documenter: {
+        phase: 'C',
+        responsibilities: [
+            'Create technical documentation',
+            'Update README and APIs',
+            'Prepare handoff to production',
+            'Generate changelog and release notes',
+            'Document important decisions',
+        ],
+        outputs: ['documentation', 'changelog', 'readme'],
+        specialists: ['documentation-writer'],
+    },
+    'solo-dev': {
+        phase: ['P', 'R', 'E', 'V', 'C'],
+        responsibilities: [
+            'Execute complete flow for small tasks',
+            'Bug fixes and quick refactorings',
+            'Low complexity features',
+            'Maintenance of existing code',
+            'Adjustments and specific tweaks',
+        ],
+        outputs: ['code', 'tests', 'docs'],
+        specialists: ['refactoring-specialist', 'bug-fixer'],
+    },
+};
+/**
+ * Get the configuration for a specific role
+ */
+function getRoleConfig(role) {
+    return exports.ROLE_CONFIG[role];
+}
+/**
+ * Get all roles that participate in a specific phase
+ */
+function getRolesForPhase(phase) {
+    return Object.entries(exports.ROLE_CONFIG)
+        .filter(([, config]) => {
+        if (Array.isArray(config.phase)) {
+            return config.phase.includes(phase);
+        }
+        return config.phase === phase;
+    })
+        .map(([role]) => role);
+}
+/**
+ * Get all outputs for a specific role
+ */
+function getOutputsForRole(role) {
+    return exports.ROLE_CONFIG[role]?.outputs || [];
+}
+/**
+ * Get all responsibilities for a specific role
+ */
+function getResponsibilitiesForRole(role) {
+    return exports.ROLE_CONFIG[role]?.responsibilities || [];
+}
+//# sourceMappingURL=prevcConfig.js.map

package/dist/workflow/prevcConfig.js.map

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

package/dist/workflow/roles.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PREVC Workflow Roles
+ *
+ * Defines the available roles in the PREVC workflow system
+ * and their mapping to existing agent types.
+ */
+import { PrevcRole } from './types';
+/**
+ * All available PREVC roles
+ */
+export declare const PREVC_ROLES: readonly ["planner", "designer", "architect", "developer", "qa", "reviewer", "documenter", "solo-dev"];
+/**
+ * Mapping from PREVC roles to existing agent types (specialists)
+ */
+export declare const ROLE_TO_SPECIALISTS: Record<PrevcRole, string[]>;
+/**
+ * Mapping from existing agent types to PREVC roles
+ */
+export declare const SPECIALIST_TO_ROLE: Record<string, PrevcRole>;
+/**
+ * Role display names (English)
+ */
+export declare const ROLE_DISPLAY_NAMES: Record<PrevcRole, string>;
+/**
+ * Role display names in English (alias for consistency)
+ */
+export declare const ROLE_DISPLAY_NAMES_EN: Record<PrevcRole, string>;
+/**
+ * Role display names in Portuguese (for i18n)
+ */
+export declare const ROLE_DISPLAY_NAMES_PT: Record<PrevcRole, string>;
+/**
+ * Check if a string is a valid PREVC role
+ */
+export declare function isValidRole(role: string): role is PrevcRole;
+/**
+ * Get the PREVC role for an existing agent type
+ */
+export declare function getRoleForSpecialist(specialist: string): PrevcRole | null;
+/**
+ * Get all specialists for a PREVC role
+ */
+export declare function getSpecialistsForRole(role: PrevcRole): string[];
+//# sourceMappingURL=roles.d.ts.map

package/dist/workflow/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/workflow/roles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,WAAW,wGASd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAe3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAexD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CASxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,2BAAqB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAS3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAE/D"}

package/dist/workflow/roles.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * PREVC Workflow Roles
+ *
+ * Defines the available roles in the PREVC workflow system
+ * and their mapping to existing agent types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_DISPLAY_NAMES_PT = exports.ROLE_DISPLAY_NAMES_EN = exports.ROLE_DISPLAY_NAMES = exports.SPECIALIST_TO_ROLE = exports.ROLE_TO_SPECIALISTS = exports.PREVC_ROLES = void 0;
+exports.isValidRole = isValidRole;
+exports.getRoleForSpecialist = getRoleForSpecialist;
+exports.getSpecialistsForRole = getSpecialistsForRole;
+/**
+ * All available PREVC roles
+ */
+exports.PREVC_ROLES = [
+    'planner', // P: Discovery, requirements, specifications
+    'designer', // P/R: UX, design systems, wireframes
+    'architect', // R: ADRs, technical decisions, blueprints
+    'developer', // E: Implementation, coding
+    'qa', // V: Tests, quality gates
+    'reviewer', // V: Code review, standards
+    'documenter', // C: Documentation, handoff
+    'solo-dev', // P→C: Full quick flow
+];
+/**
+ * Mapping from PREVC roles to existing agent types (specialists)
+ */
+exports.ROLE_TO_SPECIALISTS = {
+    planner: [], // New role, no existing mapping
+    designer: ['frontend-specialist'],
+    architect: ['architect-specialist'],
+    developer: [
+        'feature-developer',
+        'bug-fixer',
+        'backend-specialist',
+        'frontend-specialist',
+        'mobile-specialist',
+    ],
+    qa: ['test-writer', 'security-auditor', 'performance-optimizer'],
+    reviewer: ['code-reviewer'],
+    documenter: ['documentation-writer'],
+    'solo-dev': ['refactoring-specialist', 'bug-fixer'],
+};
+/**
+ * Mapping from existing agent types to PREVC roles
+ */
+exports.SPECIALIST_TO_ROLE = {
+    'frontend-specialist': 'designer',
+    'architect-specialist': 'architect',
+    'feature-developer': 'developer',
+    'bug-fixer': 'developer',
+    'backend-specialist': 'developer',
+    'mobile-specialist': 'developer',
+    'test-writer': 'qa',
+    'security-auditor': 'qa',
+    'performance-optimizer': 'qa',
+    'code-reviewer': 'reviewer',
+    'documentation-writer': 'documenter',
+    'refactoring-specialist': 'solo-dev',
+    'database-specialist': 'developer',
+    'devops-specialist': 'developer',
+};
+/**
+ * Role display names (English)
+ */
+exports.ROLE_DISPLAY_NAMES = {
+    planner: 'Planner',
+    designer: 'Designer',
+    architect: 'Architect',
+    developer: 'Developer',
+    qa: 'QA Engineer',
+    reviewer: 'Reviewer',
+    documenter: 'Documenter',
+    'solo-dev': 'Solo Dev',
+};
+/**
+ * Role display names in English (alias for consistency)
+ */
+exports.ROLE_DISPLAY_NAMES_EN = exports.ROLE_DISPLAY_NAMES;
+/**
+ * Role display names in Portuguese (for i18n)
+ */
+exports.ROLE_DISPLAY_NAMES_PT = {
+    planner: 'Planejador',
+    designer: 'Designer',
+    architect: 'Arquiteto',
+    developer: 'Desenvolvedor',
+    qa: 'QA',
+    reviewer: 'Revisor',
+    documenter: 'Documentador',
+    'solo-dev': 'Solo Dev',
+};
+/**
+ * Check if a string is a valid PREVC role
+ */
+function isValidRole(role) {
+    return exports.PREVC_ROLES.includes(role);
+}
+/**
+ * Get the PREVC role for an existing agent type
+ */
+function getRoleForSpecialist(specialist) {
+    return exports.SPECIALIST_TO_ROLE[specialist] || null;
+}
+/**
+ * Get all specialists for a PREVC role
+ */
+function getSpecialistsForRole(role) {
+    return exports.ROLE_TO_SPECIALISTS[role] || [];
+}
+//# sourceMappingURL=roles.js.map

package/dist/workflow/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/workflow/roles.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8FH,kCAEC;AAKD,oDAEC;AAKD,sDAEC;AA1GD;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,SAAS,EAAE,6CAA6C;IACxD,UAAU,EAAE,sCAAsC;IAClD,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,0BAA0B;IAChC,UAAU,EAAE,4BAA4B;IACxC,YAAY,EAAE,4BAA4B;IAC1C,UAAU,EAAE,uBAAuB;CAC3B,CAAC;AAEX;;GAEG;AACU,QAAA,mBAAmB,GAAgC;IAC9D,OAAO,EAAE,EAAE,EAAE,gCAAgC;IAC7C,QAAQ,EAAE,CAAC,qBAAqB,CAAC;IACjC,SAAS,EAAE,CAAC,sBAAsB,CAAC;IACnC,SAAS,EAAE;QACT,mBAAmB;QACnB,WAAW;QACX,oBAAoB;QACpB,qBAAqB;QACrB,mBAAmB;KACpB;IACD,EAAE,EAAE,CAAC,aAAa,EAAE,kBAAkB,EAAE,uBAAuB,CAAC;IAChE,QAAQ,EAAE,CAAC,eAAe,CAAC;IAC3B,UAAU,EAAE,CAAC,sBAAsB,CAAC;IACpC,UAAU,EAAE,CAAC,wBAAwB,EAAE,WAAW,CAAC;CACpD,CAAC;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAA8B;IAC3D,qBAAqB,EAAE,UAAU;IACjC,sBAAsB,EAAE,WAAW;IACnC,mBAAmB,EAAE,WAAW;IAChC,WAAW,EAAE,WAAW;IACxB,oBAAoB,EAAE,WAAW;IACjC,mBAAmB,EAAE,WAAW;IAChC,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,IAAI;IACxB,uBAAuB,EAAE,IAAI;IAC7B,eAAe,EAAE,UAAU;IAC3B,sBAAsB,EAAE,YAAY;IACpC,wBAAwB,EAAE,UAAU;IACpC,qBAAqB,EAAE,WAAW;IAClC,mBAAmB,EAAE,WAAW;CACjC,CAAC;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAA8B;IAC3D,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,EAAE,EAAE,aAAa;IACjB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,UAAU;CACvB,CAAC;AAEF;;GAEG;AACU,QAAA,qBAAqB,GAAG,0BAAkB,CAAC;AAExD;;GAEG;AACU,QAAA,qBAAqB,GAA8B;IAC9D,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,eAAe;IAC1B,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,UAAU;CACvB,CAAC;AAEF;;GAEG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,OAAO,mBAAW,CAAC,QAAQ,CAAC,IAAiB,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,UAAkB;IACrD,OAAO,0BAAkB,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,IAAe;IACnD,OAAO,2BAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/workflow/scaling.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PREVC Scale-Adaptive Routing
+ *
+ * Determines which phases and roles are needed based on project scale.
+ */
+import { ProjectScale, PrevcPhase, PrevcRole, ScaleRoute, ProjectContext } from './types';
+/**
+ * Scale route configurations
+ * Defines which phases, roles, and documents are required for each scale level.
+ */
+export declare const SCALE_ROUTES: Record<ProjectScale, ScaleRoute>;
+/**
+ * Detect the appropriate project scale based on context
+ */
+export declare function detectProjectScale(context: ProjectContext): ProjectScale;
+/**
+ * Get the scale route for a specific scale level
+ */
+export declare function getScaleRoute(scale: ProjectScale): ScaleRoute;
+/**
+ * Get the phases required for a specific scale
+ */
+export declare function getPhasesForScale(scale: ProjectScale): PrevcPhase[];
+/**
+ * Get the roles required for a specific scale
+ */
+export declare function getRolesForScale(scale: ProjectScale): PrevcRole[] | 'all';
+/**
+ * Check if a phase is required for a specific scale
+ */
+export declare function isPhaseRequiredForScale(phase: PrevcPhase, scale: ProjectScale): boolean;
+/**
+ * Get scale name for display
+ */
+export declare function getScaleName(scale: ProjectScale): string;
+/**
+ * Get scale from string name
+ */
+export declare function getScaleFromName(name: string): ProjectScale | null;
+/**
+ * Get estimated time for a scale level
+ */
+export declare function getEstimatedTime(scale: ProjectScale): string;
+//# sourceMappingURL=scaling.d.ts.map

package/dist/workflow/scaling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaling.d.ts","sourceRoot":"","sources":["../../src/workflow/scaling.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,UAAU,CA4BzD,CAAC;AA8FF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CA6BxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,EAAE,CAEnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,GAAG,KAAK,CAEzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,YAAY,GAClB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CASxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CASlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAS5D"}