@specpow/framework 0.2.0

package/dist/core/config/config-schema.d.ts.map

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

package/dist/core/config/config-schema.js

@@ -0,0 +1,108 @@
+/**
+ * Config Schema — 移植自 OpenSpec config-schema.ts
+ *
+ * Zod 配置验证模式，定义 SpecPow 全局配置的数据结构
+ */
+import { z } from 'zod';
+// ============================================================
+// Profile 类型
+// ============================================================
+export const ProfileSchema = z.enum(['core', 'custom']).default('core');
+// ============================================================
+// 交付模式
+// ============================================================
+export const DeliverySchema = z.enum(['both', 'skills', 'commands']).default('both');
+// ============================================================
+// AI 工具配置
+// ============================================================
+export const AIToolConfigSchema = z.object({
+    /** 工具名称 */
+    name: z.string(),
+    /** 工具 ID（用于命令匹配） */
+    toolId: z.string(),
+    /** 是否启用 */
+    enabled: z.boolean().default(true),
+    /** 技能目录路径（相对于项目根） */
+    skillsDir: z.string().optional(),
+    /** 命令目录路径 */
+    commandsDir: z.string().optional(),
+    /** 模型配置 */
+    models: z.object({
+        cheap: z.string().default('haiku'),
+        standard: z.string().default('sonnet'),
+        capable: z.string().default('opus'),
+    }).optional(),
+}).passthrough();
+// ============================================================
+// SDD 引擎配置
+// ============================================================
+export const SDDEngineConfigSchema = z.object({
+    maxFixRounds: z.number().min(1).max(100).default(5),
+    workspaceDir: z.string().default('.specpow/sdd'),
+    modelTier: z.enum(['cheap', 'standard', 'capable']).default('standard'),
+    /** Model tier overrides — map tier names to specific model IDs */
+    models: z.object({
+        cheap: z.string().default('haiku'),
+        standard: z.string().default('sonnet'),
+        capable: z.string().default('opus'),
+    }).optional(),
+    /** Per-role model overrides — take precedence over modelTier/model defaults */
+    implementerModel: z.string().optional(),
+    reviewerModel: z.string().optional(),
+    finalReviewModel: z.string().optional(),
+    reviewEnabled: z.boolean().default(true),
+    parallelEnabled: z.boolean().default(false),
+    gitWorktreeEnabled: z.boolean().default(false),
+}).passthrough();
+// ============================================================
+// 工件图配置
+// ============================================================
+export const ArtifactGraphConfigSchema = z.object({
+    schema: z.string().default('spec-driven'),
+    schemasDir: z.string().default('schemas'),
+    autoValidate: z.boolean().default(true),
+}).passthrough();
+// ============================================================
+// 功能开关
+// ============================================================
+export const FeatureFlagsSchema = z.record(z.string(), z.boolean()).default({
+    parallelAgents: false,
+    gitWorktree: false,
+    autoCommit: true,
+    tddEnforcement: true,
+    visualCompanion: false,
+});
+// ============================================================
+// 主配置 Schema
+// ============================================================
+export const GlobalConfigSchema = z.object({
+    /** 配置格式版本 */
+    version: z.string().default('0.1.0'),
+    /** 配置文件 */
+    profile: ProfileSchema,
+    /** 交付模式 */
+    delivery: DeliverySchema,
+    /** AI 工具列表 */
+    tools: z.array(AIToolConfigSchema).default([]),
+    /** SDD 引擎配置 */
+    sdd: SDDEngineConfigSchema.default({}),
+    /** 工件图配置 */
+    artifactGraph: ArtifactGraphConfigSchema.default({}),
+    /** 工作流启用列表 */
+    workflows: z.array(z.string()).default(['feature-dev', 'bug-fix', 'crud-module']),
+    /** 默认存储 */
+    defaultStore: z.string().optional(),
+    /** 全局编码约束 */
+    globalConstraints: z.string().optional(),
+    /** 项目级上下文描述（注入到 AI 指令中，帮助 AI 理解项目背景） */
+    context: z.string().optional(),
+    /** 每个工件的定制规则（key 为工件 ID，value 为规则字符串数组） */
+    rules: z.record(z.string(), z.array(z.string())).default({}),
+    /** 功能开关 */
+    featureFlags: FeatureFlagsSchema,
+}).passthrough();
+// ============================================================
+// 默认配置
+// ============================================================
+export const DEFAULT_CONFIG = GlobalConfigSchema.parse({});
+//# sourceMappingURL=config-schema.js.map

