@clawplays/ospec-cli 0.1.1

package/dist/core/constants.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_STEPS = exports.DATETIME_FORMAT = exports.DATE_FORMAT = exports.NAMING_RULES = exports.DIR_NAMES = exports.FILE_NAMES = exports.CORE_REQUIRED_STEPS = exports.STATE_TRANSITIONS = void 0;
+exports.STATE_TRANSITIONS = {
+    queued: ['draft'],
+    draft: ['proposed'],
+    proposed: ['planned', 'draft'],
+    planned: ['implementing', 'proposed'],
+    implementing: ['verifying', 'planned'],
+    verifying: ['ready_to_archive', 'implementing'],
+    ready_to_archive: ['archived', 'verifying'],
+    archived: [],
+};
+exports.CORE_REQUIRED_STEPS = [
+    'proposal',
+    'tasks',
+    'state',
+    'verification',
+    'skill_update',
+    'index_regenerated',
+];
+exports.FILE_NAMES = {
+    SKILLRC: '.skillrc',
+    SKILL_MD: 'SKILL.md',
+    SKILL_INDEX: 'SKILL.index.json',
+    README: 'README.md',
+    BUILD_INDEX_SCRIPT: 'build-index-auto.cjs',
+    AI_GUIDE: 'ai-guide.md',
+    EXECUTION_PROTOCOL: 'execution-protocol.md',
+    PROPOSAL: 'proposal.md',
+    TASKS: 'tasks.md',
+    VERIFICATION: 'verification.md',
+    STATE: 'state.json',
+    REVIEW: 'review.md',
+    INDEX: 'INDEX.json',
+};
+exports.DIR_NAMES = {
+    CHANGES: 'changes',
+    ACTIVE: 'active',
+    QUEUED: 'queued',
+    ARCHIVED: 'archived',
+    RUNS: 'runs',
+    HISTORY: 'history',
+    LOGS: 'logs',
+    FOR_AI: 'for-ai',
+    DOCS: 'docs',
+    PROJECT: 'project',
+    DESIGN: 'design',
+    PLANNING: 'planning',
+    API: 'api',
+    SRC: 'src',
+    MODULES: 'modules',
+    CORE: 'core',
+    TESTS: 'tests',
+    DIST: 'dist',
+};
+exports.NAMING_RULES = {
+    FEATURE_NAME: /^[a-z0-9]+(-[a-z0-9]+)*$/,
+    ARCHIVED_DIR: /^\d{4}-\d{2}-\d{2}-[a-z0-9]+(-[a-z0-9]+)*$/,
+};
+exports.DATE_FORMAT = 'YYYY-MM-DD';
+exports.DATETIME_FORMAT = 'YYYY-MM-DDTHH:mm:ssZ';
+exports.WORKFLOW_STEPS = [
+    'proposal_complete',
+    'tasks_complete',
+    'implementation_complete',
+    'skill_updated',
+    'index_regenerated',
+    'tests_passed',
+    'verification_passed',
+    'archived',
+];
+//# sourceMappingURL=constants.js.map

