@wooojin/forgen 0.1.0

package/dist/core/errors.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Forgen — Domain Error Classes
+ *
+ * 도메인별 에러 계층:
+ *   ForgenError (base)
+ *   ├── ProviderError    — AI provider 호출 실패
+ *   ├── HookError        — hook 실행 실패
+ *   ├── ConfigError      — 설정 파일 파싱/검증 실패
+ *   ├── PackError        — pack 설치/로드 실패
+ *   ├── ForgeError       — forge dimension/profile 관련 실패
+ *   └── NonRetryableError — 재시도 불가 에러 (provider 내부 사용)
+ */
+export interface ForgenErrorOptions {
+    code?: string;
+    context?: Record<string, unknown>;
+    cause?: unknown;
+}
+/** 모든 forgen 에러의 기반 클래스 */
+export declare class ForgenError extends Error {
+    readonly code: string;
+    readonly context: Record<string, unknown>;
+    constructor(message: string, options?: ForgenErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+export interface ProviderErrorOptions extends ForgenErrorOptions {
+    providerName?: string;
+    statusCode?: number;
+}
+/** AI provider 호출 실패 */
+export declare class ProviderError extends ForgenError {
+    readonly providerName: string;
+    readonly statusCode: number | undefined;
+    constructor(message: string, options?: ProviderErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+export interface HookErrorOptions extends ForgenErrorOptions {
+    hookName?: string;
+    eventType?: string;
+}
+/** hook 실행 실패 */
+export declare class HookError extends ForgenError {
+    readonly hookName: string;
+    readonly eventType: string;
+    constructor(message: string, options?: HookErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+export interface ConfigErrorOptions extends ForgenErrorOptions {
+    configPath?: string;
+    field?: string;
+}
+/** 설정 파일 파싱/검증 실패 */
+export declare class ConfigError extends ForgenError {
+    readonly configPath: string;
+    readonly field: string | undefined;
+    constructor(message: string, options?: ConfigErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+export interface PackErrorOptions extends ForgenErrorOptions {
+    packName?: string;
+}
+/** pack 설치/로드 실패 */
+export declare class PackError extends ForgenError {
+    readonly packName: string;
+    constructor(message: string, options?: PackErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+export interface ForgeErrorOptions extends ForgenErrorOptions {
+    dimension?: string;
+    profile?: string;
+}
+/** forge dimension/profile 관련 실패 */
+export declare class ForgeError extends ForgenError {
+    readonly dimension: string | undefined;
+    readonly profile: string | undefined;
+    constructor(message: string, options?: ForgeErrorOptions);
+    toJSON(): Record<string, unknown>;
+}
+/** 재시도 불가 에러 (401/403 등) — provider 내부에서 사용 */
+export declare class NonRetryableError extends ForgenError {
+    constructor(message: string);
+}

package/dist/core/errors.js

@@ -0,0 +1,133 @@
+/**
+ * Forgen — Domain Error Classes
+ *
+ * 도메인별 에러 계층:
+ *   ForgenError (base)
+ *   ├── ProviderError    — AI provider 호출 실패
+ *   ├── HookError        — hook 실행 실패
+ *   ├── ConfigError      — 설정 파일 파싱/검증 실패
+ *   ├── PackError        — pack 설치/로드 실패
+ *   ├── ForgeError       — forge dimension/profile 관련 실패
+ *   └── NonRetryableError — 재시도 불가 에러 (provider 내부 사용)
+ */
+/** 모든 forgen 에러의 기반 클래스 */
+export class ForgenError extends Error {
+    code;
+    context;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = 'ForgenError';
+        this.code = options.code ?? 'FORGEN_ERROR';
+        this.context = options.context ?? {};
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+        };
+    }
+}
+/** AI provider 호출 실패 */
+export class ProviderError extends ForgenError {
+    providerName;
+    statusCode;
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? 'PROVIDER_ERROR' });
+        this.name = 'ProviderError';
+        this.providerName = options.providerName ?? 'unknown';
+        this.statusCode = options.statusCode;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            providerName: this.providerName,
+            statusCode: this.statusCode,
+        };
+    }
+}
+/** hook 실행 실패 */
+export class HookError extends ForgenError {
+    hookName;
+    eventType;
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? 'HOOK_ERROR' });
+        this.name = 'HookError';
+        this.hookName = options.hookName ?? 'unknown';
+        this.eventType = options.eventType ?? 'unknown';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            hookName: this.hookName,
+            eventType: this.eventType,
+        };
+    }
+}
+/** 설정 파일 파싱/검증 실패 */
+export class ConfigError extends ForgenError {
+    configPath;
+    field;
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? 'CONFIG_ERROR' });
+        this.name = 'ConfigError';
+        this.configPath = options.configPath ?? 'unknown';
+        this.field = options.field;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            configPath: this.configPath,
+            field: this.field,
+        };
+    }
+}
+/** pack 설치/로드 실패 */
+export class PackError extends ForgenError {
+    packName;
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? 'PACK_ERROR' });
+        this.name = 'PackError';
+        this.packName = options.packName ?? 'unknown';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            packName: this.packName,
+        };
+    }
+}
+/** forge dimension/profile 관련 실패 */
+export class ForgeError extends ForgenError {
+    dimension;
+    profile;
+    constructor(message, options = {}) {
+        super(message, { ...options, code: options.code ?? 'FORGE_ERROR' });
+        this.name = 'ForgeError';
+        this.dimension = options.dimension;
+        this.profile = options.profile;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            dimension: this.dimension,
+            profile: this.profile,
+        };
+    }
+}
+// ── NonRetryable ──
+/** 재시도 불가 에러 (401/403 등) — provider 내부에서 사용 */
+export class NonRetryableError extends ForgenError {
+    constructor(message) {
+        super(message, { code: 'NON_RETRYABLE_ERROR' });
+        this.name = 'NonRetryableError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}

package/dist/core/global-config.d.ts

@@ -0,0 +1,43 @@
+import type { QualityPack, AutonomyPack, TrustPolicy } from '../store/types.js';
+export type NotifyVerbosity = 'minimal' | 'session' | 'agent' | 'verbose';
+export interface GatewayConfig {
+    url: string;
+    headers?: Record<string, string>;
+    events?: string[];
+    enabled: boolean;
+}
+export interface GlobalConfig {
+    /** 사용자 프로필 이름 */
+    name?: string;
+    /** UI 언어 (ko | en) */
+    locale?: 'ko' | 'en';
+    /** 기본으로 --dangerously-skip-permissions 활성화 */
+    dangerouslySkipPermissions?: boolean;
+    /** 모델 라우팅 프리셋 */
+    modelRouting?: 'default' | 'cost-saving' | 'max-quality';
+    /** 알림 상세도 */
+    notifyVerbosity?: NotifyVerbosity;
+    /** 이벤트 게이트웨이 설정 */
+    gateway?: GatewayConfig;
+    /** 현재 적용된 base packs */
+    base_packs?: {
+        quality_pack: QualityPack;
+        autonomy_pack: AutonomyPack;
+    };
+    /** 사용자 trust 선호 */
+    trust_preferences?: {
+        desired_policy: TrustPolicy;
+    };
+    /** forgen inspect 표시 설정 */
+    inspect?: {
+        show_facets: boolean;
+        show_evidence: boolean;
+        max_evidence: number;
+    };
+    /** 레거시 마이그레이션 백업 경로 */
+    legacy_backup?: string;
+}
+/** v1 config 로드 (~/.forgen/config.json 우선, 레거시 폴백) */
+export declare function loadGlobalConfig(): GlobalConfig;
+/** v1 config 저장 (~/.forgen/config.json) */
+export declare function saveGlobalConfig(config: GlobalConfig): void;

package/dist/core/global-config.js

@@ -0,0 +1,25 @@
+import * as fs from 'node:fs';
+import { GLOBAL_CONFIG, V1_GLOBAL_CONFIG } from './paths.js';
+/** v1 config 로드 (~/.forgen/config.json 우선, 레거시 폴백) */
+export function loadGlobalConfig() {
+    // v1 경로 우선
+    if (fs.existsSync(V1_GLOBAL_CONFIG)) {
+        try {
+            return JSON.parse(fs.readFileSync(V1_GLOBAL_CONFIG, 'utf-8'));
+        }
+        catch { /* fall through */ }
+    }
+    // 레거시 폴백
+    if (fs.existsSync(GLOBAL_CONFIG)) {
+        try {
+            return JSON.parse(fs.readFileSync(GLOBAL_CONFIG, 'utf-8'));
+        }
+        catch { /* fall through */ }
+    }
+    return {};
+}
+/** v1 config 저장 (~/.forgen/config.json) */
+export function saveGlobalConfig(config) {
+    fs.mkdirSync(require('node:path').dirname(V1_GLOBAL_CONFIG), { recursive: true });
+    fs.writeFileSync(V1_GLOBAL_CONFIG, JSON.stringify(config, null, 2));
+}

package/dist/core/harness.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Forgen v1 — Core Harness (prepareHarness entry point)
+ *
+ * v1 설계: v1-bootstrap 기반 세션 오케스트레이션.
+ * philosophy/scope/pack 의존 제거. Profile + Preset Manager + Rule Renderer.
+ *
+ * Module Structure:
+ * - Lines 1-70: Imports, utility helpers
+ * - Lines 70-220: injectSettings — Claude Code settings.json injection
+ * - Lines 220-400: Agent/skill installation helpers
+ * - Lines 400-550: Rule file injection, gitignore, compound memory
+ * - Lines 550+: prepareHarness — main orchestration
+ */
+import { rollbackSettings } from './settings-lock.js';
+import { type V1BootstrapResult } from './v1-bootstrap.js';
+export interface V1HarnessContext {
+    cwd: string;
+    inTmux: boolean;
+    v1: V1BootstrapResult;
+}
+/** 최초 실행 여부: ~/.forgen/ 디렉토리가 없으면 true */
+export declare function isFirstRun(): boolean;
+export { rollbackSettings };
+export declare function prepareHarness(cwd: string): Promise<V1HarnessContext>;