package/dist/core/config/config-schema.js.map

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

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

@@ -0,0 +1,73 @@
+/**
+ * Global Config — 移植自 OpenSpec global-config.ts
+ *
+ * 全局配置读写管理：
+ * - 项目级配置 (.specpow/config.json)
+ * - 支持 get/set/delete 深层路径操作
+ * - Zod 验证
+ */
+import { type GlobalConfig } from './config-schema.js';
+/**
+ * 验证点号分隔的配置键路径
+ */
+export declare function validateConfigPathKey(path: string): boolean;
+/**
+ * 获取深层嵌套值
+ * 例如：getNestedValue(config, 'sdd.maxFixRounds')
+ */
+export declare function getNestedValue(obj: Record<string, any>, path: string): any;
+/**
+ * 设置深层嵌套值（创建中间对象）
+ */
+export declare function setNestedValue(obj: Record<string, any>, path: string, value: any): void;
+/**
+ * 删除深层嵌套值
+ */
+export declare function deleteNestedValue(obj: Record<string, any>, path: string): boolean;
+/**
+ * 值类型强制转换
+ */
+export declare function coerceValue(value: string, forceString?: boolean): any;
+export declare class GlobalConfigManager {
+    private configPath;
+    private cachedConfig;
+    constructor(projectRoot: string);
+    /**
+     * 加载配置
+     */
+    load(): GlobalConfig;
+    /**
+     * 保存配置
+     */
+    save(config: GlobalConfig): void;
+    /**
+     * 获取配置值（支持点号路径）
+     */
+    get(path?: string): any;
+    /**
+     * 设置配置值（支持点号路径）
+     */
+    set(path: string, value: any): void;
+    /**
+     * 删除配置值
+     */
+    delete(path: string): boolean;
+    /**
+     * 列出所有配置（扁平化）
+     */
+    list(): Record<string, any>;
+    /**
+     * 确保配置文件存在
+     */
+    ensure(): GlobalConfig;
+    /**
+     * 重置为默认配置
+     */
+    reset(): void;
+    /**
+     * 检查新字段并补充默认值
+     */
+    migrate(newDefaults?: Partial<GlobalConfig>): void;
+    private flattenObject;
+}
+//# sourceMappingURL=global-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global-config.d.ts","sourceRoot":"","sources":["../../../src/core/config/global-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAQ1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAUvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,GAAG,CAuB5E;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA6B;gBAErC,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,IAAI,IAAI,YAAY;IA6BpB;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAWhC;;OAEG;IACH,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG;IASvB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAUnC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAa7B;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAO3B;;OAEG;IACH,MAAM,IAAI,YAAY;IAUtB;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAUlD,OAAO,CAAC,aAAa;CAUtB"}

package/dist/core/config/global-config.js