package/dist/core/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 错误类定义
+ */
+export declare class OSpecError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code?: string, details?: any | undefined);
+}
+export declare class ProjectNotInitializedError extends OSpecError {
+    constructor(message?: string);
+}
+export declare class FeatureNotFoundError extends OSpecError {
+    constructor(featureName: string);
+}
+export declare class FeatureAlreadyExistsError extends OSpecError {
+    constructor(featureName: string);
+}
+export declare class InvalidStateTransitionError extends OSpecError {
+    constructor(currentStatus: string, targetStatus: string);
+}
+export declare class ValidationError extends OSpecError {
+    constructor(message: string, details?: any);
+}
+export declare class FileOperationError extends OSpecError {
+    constructor(message: string, details?: any);
+}
+export declare class ConfigError extends OSpecError {
+    constructor(message: string, details?: any);
+}
+export declare class WorkflowError extends OSpecError {
+    constructor(message: string, details?: any);
+}
+export declare class VerificationError extends OSpecError {
+    constructor(message: string, details?: any);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * 错误类定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerificationError = exports.WorkflowError = exports.ConfigError = exports.FileOperationError = exports.ValidationError = exports.InvalidStateTransitionError = exports.FeatureAlreadyExistsError = exports.FeatureNotFoundError = exports.ProjectNotInitializedError = exports.OSpecError = void 0;
+class OSpecError extends Error {
+    constructor(message, code = 'OSPEC_ERROR', details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'OSpecError';
+    }
+}
+exports.OSpecError = OSpecError;
+class ProjectNotInitializedError extends OSpecError {
+    constructor(message = 'Project not initialized. Run `ospec project init` first.') {
+        super(message, 'PROJECT_NOT_INITIALIZED');
+    }
+}
+exports.ProjectNotInitializedError = ProjectNotInitializedError;
+class FeatureNotFoundError extends OSpecError {
+    constructor(featureName) {
+        super(`Feature '${featureName}' not found.`, 'FEATURE_NOT_FOUND', { featureName });
+    }
+}
+exports.FeatureNotFoundError = FeatureNotFoundError;
+class FeatureAlreadyExistsError extends OSpecError {
+    constructor(featureName) {
+        super(`Feature '${featureName}' already exists.`, 'FEATURE_ALREADY_EXISTS', {
+            featureName,
+        });
+    }
+}
+exports.FeatureAlreadyExistsError = FeatureAlreadyExistsError;
+class InvalidStateTransitionError extends OSpecError {
+    constructor(currentStatus, targetStatus) {
+        super(`Cannot transition from '${currentStatus}' to '${targetStatus}'.`, 'INVALID_STATE_TRANSITION', { currentStatus, targetStatus });
+    }
+}
+exports.InvalidStateTransitionError = InvalidStateTransitionError;
+class ValidationError extends OSpecError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', details);
+    }
+}
+exports.ValidationError = ValidationError;
+class FileOperationError extends OSpecError {
+    constructor(message, details) {
+        super(message, 'FILE_OPERATION_ERROR', details);
+    }
+}
+exports.FileOperationError = FileOperationError;
+class ConfigError extends OSpecError {
+    constructor(message, details) {
+        super(message, 'CONFIG_ERROR', details);
+    }
+}
+exports.ConfigError = ConfigError;
+class WorkflowError extends OSpecError {
+    constructor(message, details) {
+        super(message, 'WORKFLOW_ERROR', details);
+    }
+}
+exports.WorkflowError = WorkflowError;
+class VerificationError extends OSpecError {
+    constructor(message, details) {
+        super(message, 'VERIFICATION_ERROR', details);
+    }
+}
+exports.VerificationError = VerificationError;
+//# sourceMappingURL=errors.js.map

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 导出入口
+ */
+export * from './types';
+export * from './constants';
+export * from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/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("./types"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/types.d.ts

@@ -0,0 +1,369 @@
+export type ProjectMode = 'lite' | 'standard' | 'full';
+export type HookCheckPolicy = 'off' | 'warn' | 'error';
+export type ChangeSummaryStatus = 'pass' | 'warn' | 'fail';
+export type FeatureStatus = 'queued' | 'draft' | 'proposed' | 'planned' | 'implementing' | 'verifying' | 'ready_to_archive' | 'archived';
+export interface StitchPageDesignReviewCapabilityConfig {
+    enabled: boolean;
+    step: string;
+    activate_when_flags: string[];
+}
+export interface StitchCommandRunnerConfig {
+    mode: 'command';
+    command: string;
+    args: string[];
+    cwd: string;
+    timeout_ms: number;
+    token_env: string;
+    extra_env: Record<string, string>;
+}
+export interface StitchPluginConfig {
+    enabled: boolean;
+    blocking: boolean;
+    project?: {
+        project_id: string;
+        project_url: string;
+        save_on_first_run: boolean;
+        enforce_single_project: boolean;
+    };
+    gemini?: {
+        model: string;
+        auto_switch_on_limit: boolean;
+        save_on_fallback: boolean;
+    };
+    codex?: {
+        model: string;
+        mcp_server: string;
+    };
+    runner: StitchCommandRunnerConfig;
+    provider?: string;
+    capabilities: {
+        page_design_review: StitchPageDesignReviewCapabilityConfig;
+    };
+}
+export interface CheckpointCapabilityConfig {
+    enabled: boolean;
+    step: string;
+    activate_when_flags: string[];
+}
+export interface CheckpointCommandConfig {
+    command: string;
+    args: string[];
+    cwd: string;
+    timeout_ms: number;
+}
+export interface CheckpointAuthCommandConfig extends CheckpointCommandConfig {
+    when: string;
+}
+export interface CheckpointRuntimeConfig {
+    base_url: string;
+    startup: CheckpointCommandConfig;
+    readiness: {
+        type: string;
+        url: string;
+        timeout_ms: number;
+    };
+    auth: CheckpointAuthCommandConfig;
+    shutdown: CheckpointCommandConfig;
+    storage_state: string;
+}
+export interface CheckpointRunnerConfig {
+    mode: 'command';
+    command: string;
+    args: string[];
+    cwd: string;
+    timeout_ms: number;
+    token_env: string;
+    extra_env: Record<string, string>;
+}
+export interface CheckpointPluginConfig {
+    enabled: boolean;
+    blocking: boolean;
+    runtime: CheckpointRuntimeConfig;
+    runner: CheckpointRunnerConfig;
+    capabilities: {
+        ui_review: CheckpointCapabilityConfig;
+        flow_check: CheckpointCapabilityConfig;
+    };
+    stitch_integration: {
+        enabled: boolean;
+        auto_pass_stitch_review: boolean;
+    };
+}
+export interface SkillrcConfig {
+    version: string;
+    mode: ProjectMode;
+    hooks: {
+        'pre-commit': boolean;
+        'post-merge': boolean;
+        'spec-check': HookCheckPolicy;
+        'change-check'?: HookCheckPolicy;
+        'index-check'?: HookCheckPolicy;
+    };
+    index: {
+        include?: string[];
+        exclude?: string[];
+    };
+    plugins?: {
+        stitch?: StitchPluginConfig;
+        checkpoint?: CheckpointPluginConfig;
+    };
+    workflow?: {
+        core_required: string[];
+        optional_steps: Record<string, {
+            enabled: boolean;
+            when: string[];
+        }>;
+        archive_gate: {
+            require_verification: boolean;
+            require_skill_update: boolean;
+            require_index_regenerated: boolean;
+            require_optional_steps_passed: boolean;
+        };
+        feature_flags: {
+            supported: string[];
+        };
+    };
+}
+export interface FeatureState {
+    version: string;
+    feature: string;
+    mode: ProjectMode;
+    workflow_profile_id?: string;
+    status: FeatureStatus;
+    current_step: string;
+    affects: string[];
+    completed: string[];
+    pending: string[];
+    blocked_by: string[];
+    queued_at?: string;
+    activated_at?: string;
+    queue_source?: string;
+    activation_source?: string;
+    last_updated: string;
+}
+export interface ProposalFrontmatter {
+    name: string;
+    status: 'queued' | 'active' | 'archived';
+    created: string;
+    affects: string[];
+    flags: string[];
+}
+export interface SkillFrontmatter {
+    name: string;
+    title?: string;
+    tags: string[];
+}
+export interface SkillSection {
+    level: number;
+    title: string;
+    start: number;
+    end: number;
+    tags?: string[];
+}
+export interface IndexModule {
+    file: string;
+    title: string;
+    tags: string[];
+    sections: Record<string, SkillSection>;
+}
+export interface SkillIndex {
+    version: string;
+    generated: string;
+    git_commit: string | null;
+    active_changes: string[];
+    stats: {
+        totalFiles: number;
+        totalModules: number;
+        totalSections: number;
+    };
+    modules: Record<string, IndexModule>;
+    tagIndex: Record<string, string[]>;
+}
+export interface CommandResult {
+    success: boolean;
+    message: string;
+    data?: unknown;
+    error?: string;
+}
+export type ProjectStructureLevel = 'none';
+export interface ProjectStructureCheck {
+    key: string;
+    path: string;
+    exists: boolean;
+    required: boolean;
+    category: 'core' | 'knowledge';
+}
+export interface ProjectStructureUpgradeSuggestion {
+    code: string;
+    title: string;
+    description: string;
+    paths: string[];
+}
+export interface ProjectStructureStatus {
+    initialized: boolean;
+    level: ProjectStructureLevel;
+    checks: ProjectStructureCheck[];
+    missingRequired: string[];
+    missingRecommended: string[];
+    upgradeSuggestions: ProjectStructureUpgradeSuggestion[];
+}
+export interface ProjectSummary {
+    name: string;
+    path: string;
+    mode: ProjectMode | null;
+    initialized: boolean;
+    structureLevel: ProjectStructureLevel;
+    createdAt: string | null;
+    activeChangeCount: number;
+    docsRootExists: boolean;
+    forAiExists: boolean;
+    skillIndexExists: boolean;
+}
+export interface ProjectDocumentStatusItem {
+    key: string;
+    path: string;
+    exists: boolean;
+    required: boolean;
+    updatedAt: string | null;
+}
+export interface DocsStatus {
+    total: number;
+    existing: number;
+    coverage: number;
+    items: ProjectDocumentStatusItem[];
+    apiDocs: ApiDocInfo[];
+    designDocs: KnowledgeDocInfo[];
+    planningDocs: KnowledgeDocInfo[];
+    missingRequired: string[];
+    missingRecommended: string[];
+    updatedAt: string | null;
+}
+export interface SkillFileInfo {
+    key: string;
+    path: string;
+    exists: boolean;
+    title: string | null;
+    tags: string[];
+    sectionCount: number;
+    sectionTitles: string[];
+}
+export interface ModuleInfo {
+    name: string;
+    path: string;
+    skillPath: string;
+    skillExists: boolean;
+}
+export interface ApiDocInfo {
+    name: string;
+    path: string;
+    exists: boolean;
+    updatedAt: string | null;
+}
+export interface KnowledgeDocInfo {
+    name: string;
+    path: string;
+    exists: boolean;
+    updatedAt: string | null;
+}
+export interface SkillsStatus {
+    totalSkillFiles: number;
+    existing: number;
+    missingRecommended: string[];
+    rootSkills: SkillFileInfo[];
+    moduleSkills: SkillFileInfo[];
+    modules: ModuleInfo[];
+    skillIndex: {
+        exists: boolean;
+        path: string;
+        updatedAt: string | null;
+        latestSourceUpdatedAt: string | null;
+        needsRebuild: boolean;
+        stale: boolean;
+        reasons: string[];
+        stats: SkillIndex['stats'] | null;
+    };
+}
+export interface ExecutionFeatureSummary {
+    name: string;
+    status: FeatureState['status'];
+    progress: number;
+    currentStep: string;
+    flags: string[];
+    description: string;
+}
+export interface ExecutionStatus {
+    totalActiveChanges: number;
+    byStatus: Record<string, number>;
+    activeChanges: ExecutionFeatureSummary[];
+}
+export interface QueuedChangeStatusItem {
+    name: string;
+    path: string;
+    status: FeatureState['status'];
+    currentStep: string;
+    flags: string[];
+    description: string;
+    queuedAt: string | null;
+    source: string | null;
+}
+export interface ChangeStatusCheck {
+    name: string;
+    status: ChangeSummaryStatus;
+    message: string;
+}
+export interface ActiveChangeStatusItem extends ExecutionFeatureSummary {
+    path: string;
+    activatedSteps: string[];
+    summaryStatus: ChangeSummaryStatus;
+    failCount: number;
+    warnCount: number;
+    archiveReady: boolean;
+    checks: ChangeStatusCheck[];
+}
+export interface ActiveChangeStatusReport {
+    totalActiveChanges: number;
+    totals: Record<ChangeSummaryStatus, number>;
+    changes: ActiveChangeStatusItem[];
+}
+export type QueueRunProfileId = 'manual-safe' | 'archive-chain';
+export type QueueRunStatus = 'running' | 'paused' | 'failed' | 'completed';
+export interface QueueRunChangeRef {
+    name: string;
+    path: string;
+    status: FeatureState['status'];
+    recordedAt: string;
+    note?: string | null;
+}
+export interface QueueRunRecord {
+    id: string;
+    status: QueueRunStatus;
+    executor: 'manual-bridge';
+    profileId: QueueRunProfileId;
+    mode: 'single-active-sequential';
+    projectPath: string;
+    startedAt: string;
+    updatedAt: string;
+    stoppedAt: string | null;
+    completedAt: string | null;
+    currentChange: string | null;
+    currentChangePath: string | null;
+    completedChanges: QueueRunChangeRef[];
+    remainingChanges: string[];
+    failedChange: QueueRunChangeRef | null;
+    logPath: string;
+    lastInstruction: string | null;
+}
+export interface QueueRunStatusReport {
+    currentRun: QueueRunRecord | null;
+    stage: string | null;
+    activeChange: {
+        name: string;
+        path: string;
+        status: FeatureState['status'];
+    } | null;
+    queuedChanges: QueuedChangeStatusItem[];
+    logTail: string[];
+    nextInstruction: string | null;
+}
+export type WorkflowStep = 'proposal_complete' | 'tasks_complete' | 'implementation_complete' | 'skill_updated' | 'index_regenerated' | 'tests_passed' | 'verification_passed' | 'archived';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * OSpec CLI 主导出 (更新版本)
+ */
+export * from './cli';
+export * from './services';
+export * from './commands';
+export * from './utils';
+export * from './core';
+export * from './workflow';
+export * from './advanced';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * OSpec CLI 主导出 (更新版本)
+ */
+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("./cli"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./commands"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./core"), exports);
+__exportStar(require("./workflow"), exports);
+__exportStar(require("./advanced"), exports);
+//# sourceMappingURL=index.js.map

