@clawplays/ospec-cli 0.1.1

package/dist/utils/PathUtils.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathUtils = void 0;
+const path = __importStar(require("path"));
+const constants_1 = require("../core/constants");
+class PathUtils {
+    static getChangeDir(rootDir, bucket, featureName) {
+        return path.join(rootDir, constants_1.DIR_NAMES.CHANGES, bucket, featureName);
+    }
+    static getFeatureDir(rootDir, featureName) {
+        return this.getChangeDir(rootDir, constants_1.DIR_NAMES.ACTIVE, featureName);
+    }
+    static getFeatureFile(featureDir, type) {
+        const fileNames = {
+            proposal: constants_1.FILE_NAMES.PROPOSAL,
+            tasks: constants_1.FILE_NAMES.TASKS,
+            state: constants_1.FILE_NAMES.STATE,
+            verification: constants_1.FILE_NAMES.VERIFICATION,
+        };
+        return path.join(featureDir, fileNames[type]);
+    }
+    static normalize(filePath) {
+        return path.normalize(filePath).replace(/\\/g, '/');
+    }
+    static isAbsolute(filePath) {
+        return path.isAbsolute(filePath);
+    }
+    static getRelative(from, to) {
+        return path.relative(from, to).replace(/\\/g, '/');
+    }
+}
+exports.PathUtils = PathUtils;
+//# sourceMappingURL=PathUtils.js.map

package/dist/utils/StringUtils.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 字符串工具函数
+ */
+export declare class StringUtils {
+    /**
+     * 转换为 kebab-case
+     */
+    static toKebabCase(str: string): string;
+    /**
+     * 转换为 camelCase
+     */
+    static toCamelCase(str: string): string;
+    /**
+     * 转换为 PascalCase
+     */
+    static toPascalCase(str: string): string;
+    /**
+     * 截断字符串
+     */
+    static truncate(str: string, length: number, suffix?: string): string;
+    /**
+     * 去除空白
+     */
+    static trim(str: string): string;
+}
+//# sourceMappingURL=StringUtils.d.ts.map

package/dist/utils/StringUtils.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * 字符串工具函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringUtils = void 0;
+class StringUtils {
+    /**
+     * 转换为 kebab-case
+     */
+    static toKebabCase(str) {
+        return str
+            .replace(/([a-z])([A-Z])/g, '$1-$2')
+            .replace(/[\s_]+/g, '-')
+            .toLowerCase();
+    }
+    /**
+     * 转换为 camelCase
+     */
+    static toCamelCase(str) {
+        return str
+            .replace(/[-_\s](.)/g, (_, c) => c.toUpperCase())
+            .replace(/^(.)/, (_, c) => c.toLowerCase());
+    }
+    /**
+     * 转换为 PascalCase
+     */
+    static toPascalCase(str) {
+        return str
+            .replace(/[-_\s](.)/g, (_, c) => c.toUpperCase())
+            .replace(/^(.)/, (_, c) => c.toUpperCase());
+    }
+    /**
+     * 截断字符串
+     */
+    static truncate(str, length, suffix = '...') {
+        return str.length > length ? str.substring(0, length - suffix.length) + suffix : str;
+    }
+    /**
+     * 去除空白
+     */
+    static trim(str) {
+        return str.trim();
+    }
+}
+exports.StringUtils = StringUtils;
+//# sourceMappingURL=StringUtils.js.map