@@ -0,0 +1,225 @@
+/**
+ * Global Config — 移植自 OpenSpec global-config.ts
+ *
+ * 全局配置读写管理：
+ * - 项目级配置 (.specpow/config.json)
+ * - 支持 get/set/delete 深层路径操作
+ * - Zod 验证
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { GlobalConfigSchema, DEFAULT_CONFIG, } from './config-schema.js';
+/**
+ * 验证点号分隔的配置键路径
+ */
+export function validateConfigPathKey(path) {
+    return /^[a-zA-Z][\w.]*$/.test(path) && path.length > 0;
+}
+/**
+ * 获取深层嵌套值
+ * 例如：getNestedValue(config, 'sdd.maxFixRounds')
+ */
+export function getNestedValue(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === undefined || current === null)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * 设置深层嵌套值（创建中间对象）
+ */
+export function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        if (!(keys[i] in current) || typeof current[keys[i]] !== 'object') {
+            current[keys[i]] = {};
+        }
+        current = current[keys[i]];
+    }
+    current[keys[keys.length - 1]] = value;
+}
+/**
+ * 删除深层嵌套值
+ */
+export function deleteNestedValue(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        if (!(keys[i] in current))
+            return false;
+        current = current[keys[i]];
+    }
+    return delete current[keys[keys.length - 1]];
+}
+/**
+ * 值类型强制转换
+ */
+export function coerceValue(value, forceString = false) {
+    if (forceString)
+        return value;
+    // boolean
+    if (value.toLowerCase() === 'true')
+        return true;
+    if (value.toLowerCase() === 'false')
+        return false;
+    // null
+    if (value.toLowerCase() === 'null')
+        return null;
+    // number
+    const num = Number(value);
+    if (!isNaN(num) && value.trim() !== '')
+        return num;
+    // JSON (array/object)
+    if ((value.startsWith('{') && value.endsWith('}')) ||
+        (value.startsWith('[') && value.endsWith(']'))) {
+        try {
+            return JSON.parse(value);
+        }
+        catch { }
+    }
+    return value;
+}
+// ============================================================
+// Config Manager
+// ============================================================
+export class GlobalConfigManager {
+    configPath;
+    cachedConfig = null;
+    constructor(projectRoot) {
+        this.configPath = join(projectRoot, '.specpow', 'config.json');
+    }
+    /**
+     * 加载配置
+     */
+    load() {
+        if (this.cachedConfig) {
+            return this.cachedConfig;
+        }
+        if (!existsSync(this.configPath)) {
+            this.cachedConfig = structuredClone(DEFAULT_CONFIG);
+            return this.cachedConfig;
+        }
+        try {
+            const raw = JSON.parse(readFileSync(this.configPath, 'utf-8'));
+            const result = GlobalConfigSchema.safeParse(raw);
+            if (result.success) {
+                this.cachedConfig = result.data;
+                return result.data;
+            }
+            // 验证失败 — 返回默认配置并记录警告
+            console.warn('Config validation failed, using defaults:', result.error.issues);
+        }
+        catch (err) {
+            console.warn(`Failed to load config (${err.message}), using defaults.`);
+        }
+        this.cachedConfig = structuredClone(DEFAULT_CONFIG);
+        return this.cachedConfig;
+    }
+    /**
+     * 保存配置
+     */
+    save(config) {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const validated = GlobalConfigSchema.parse(config);
+        writeFileSync(this.configPath, JSON.stringify(validated, null, 2), 'utf-8');
+        this.cachedConfig = validated;
+    }
+    /**
+     * 获取配置值（支持点号路径）
+     */
+    get(path) {
+        const config = this.load();
+        if (path === undefined)
+            return config;
+        if (!validateConfigPathKey(path)) {
+            throw new Error(`Invalid config path: ${path}`);
+        }
+        return getNestedValue(config, path);
+    }
+    /**
+     * 设置配置值（支持点号路径）
+     */
+    set(path, value) {
+        if (!validateConfigPathKey(path)) {
+            throw new Error(`Invalid config path: ${path}`);
+        }
+        const config = this.load();
+        setNestedValue(config, path, value);
+        this.save(config);
+    }
+    /**
+     * 删除配置值
+     */
+    delete(path) {
+        if (!validateConfigPathKey(path)) {
+            throw new Error(`Invalid config path: ${path}`);
+        }
+        const config = this.load();
+        const result = deleteNestedValue(config, path);
+        if (result) {
+            this.save(config);
+        }
+        return result;
+    }
+    /**
+     * 列出所有配置（扁平化）
+     */
+    list() {
+        const config = this.load();
+        const flat = {};
+        this.flattenObject(config, '', flat);
+        return flat;
+    }
+    /**
+     * 确保配置文件存在
+     */
+    ensure() {
+        const config = this.load();
+        if (!existsSync(this.configPath)) {
+            this.save(config);
+        }
+        return config;
+    }
+    /**
+     * 重置为默认配置
+     */
+    reset() {
+        const dir = dirname(this.configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.configPath, JSON.stringify(DEFAULT_CONFIG, null, 2), 'utf-8');
+        this.cachedConfig = structuredClone(DEFAULT_CONFIG);
+    }
+    /**
+     * 检查新字段并补充默认值
+     */
+    migrate(newDefaults) {
+        const config = this.load();
+        const merged = GlobalConfigSchema.parse({ ...structuredClone(DEFAULT_CONFIG), ...config, ...newDefaults });
+        this.save(merged);
+    }
+    // ============================================================
+    // 私有
+    // ============================================================
+    flattenObject(obj, prefix, result) {
+        for (const [key, value] of Object.entries(obj)) {
+            const fullKey = prefix ? `${prefix}.${key}` : key;
+            if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                this.flattenObject(value, fullKey, result);
+            }
+            else {
+                result[fullKey] = value;
+            }
+        }
+    }
+}
+//# sourceMappingURL=global-config.js.map