package/dist/presets/ProjectPresets.d.ts

@@ -0,0 +1,41 @@
+import { ProjectMode } from '../core/types';
+export type ProjectPresetId = 'official-site' | 'nextjs-web';
+export type ProjectPresetDocumentLanguage = 'zh-CN' | 'en-US';
+export interface ProjectPresetFirstChangeSuggestion {
+    name: string;
+    background: string;
+    goals: string[];
+    inScope: string[];
+    outOfScope: string[];
+    acceptanceCriteria: string[];
+    affects: string[];
+    flags: string[];
+}
+export interface ProjectPresetDefinition {
+    id: ProjectPresetId;
+    name: string;
+    description: string;
+    recommendedMode: ProjectMode;
+    recommendedTechStack: string[];
+    architecture: string;
+    modules: string[];
+    apiAreas: string[];
+    designDocs: string[];
+    planningDocs: string[];
+    keywords: string[];
+    buildFirstChangeSuggestion: (language: ProjectPresetDocumentLanguage, projectName: string) => ProjectPresetFirstChangeSuggestion;
+}
+interface LocalizedProjectPresetContent {
+    name: string;
+    description: string;
+    architecture: string;
+    designDocs: string[];
+    planningDocs: string[];
+}
+export declare const PROJECT_PRESETS: ProjectPresetDefinition[];
+export declare const getProjectPresetById: (presetId?: string | null) => ProjectPresetDefinition | undefined;
+export declare const getLocalizedProjectPresetContent: (presetId: ProjectPresetId | null | undefined, language: ProjectPresetDocumentLanguage) => LocalizedProjectPresetContent | null;
+export declare const inferProjectPresetFromDescription: (description: string) => ProjectPresetDefinition | undefined;
+export declare const getProjectPresetFirstChangeSuggestion: (presetId: ProjectPresetId | null | undefined, language: ProjectPresetDocumentLanguage, projectName: string) => ProjectPresetFirstChangeSuggestion | null;
+export {};
+//# sourceMappingURL=ProjectPresets.d.ts.map