@fractary/faber 0.1.1 → 1.0.0

package/dist/errors.d.ts

@@ -0,0 +1,264 @@
+/**
+ * @fractary/faber - Error Types
+ *
+ * Hierarchical error classes for the FABER SDK.
+ */
+/**
+ * Base error for all FABER errors
+ */
+export declare class FaberError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error for configuration issues
+ */
+export declare class ConfigurationError extends FaberError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when configuration file is not found
+ */
+export declare class ConfigNotFoundError extends ConfigurationError {
+    constructor(path: string);
+}
+/**
+ * Error when configuration is invalid
+ */
+export declare class ConfigValidationError extends ConfigurationError {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+/**
+ * Base error for work module operations
+ */
+export declare class WorkError extends FaberError {
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when an issue is not found
+ */
+export declare class IssueNotFoundError extends WorkError {
+    readonly issueId: string | number;
+    constructor(issueId: string | number);
+}
+/**
+ * Error when issue creation fails
+ */
+export declare class IssueCreateError extends WorkError {
+    constructor(reason: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when label operation fails
+ */
+export declare class LabelError extends WorkError {
+    constructor(operation: string, label: string, reason: string);
+}
+/**
+ * Error when milestone operation fails
+ */
+export declare class MilestoneError extends WorkError {
+    constructor(operation: string, milestone: string, reason: string);
+}
+/**
+ * Base error for repo module operations
+ */
+export declare class RepoError extends FaberError {
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when a branch already exists
+ */
+export declare class BranchExistsError extends RepoError {
+    readonly branchName: string;
+    constructor(branchName: string);
+}
+/**
+ * Error when a branch is not found
+ */
+export declare class BranchNotFoundError extends RepoError {
+    readonly branchName: string;
+    constructor(branchName: string);
+}
+/**
+ * Error when attempting operation on protected branch
+ */
+export declare class ProtectedBranchError extends RepoError {
+    readonly branchName: string;
+    readonly operation: string;
+    constructor(branchName: string, operation: string);
+}
+/**
+ * Error when commit fails
+ */
+export declare class CommitError extends RepoError {
+    constructor(reason: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when push fails
+ */
+export declare class PushError extends RepoError {
+    constructor(reason: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when pull request is not found
+ */
+export declare class PRNotFoundError extends RepoError {
+    readonly prNumber: number;
+    constructor(prNumber: number);
+}
+/**
+ * Error when pull request operation fails
+ */
+export declare class PRError extends RepoError {
+    readonly prNumber?: number;
+    constructor(operation: string, reason: string, prNumber?: number);
+}
+/**
+ * Error for merge conflicts
+ */
+export declare class MergeConflictError extends RepoError {
+    readonly conflicts: string[];
+    constructor(conflicts: string[]);
+}
+/**
+ * Error when working directory has uncommitted changes
+ */
+export declare class DirtyWorkingDirectoryError extends RepoError {
+    readonly files: string[];
+    constructor(files: string[]);
+}
+/**
+ * Base error for spec module operations
+ */
+export declare class SpecError extends FaberError {
+    constructor(operation: string, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when a specification is not found
+ */
+export declare class SpecNotFoundError extends SpecError {
+    readonly identifier: string;
+    constructor(identifier: string);
+}
+/**
+ * Error when specification already exists
+ */
+export declare class SpecExistsError extends SpecError {
+    readonly identifier: string;
+    constructor(identifier: string);
+}
+/**
+ * Error when specification validation fails
+ */
+export declare class SpecValidationError extends SpecError {
+    readonly specPath: string;
+    readonly validationErrors: string[];
+    constructor(specPath: string, errors: string[]);
+}
+/**
+ * Base error for log module operations
+ */
+export declare class LogError extends FaberError {
+    constructor(operation: string, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when no active capture session exists
+ */
+export declare class NoActiveSessionError extends LogError {
+    constructor();
+}
+/**
+ * Error when session is already active
+ */
+export declare class SessionActiveError extends LogError {
+    readonly sessionId: string;
+    constructor(sessionId: string);
+}
+/**
+ * Error when log is not found
+ */
+export declare class LogNotFoundError extends LogError {
+    readonly logPath: string;
+    constructor(logPath: string);
+}
+/**
+ * Base error for state module operations
+ */
+export declare class StateError extends FaberError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Base error for workflow module operations
+ */
+export declare class WorkflowError extends FaberError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error when a phase fails
+ */
+export declare class PhaseFailedError extends WorkflowError {
+    readonly phase: string;
+    readonly reason: string;
+    constructor(phase: string, reason: string);
+}
+/**
+ * Error when workflow state is invalid
+ */
+export declare class InvalidWorkflowStateError extends WorkflowError {
+    constructor(message: string, currentState: string);
+}
+/**
+ * Error when max retries exceeded
+ */
+export declare class MaxRetriesExceededError extends WorkflowError {
+    readonly phase: string;
+    readonly attempts: number;
+    constructor(phase: string, attempts: number);
+}
+/**
+ * Error when approval is required but not granted
+ */
+export declare class ApprovalRequiredError extends WorkflowError {
+    readonly phase: string;
+    constructor(phase: string);
+}
+/**
+ * Error for provider-specific issues
+ */
+export declare class ProviderError extends FaberError {
+    readonly provider: string;
+    readonly operation: string;
+    constructor(provider: string, operation: string, message: string, details?: Record<string, unknown>);
+}
+/**
+ * Error for authentication failures
+ */
+export declare class AuthenticationError extends ProviderError {
+    constructor(provider: string, message?: string);
+}
+/**
+ * Error for rate limiting
+ */
+export declare class RateLimitError extends ProviderError {
+    readonly retryAfter?: number;
+    constructor(provider: string, retryAfter?: number);
+}
+/**
+ * Error for network failures
+ */
+export declare class NetworkError extends ProviderError {
+    constructor(provider: string, operation: string, reason: string);
+}
+/**
+ * Error when shell command execution fails
+ */
+export declare class CommandExecutionError extends FaberError {
+    readonly command: string;
+    readonly exitCode: number;
+    readonly stderr: string;
+    constructor(command: string, exitCode: number, stderr: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ5E,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAMD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;gBAC7C,IAAI,EAAE,MAAM;CAIzB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBAEd,MAAM,EAAE,MAAM,EAAE;CAK7B;AAMD;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI7E;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;gBAEtB,OAAO,EAAE,MAAM,GAAG,MAAM;CAKrC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9D;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,SAAS;gBAC3B,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ7D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQjE;AAMD;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI7E;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAUlD;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9D;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI9D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;CAK7B;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,SAAS;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;CASjE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;gBAEjB,SAAS,EAAE,MAAM,EAAE;CAShC;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAEb,KAAK,EAAE,MAAM,EAAE;CAS5B;AAMD;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIlF;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;gBAExB,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;CAU/C;AAMD;;GAEG;AACH,qBAAa,QAAS,SAAQ,UAAU;gBAC1B,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAIlF;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;;CAKjD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAK9B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;CAK5B;AAMD;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAMD;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM1C;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAIlD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAS5C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM;CAK1B;AAMD;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOpC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS/C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAUlD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBACjC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIhE;AAMD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAW9D"}