package/dist/utils/helpers.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 工具函数
+ * TODO: 实现辅助函数
+ */
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 工具函数
+ * TODO: 实现辅助函数
+ */
+//# sourceMappingURL=helpers.js.map

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 工具函数导出
+ */
+export * from './PathUtils';
+export * from './StringUtils';
+export * from './DateUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * 工具函数导出
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./PathUtils"), exports);
+__exportStar(require("./StringUtils"), exports);
+__exportStar(require("./DateUtils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 日志输出
+ * TODO: 实现日志功能
+ */
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 日志输出
+ * TODO: 实现日志功能
+ */
+//# sourceMappingURL=logger.js.map

package/dist/utils/path.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 路径处理
+ * TODO: 实现路径处理函数
+ */
+//# sourceMappingURL=path.d.ts.map

package/dist/utils/path.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 路径处理
+ * TODO: 实现路径处理函数
+ */
+//# sourceMappingURL=path.js.map

package/dist/utils/subcommandHelp.d.ts

@@ -0,0 +1,11 @@
+export declare function isHelpAction(action?: string): boolean;
+export declare function getDocsHelpText(): string;
+export declare function getSkillsHelpText(): string;
+export declare function getSkillHelpText(): string;
+export declare function getIndexHelpText(): string;
+export declare function getWorkflowHelpText(): string;
+export declare function getBatchHelpText(): string;
+export declare function getChangesHelpText(): string;
+export declare function getQueueHelpText(): string;
+export declare function getRunHelpText(): string;
+//# sourceMappingURL=subcommandHelp.d.ts.map

package/dist/utils/subcommandHelp.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHelpAction = isHelpAction;
+exports.getDocsHelpText = getDocsHelpText;
+exports.getSkillsHelpText = getSkillsHelpText;
+exports.getSkillHelpText = getSkillHelpText;
+exports.getIndexHelpText = getIndexHelpText;
+exports.getWorkflowHelpText = getWorkflowHelpText;
+exports.getPluginsHelpText = getPluginsHelpText;
+exports.getBatchHelpText = getBatchHelpText;
+exports.getChangesHelpText = getChangesHelpText;
+exports.getQueueHelpText = getQueueHelpText;
+exports.getRunHelpText = getRunHelpText;
+const HELP_ACTIONS = new Set(['help', '--help', '-h']);
+function isHelpAction(action) {
+    return HELP_ACTIONS.has(action || '');
+}
+function getDocsHelpText() {
+    return `
+Docs Commands:
+  ospec docs status [path]    - show project docs coverage and missing items
+  ospec docs generate [path]  - explicitly backfill the project knowledge layer after protocol-shell init
+                               - does not create business scaffold or docs/project/bootstrap-summary.md
+  ospec docs sync-protocol [path] - refresh protocol/AI adopted docs for an existing project
+                                   - affects future work only; does not migrate existing changes
+  ospec docs help             - show docs command help
+`;
+}
+function getSkillsHelpText() {
+    return `
+Skills Commands:
+  ospec skills status [path]  - show layered skill coverage and index status
+  ospec skills help           - show skills command help
+`;
+}
+function getSkillHelpText() {
+    return `
+Skill Package Commands:
+  ospec skill status [skill-name] [dir]          - inspect one Codex OSpec skill, defaults to ospec-change
+  ospec skill install [skill-name] [dir]         - install one Codex OSpec skill, defaults to ospec-change
+  ospec skill status-claude [skill-name] [dir]   - inspect one Claude Code OSpec skill, defaults to ospec-change
+  ospec skill install-claude [skill-name] [dir]  - install one Claude Code OSpec skill, defaults to ospec-change
+  ospec skill help                  - show skill command help
+`;
+}
+function getIndexHelpText() {
+    return `
+Index Commands:
+  ospec index check [path]  - inspect index presence, freshness, and stats
+  ospec index build [path]  - rebuild SKILL.index.json
+  ospec index help          - show index command help
+`;
+}
+function getWorkflowHelpText() {
+    return `
+Workflow Commands:
+  ospec workflow show [path]        - show workflow configuration for the project
+  ospec workflow list-flags [path]  - list supported workflow flags
+  ospec workflow set-mode <mode> [path] - switch the project workflow mode and sync .skillrc.workflow
+  ospec workflow help               - show workflow command help
+`;
+}
+function getPluginsHelpText() {
+    return `
+Plugins Commands:
+  ospec plugins list [path]            - list plugins available in the project config
+  ospec plugins status [path]          - show plugin and capability status
+  ospec plugins doctor stitch [path]   - validate the configured Stitch provider adapter or custom Stitch runner config
+  ospec plugins doctor checkpoint [path] - validate checkpoint base_url, workspace scaffold, and runner config
+  ospec plugins enable stitch [path]   - enable Stitch for new changes by default
+  ospec plugins enable checkpoint [path] --base-url <url> - enable checkpoint and save the runtime base URL
+  ospec plugins disable stitch [path]  - disable Stitch for new changes by default
+  ospec plugins disable checkpoint [path] - disable checkpoint for new changes by default
+  ospec plugins run stitch <path>      - run the configured Stitch provider adapter or custom runner and submit a preview
+  ospec plugins run checkpoint <path>  - run checkpoint automation, write gate/result artifacts, and sync passed optional steps
+  ospec plugins approve stitch <path>  - mark Stitch design review approved and sync verification.md
+  ospec plugins reject stitch <path>   - mark Stitch design review rejected and sync verification.md
+  ospec plugins help                   - show plugins command help
+`;
+}
+function getBatchHelpText() {
+    return `
+Batch Commands:
+  ospec batch export [path]  - export change data in batch
+  ospec batch stats [path]   - show aggregated change statistics
+  ospec batch help           - show batch command help
+`;
+}
+function getChangesHelpText() {
+    return `
+Changes Commands:
+  ospec changes status [path]  - show PASS/WARN/FAIL protocol status for every active change
+  ospec finalize [path]        - verify and archive a completed change before commit
+  ospec changes help           - show changes command help
+`;
+}
+function getQueueHelpText() {
+    return `
+Queue Commands:
+  ospec queue status [path]                    - show queued changes without activating them
+  ospec queue add <change-name> [path] [--flags flag1,flag2] - create a queued change explicitly
+  ospec queue activate <change-name> [path]    - move one queued change into changes/active
+  ospec queue next [path]                      - activate the next queued change
+  ospec queue help                             - show queue command help
+`;
+}
+function getRunHelpText() {
+    return `
+Run Commands:
+  ospec run start [path] [--profile manual-safe|archive-chain] - start explicit queue tracking
+  ospec run status [path]                                      - show current queue run status
+  ospec run step [path]                                        - advance one explicit queue step
+  ospec run resume [path]                                      - resume a paused or failed queue run
+  ospec run stop [path]                                        - pause the current queue run
+  ospec run logs [path]                                        - show recent queue run log lines
+  ospec run help                                               - show run command help
+`;
+}
+//# sourceMappingURL=subcommandHelp.js.map

package/dist/workflow/ArchiveGate.d.ts

@@ -0,0 +1,30 @@
+import { FeatureState } from '../core/types';
+export interface ArchiveGateConfig {
+    require_verification: boolean;
+    require_skill_update: boolean;
+    require_index_regenerated: boolean;
+    require_optional_steps_passed: boolean;
+}
+export interface ArchiveCheckResult {
+    canArchive: boolean;
+    checks: {
+        name: string;
+        passed: boolean;
+        message: string;
+    }[];
+    blockers: string[];
+    warnings: string[];
+}
+export interface ArchiveProtocolState {
+    activatedSteps: string[];
+    tasksOptionalSteps: string[];
+    verificationOptionalSteps: string[];
+    passedOptionalSteps: string[];
+    tasksComplete: boolean;
+    verificationComplete: boolean;
+}
+export declare class ArchiveGate {
+    checkArchiveReadiness(featureState: FeatureState, config: ArchiveGateConfig, protocolState?: ArchiveProtocolState): Promise<ArchiveCheckResult>;
+}
+export declare const archiveGate: ArchiveGate;
+//# sourceMappingURL=ArchiveGate.d.ts.map

package/dist/workflow/ArchiveGate.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archiveGate = exports.ArchiveGate = void 0;
+class ArchiveGate {
+    async checkArchiveReadiness(featureState, config, protocolState) {
+        const checks = [];
+        const blockers = [];
+        const warnings = [];
+        const verificationPassed = featureState.completed.includes('verification_passed');
+        checks.push({
+            name: 'Verification Passed',
+            passed: verificationPassed || !config.require_verification,
+            message: verificationPassed
+                ? 'Verification has been completed'
+                : 'Verification required but not completed',
+        });
+        if (config.require_verification && !verificationPassed) {
+            blockers.push('Verification must be completed before archiving');
+        }
+        const skillUpdated = featureState.completed.includes('skill_updated');
+        checks.push({
+            name: 'Skill Updated',
+            passed: skillUpdated || !config.require_skill_update,
+            message: skillUpdated
+                ? 'Skill documentation has been updated'
+                : 'Skill update required but not completed',
+        });
+        if (config.require_skill_update && !skillUpdated) {
+            blockers.push('Skill documentation must be updated before archiving');
+        }
+        const indexRegenerated = featureState.completed.includes('index_regenerated');
+        checks.push({
+            name: 'Index Regenerated',
+            passed: indexRegenerated || !config.require_index_regenerated,
+            message: indexRegenerated
+                ? 'Index has been regenerated'
+                : 'Index regeneration required but not completed',
+        });
+        if (config.require_index_regenerated && !indexRegenerated) {
+            blockers.push('Index must be regenerated before archiving');
+        }
+        const coreSteps = [
+            'proposal_complete',
+            'tasks_complete',
+            'implementation_complete',
+            'verification_passed',
+        ];
+        const corePassed = coreSteps.every(step => featureState.completed.includes(step));
+        checks.push({
+            name: 'Core Steps Completed',
+            passed: corePassed,
+            message: corePassed
+                ? 'All core steps have been completed'
+                : 'Some core steps are still pending',
+        });
+        if (!corePassed) {
+            blockers.push('All core steps must be completed before archiving');
+        }
+        if (featureState.status !== 'ready_to_archive') {
+            blockers.push('state.json.status must be ready_to_archive before archiving');
+        }
+        if (protocolState) {
+            const missingTaskCoverage = protocolState.activatedSteps.filter(step => !protocolState.tasksOptionalSteps.includes(step));
+            if (missingTaskCoverage.length > 0) {
+                blockers.push(`Activated optional steps missing from tasks.md: ${missingTaskCoverage.join(', ')}`);
+            }
+            const missingVerificationCoverage = protocolState.activatedSteps.filter(step => !protocolState.verificationOptionalSteps.includes(step));
+            if (missingVerificationCoverage.length > 0) {
+                blockers.push(`Activated optional steps missing from verification.md: ${missingVerificationCoverage.join(', ')}`);
+            }
+            const missingPassedSteps = protocolState.activatedSteps.filter(step => !protocolState.passedOptionalSteps.includes(step));
+            if (config.require_optional_steps_passed && missingPassedSteps.length > 0) {
+                blockers.push('All activated optional steps must be passed before archiving');
+                warnings.push(`Optional steps not yet passed: ${missingPassedSteps.join(', ')}`);
+            }
+            if (!protocolState.tasksComplete) {
+                blockers.push('tasks.md still has unchecked items');
+            }
+            if (!protocolState.verificationComplete) {
+                blockers.push('verification.md still has unchecked items');
+            }
+        }
+        return {
+            canArchive: blockers.length === 0,
+            checks,
+            blockers,
+            warnings,
+        };
+    }
+}
+exports.ArchiveGate = ArchiveGate;
+exports.archiveGate = new ArchiveGate();
+//# sourceMappingURL=ArchiveGate.js.map

package/dist/workflow/ConfigurableWorkflow.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 可配置工作流系统
+ * 基于 OSpec 官方规范实现
+ * 支持核心步骤 + 可选步骤 + Feature Flags
+ */
+export type CoreStep = 'proposal' | 'tasks' | 'state' | 'verification' | 'skill_update' | 'index_regenerated';
+export type OptionalStep = 'code_review' | 'design_doc' | 'plan_doc' | 'security_review' | 'adr' | 'db_change_doc' | 'api_change_doc';
+export interface OptionalStepConfig {
+    enabled: boolean;
+    when: string[];
+}
+export interface WorkflowConfigType {
+    core_required: CoreStep[];
+    optional_steps: Record<OptionalStep, OptionalStepConfig>;
+    archive_gate: {
+        require_verification: boolean;
+        require_skill_update: boolean;
+        require_index_regenerated: boolean;
+        require_optional_steps_passed: boolean;
+    };
+    feature_flags: {
+        supported: string[];
+    };
+}
+/**
+ * 3种预定义工作流模板
+ */
+export declare const WORKFLOW_PRESETS: Record<string, WorkflowConfigType>;
+export declare class ConfigurableWorkflow {
+    private config;
+    private mode;
+    constructor(mode: string);
+    /**
+     * 根据 feature flags 确定激活的可选步骤
+     */
+    getActivatedSteps(featureFlags: string[]): OptionalStep[];
+    /**
+     * 获取完整的工作流步骤（核心 + 激活的可选）
+     */
+    getFullWorkflow(featureFlags: string[]): string[];
+    /**
+     * 获取核心步骤
+     */
+    getCoreSteps(): CoreStep[];
+    /**
+     * 获取所有支持的 feature flags
+     */
+    getSupportedFlags(): string[];
+    /**
+     * 验证 feature flags
+     */
+    validateFlags(flags: string[]): {
+        valid: boolean;
+        unsupported: string[];
+    };
+    /**
+     * 获取步骤的依赖关系
+     */
+    getStepDependencies(step: string): string[];
+    /**
+     * 获取工作流配置
+     */
+    getConfig(): WorkflowConfigType;
+    /**
+     * 获取存档门禁配置
+     */
+    getArchiveGate(): {
+        require_verification: boolean;
+        require_skill_update: boolean;
+        require_index_regenerated: boolean;
+        require_optional_steps_passed: boolean;
+    };
+    /**
+     * 生成工作流摘要
+     */
+    getSummary(featureFlags: string[]): {
+        mode: string;
+        coreSteps: number;
+        optionalSteps: string[];
+        totalSteps: number;
+        flags: string[];
+        unsupportedFlags: string[];
+    };
+    /**
+     * 获取当前模式
+     */
+    getMode(): string;
+}
+//# sourceMappingURL=ConfigurableWorkflow.d.ts.map