package/dist/core/config/global-config.js.map

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

package/dist/core/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Config 模块 — 全局配置管理
+ *
+ * P1-7: Context/Rules 注入支持
+ */
+export * from './config-schema.js';
+export * from './global-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/core/config/index.js

@@ -0,0 +1,8 @@
+/**
+ * Config 模块 — 全局配置管理
+ *
+ * P1-7: Context/Rules 注入支持
+ */
+export * from './config-schema.js';
+export * from './global-config.js';
+//# sourceMappingURL=index.js.map

package/dist/core/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/core/hooks/hook-registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Hook 注册表
+ *
+ * P2-11: 管理所有 Hook 处理器的注册和调度
+ */
+import type { HookHandler, HookEvent, HookContext, HookResult, PlatformOutput } from './hook-types.js';
+export declare class HookRegistry {
+    private handlers;
+    /**
+     * 注册 Hook 处理器
+     */
+    register(handler: HookHandler): void;
+    /**
+     * 获取指定事件的所有处理器
+     */
+    getHandlers(event: HookEvent): HookHandler[];
+    /**
+     * 执行指定事件的所有处理器
+     */
+    execute(event: HookEvent, context: HookContext): Promise<HookResult[]>;
+    /**
+     * 合并多个 Hook 结果
+     */
+    mergeResults(results: HookResult[]): HookResult;
+    /**
+     * 格式化输出为平台特定格式
+     */
+    formatForPlatform(result: HookResult, event: HookEvent, _platform: 'claude' | 'cursor' | 'copilot' | 'unknown'): PlatformOutput;
+}
+/**
+ * 获取默认 Hook 注册表
+ */
+export declare function getDefaultRegistry(): HookRegistry;
+/**
+ * 执行 SessionStart Hook
+ */
+export declare function executeSessionStart(projectRoot: string, platform?: 'claude' | 'cursor' | 'copilot' | 'unknown'): Promise<string>;
+/**
+ * 执行 UserPromptSubmit Hook
+ */
+export declare function executeUserPromptSubmit(projectRoot: string, userInput: string, platform?: 'claude' | 'cursor' | 'copilot' | 'unknown'): Promise<string>;
+/**
+ * 执行 PreToolCall Hook
+ */
+export declare function executePreToolCall(projectRoot: string, toolName: string, toolInput?: Record<string, unknown>, platform?: 'claude' | 'cursor' | 'copilot' | 'unknown'): Promise<{
+    context: string;
+    blocked: boolean;
+    blockReason?: string;
+    warnings: string[];
+}>;
+/**
+ * 执行 PostToolCall Hook
+ */
+export declare function executePostToolCall(projectRoot: string, toolName: string, toolSuccess: boolean, toolOutput?: unknown, platform?: 'claude' | 'cursor' | 'copilot' | 'unknown'): Promise<string>;
+//# sourceMappingURL=hook-registry.d.ts.map

package/dist/core/hooks/hook-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-registry.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/hook-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQvG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMpC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE;IAI5C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoB5E;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU;IAyC/C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc;CAkBhI;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAYjD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMjJ;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAqB,GAChE,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,GAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAqB,GAChE,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAY1F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,GAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAqB,GAChE,OAAO,CAAC,MAAM,CAAC,CAYjB"}