@clawplays/ospec-cli 0.3.7 → 0.3.9

package/dist/tools/build-index.js

@@ -4,6 +4,7 @@ const fs = require('fs');
 const fsp = require('fs/promises');
 const path = require('path');
 const { spawnSync } = require('child_process');
+const matter = require('gray-matter');
 
 const SKIP_DIRS = new Set(['node_modules', 'dist', '.git', 'changes', 'for-ai']);
 const INDEX_FILE = 'SKILL.index.json';
@@ -64,7 +65,7 @@ async function runHookCheck(rootDir, event) {
     const indexStatus = await computeIndexStatus(rootDir);
     if (indexStatus.stale) {
       console.log('[ospec] SKILL.index.json is stale');
-      console.log('[ospec] run "ospec index build" or "node build-index-auto.cjs" to refresh it');
+      console.log('[ospec] run "ospec index build" or "node .ospec/tools/build-index-auto.cjs" to refresh it');
       if (event === 'pre-commit' && config.indexCheck === 'error') {
         shouldBlock = true;
       }
@@ -282,46 +283,31 @@ async function buildChangeSummary(rootDir, changeName, config) {
   }
 
   if (tasksExists) {
-    const tasks = parseFrontmatter(await fsp.readFile(tasksPath, 'utf8'));
-    const optionalSteps = ensureArray(tasks.data.optional_steps);
-    const missing = activatedSteps.filter(step => !optionalSteps.includes(step));
-    const checklistComplete = !/- \[ \]/.test(tasks.body);
-    checks.push({
-      name: 'tasks.md.optional_steps',
-      status: missing.length === 0 ? 'pass' : 'fail',
-      message:
-        missing.length === 0
-          ? 'All activated optional steps are present in tasks.md'
-          : `Missing optional steps in tasks.md: ${missing.join(', ')}`,
-    });
-    checks.push({
-      name: 'tasks.md.checklist',
-      status: checklistComplete ? 'pass' : 'warn',
-      message: checklistComplete ? 'tasks.md checklist is complete' : 'tasks.md still has unchecked items',
+    const tasks = analyzeWorkflowChecklistDocument(await fsp.readFile(tasksPath, 'utf8'), {
+      name: 'tasks.md',
+      activatedSteps,
+      requiredFields: [
+        ['feature', 'string'],
+        ['created', 'string_or_date'],
+        ['optional_steps', 'array'],
+      ],
     });
+    checks.push(...tasks.checks);
   }
 
   if (verificationExists) {
-    const verification = parseFrontmatter(await fsp.readFile(verificationPath, 'utf8'));
-    const optionalSteps = ensureArray(verification.data.optional_steps);
-    const missing = activatedSteps.filter(step => !optionalSteps.includes(step));
-    const checklistComplete = !/- \[ \]/.test(verification.body);
-    checks.push({
-      name: 'verification.md.optional_steps',
-      status: missing.length === 0 ? 'pass' : 'fail',
-      message:
-        missing.length === 0
-          ? 'All activated optional steps are present in verification.md'
-          : `Missing optional steps in verification.md: ${missing.join(', ')}`,
-    });
-    checks.push({
-      name: 'verification.md.checklist',
-      status: checklistComplete ? 'pass' : 'warn',
-      message:
-        checklistComplete
-          ? 'verification.md checklist is complete'
-          : 'verification.md still has unchecked items',
+    const verification = analyzeWorkflowChecklistDocument(await fsp.readFile(verificationPath, 'utf8'), {
+      name: 'verification.md',
+      activatedSteps,
+      requiredFields: [
+        ['feature', 'string'],
+        ['created', 'string_or_date'],
+        ['status', 'string'],
+        ['optional_steps', 'array'],
+        ['passed_optional_steps', 'array'],
+      ],
     });
+    checks.push(...verification.checks);
   }
 
   const hasProtocolIssues = checks.some(check => check.status !== 'pass');
@@ -476,6 +462,93 @@ function parseSkillFile(content) {
   };
 }
 
+function analyzeWorkflowChecklistDocument(content, options) {
+  const hasFrontmatter = /^---\r?\n[\s\S]*?\r?\n---(?:\r?\n|$)/.test(content);
+  let parsed = null;
+  let parseError = null;
+
+  if (hasFrontmatter) {
+    try {
+      parsed = matter(content);
+    } catch (error) {
+      parseError = error;
+    }
+  }
+
+  const data = parsed?.data ?? {};
+  const optionalStepsFieldValid = Array.isArray(data.optional_steps);
+  const optionalSteps = optionalStepsFieldValid ? ensureArray(data.optional_steps) : [];
+  const invalidRequiredFields = options.requiredFields
+    .filter(([fieldName, fieldType]) => !isValidFrontmatterField(data[fieldName], fieldType))
+    .map(([fieldName]) => fieldName);
+  const missingActivatedSteps = optionalStepsFieldValid
+    ? options.activatedSteps.filter(step => !optionalSteps.includes(step))
+    : [...options.activatedSteps];
+  const checklistItems = parsed?.content.match(/^\s*-\s+\[(?: |x|X)\]\s+.+$/gm) ?? [];
+  const uncheckedItems = parsed?.content.match(/^\s*-\s+\[ \]\s+.+$/gm) ?? [];
+  const checklistStructureValid = checklistItems.length > 0;
+
+  let frontmatterMessage = `${options.name} frontmatter parsed successfully`;
+  if (!hasFrontmatter) {
+    frontmatterMessage = `${options.name} is missing a valid frontmatter block`;
+  } else if (parseError) {
+    frontmatterMessage = `${options.name} frontmatter cannot be parsed: ${parseError.message}`;
+  }
+
+  let requiredFieldsMessage = `${options.name} has all required frontmatter fields`;
+  if (!hasFrontmatter || parseError) {
+    requiredFieldsMessage = `Cannot validate required fields in ${options.name} because frontmatter is invalid`;
+  } else if (invalidRequiredFields.length > 0) {
+    requiredFieldsMessage = `Missing or invalid required fields in ${options.name}: ${invalidRequiredFields.join(', ')}`;
+  }
+
+  let optionalStepsMessage = `All activated optional steps are present in ${options.name}`;
+  if (!optionalStepsFieldValid) {
+    optionalStepsMessage = `${options.name} frontmatter field optional_steps must be an array`;
+  } else if (missingActivatedSteps.length > 0) {
+    optionalStepsMessage = `Missing optional steps in ${options.name}: ${missingActivatedSteps.join(', ')}`;
+  }
+
+  let checklistStatus = 'pass';
+  let checklistMessage = `${options.name} checklist is complete`;
+  if (!hasFrontmatter || parseError) {
+    checklistStatus = 'fail';
+    checklistMessage = `${options.name} checklist cannot be validated because frontmatter is invalid`;
+  } else if (!checklistStructureValid) {
+    checklistStatus = 'fail';
+    checklistMessage = `${options.name} must contain at least one Markdown checklist item`;
+  } else if (uncheckedItems.length > 0) {
+    checklistStatus = 'warn';
+    checklistMessage = `${options.name} still has unchecked items`;
+  }
+
+  return {
+    optionalSteps,
+    checks: [
+      {
+        name: `${options.name}.frontmatter`,
+        status: hasFrontmatter && parseError === null ? 'pass' : 'fail',
+        message: frontmatterMessage,
+      },
+      {
+        name: `${options.name}.required_fields`,
+        status: hasFrontmatter && parseError === null && invalidRequiredFields.length === 0 ? 'pass' : 'fail',
+        message: requiredFieldsMessage,
+      },
+      {
+        name: `${options.name}.optional_steps`,
+        status: optionalStepsFieldValid && missingActivatedSteps.length === 0 ? 'pass' : 'fail',
+        message: optionalStepsMessage,
+      },
+      {
+        name: `${options.name}.checklist`,
+        status: checklistStatus,
+        message: checklistMessage,
+      },
+    ],
+  };
+}
+
 function normalizeLineEndings(content) {
   return String(content || '').replace(/\r\n?/g, '\n');
 }
@@ -517,6 +590,25 @@ function parseFrontmatter(content) {
   };
 }
 
+function isValidFrontmatterField(value, type) {
+  if (type === 'string') {
+    return typeof value === 'string' && value.trim().length > 0;
+  }
+
+  if (type === 'string_or_date') {
+    return (
+      (typeof value === 'string' && value.trim().length > 0) ||
+      (value instanceof Date && !Number.isNaN(value.getTime()))
+    );
+  }
+
+  if (type === 'array') {
+    return Array.isArray(value);
+  }
+
+  return false;
+}
+
 function parseValue(rawValue) {
   if (rawValue === '') {
     return [];

package/dist/utils/DateUtils.d.ts

@@ -14,5 +14,4 @@ export declare class DateUtils {
      * 解析 ISO 字符串
      */
     static parseISO(dateString: string): Date;
-}
-//# sourceMappingURL=DateUtils.d.ts.map
+}

package/dist/utils/DateUtils.js

@@ -36,5 +36,4 @@ class DateUtils {
         return new Date(dateString);
     }
 }
-exports.DateUtils = DateUtils;
-//# sourceMappingURL=DateUtils.js.map
+exports.DateUtils = DateUtils;

package/dist/utils/PathUtils.d.ts

@@ -6,4 +6,3 @@ export declare class PathUtils {
     static isAbsolute(filePath: string): boolean;
     static getRelative(from: string, to: string): string;
 }
-//# sourceMappingURL=PathUtils.d.ts.map

package/dist/utils/PathUtils.js

@@ -63,4 +63,3 @@ class PathUtils {
     }
 }
 exports.PathUtils = PathUtils;
-//# sourceMappingURL=PathUtils.js.map

package/dist/utils/StringUtils.d.ts

@@ -22,5 +22,4 @@ export declare class StringUtils {
      * 去除空白
      */
     static trim(str: string): string;
-}
-//# sourceMappingURL=StringUtils.d.ts.map
+}

package/dist/utils/StringUtils.js

@@ -43,5 +43,4 @@ class StringUtils {
         return str.trim();
     }
 }
-exports.StringUtils = StringUtils;
-//# sourceMappingURL=StringUtils.js.map
+exports.StringUtils = StringUtils;

package/dist/utils/helpers.d.ts

@@ -1,3 +1,2 @@
 export declare function quoteCliArg(value: string): string;
 export declare function formatCliCommand(...args: Array<string | null | undefined>): string;
-//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.js

@@ -19,4 +19,3 @@ function formatCliCommand(...args) {
         .join(' ');
 }
 exports.formatCliCommand = formatCliCommand;
-//# sourceMappingURL=helpers.js.map

package/dist/utils/index.d.ts

@@ -3,5 +3,4 @@
  */
 export * from './PathUtils';
 export * from './StringUtils';
-export * from './DateUtils';
-//# sourceMappingURL=index.d.ts.map
+export * from './DateUtils';

package/dist/utils/index.js

@@ -19,5 +19,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./PathUtils"), exports);
 __exportStar(require("./StringUtils"), exports);
-__exportStar(require("./DateUtils"), exports);
-//# sourceMappingURL=index.js.map
+__exportStar(require("./DateUtils"), exports);

package/dist/utils/logger.d.ts

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

package/dist/utils/logger.js

@@ -2,5 +2,4 @@
 /**
  * 日志输出
  * TODO: 实现日志功能
- */
-//# sourceMappingURL=logger.js.map
+ */

package/dist/utils/path.d.ts

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

package/dist/utils/path.js

@@ -2,5 +2,4 @@
 /**
  * 路径处理
  * TODO: 实现路径处理函数
- */
-//# sourceMappingURL=path.js.map
+ */

package/dist/utils/subcommandHelp.d.ts

@@ -8,4 +8,3 @@ 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

@@ -116,4 +116,3 @@ Run Commands:
   ospec run help                                               - show run command help
 `;
 }
-//# sourceMappingURL=subcommandHelp.js.map

package/dist/workflow/ArchiveGate.d.ts

@@ -26,5 +26,4 @@ export interface ArchiveProtocolState {
 export declare class ArchiveGate {
     checkArchiveReadiness(featureState: FeatureState, config: ArchiveGateConfig, protocolState?: ArchiveProtocolState): Promise<ArchiveCheckResult>;
 }
-export declare const archiveGate: ArchiveGate;
-//# sourceMappingURL=ArchiveGate.d.ts.map
+export declare const archiveGate: ArchiveGate;

package/dist/workflow/ArchiveGate.js

@@ -89,5 +89,4 @@ class ArchiveGate {
     }
 }
 exports.ArchiveGate = ArchiveGate;
-exports.archiveGate = new ArchiveGate();
-//# sourceMappingURL=ArchiveGate.js.map
+exports.archiveGate = new ArchiveGate();

package/dist/workflow/ConfigurableWorkflow.d.ts

@@ -85,5 +85,4 @@ export declare class ConfigurableWorkflow {
      * 获取当前模式
      */
     getMode(): string;
-}
-//# sourceMappingURL=ConfigurableWorkflow.d.ts.map
+}

package/dist/workflow/ConfigurableWorkflow.js

@@ -182,5 +182,4 @@ class ConfigurableWorkflow {
         return this.mode;
     }
 }
-exports.ConfigurableWorkflow = ConfigurableWorkflow;
-//# sourceMappingURL=ConfigurableWorkflow.js.map
+exports.ConfigurableWorkflow = ConfigurableWorkflow;

package/dist/workflow/HookSystem.d.ts

@@ -34,5 +34,4 @@ export declare class HookSystem {
         count: number;
     }[];
 }
-export declare const hookSystem: HookSystem;
-//# sourceMappingURL=HookSystem.d.ts.map
+export declare const hookSystem: HookSystem;

package/dist/workflow/HookSystem.js

@@ -62,5 +62,4 @@ class HookSystem {
     }
 }
 exports.HookSystem = HookSystem;
-exports.hookSystem = new HookSystem();
-//# sourceMappingURL=HookSystem.js.map
+exports.hookSystem = new HookSystem();

package/dist/workflow/IndexRegenerator.d.ts

@@ -45,5 +45,4 @@ export declare class IndexRegenerator {
         errors: string[];
     }>;
 }
-export declare const indexRegenerator: IndexRegenerator;
-//# sourceMappingURL=IndexRegenerator.d.ts.map
+export declare const indexRegenerator: IndexRegenerator;

package/dist/workflow/IndexRegenerator.js

@@ -143,5 +143,4 @@ class IndexRegenerator {
     }
 }
 exports.IndexRegenerator = IndexRegenerator;
-exports.indexRegenerator = new IndexRegenerator();
-//# sourceMappingURL=IndexRegenerator.js.map
+exports.indexRegenerator = new IndexRegenerator();

package/dist/workflow/PluginWorkflowComposer.d.ts

@@ -135,4 +135,3 @@ export declare class PluginWorkflowComposer {
         unsupportedFlags: string[];
     };
 }
-//# sourceMappingURL=PluginWorkflowComposer.d.ts.map

package/dist/workflow/PluginWorkflowComposer.js

@@ -236,4 +236,3 @@ class PluginWorkflowComposer {
     }
 }
 exports.PluginWorkflowComposer = PluginWorkflowComposer;
-//# sourceMappingURL=PluginWorkflowComposer.js.map

package/dist/workflow/SkillUpdateEngine.d.ts

@@ -22,5 +22,4 @@ export declare class SkillUpdateEngine {
     }>;
     exportSkillPackage(featureDir: string): Promise<Buffer>;
 }
-export declare const skillUpdateEngine: SkillUpdateEngine;
-//# sourceMappingURL=SkillUpdateEngine.d.ts.map
+export declare const skillUpdateEngine: SkillUpdateEngine;

package/dist/workflow/SkillUpdateEngine.js

@@ -109,5 +109,4 @@ ${content}`;
     }
 }
 exports.SkillUpdateEngine = SkillUpdateEngine;
-exports.skillUpdateEngine = new SkillUpdateEngine();
-//# sourceMappingURL=SkillUpdateEngine.js.map
+exports.skillUpdateEngine = new SkillUpdateEngine();

package/dist/workflow/VerificationSystem.d.ts

@@ -20,5 +20,4 @@ export declare class VerificationSystem {
         critical: boolean;
     }>;
 }
-export declare const verificationSystem: VerificationSystem;
-//# sourceMappingURL=VerificationSystem.d.ts.map
+export declare const verificationSystem: VerificationSystem;

package/dist/workflow/VerificationSystem.js

@@ -112,5 +112,4 @@ class VerificationSystem {
     }
 }
 exports.VerificationSystem = VerificationSystem;
-exports.verificationSystem = new VerificationSystem();
-//# sourceMappingURL=VerificationSystem.js.map
+exports.verificationSystem = new VerificationSystem();

package/dist/workflow/WorkflowEngine.d.ts

@@ -11,5 +11,4 @@ export declare class WorkflowEngine {
         percentage: number;
     };
 }
-export declare const workflowEngine: WorkflowEngine;
-//# sourceMappingURL=WorkflowEngine.d.ts.map
+export declare const workflowEngine: WorkflowEngine;

package/dist/workflow/WorkflowEngine.js

@@ -53,5 +53,4 @@ class WorkflowEngine {
     }
 }
 exports.WorkflowEngine = WorkflowEngine;
-exports.workflowEngine = new WorkflowEngine();
-//# sourceMappingURL=WorkflowEngine.js.map
+exports.workflowEngine = new WorkflowEngine();

package/dist/workflow/index.d.ts

@@ -16,4 +16,3 @@ export { ConfigurableWorkflow, WORKFLOW_PRESETS } from './ConfigurableWorkflow';
 export type { CoreStep, OptionalStep, OptionalStepConfig, WorkflowConfigType } from './ConfigurableWorkflow';
 export { PluginWorkflowComposer, DEFAULT_STITCH_PLUGIN_CONFIG, DEFAULT_CHECKPOINT_PLUGIN_CONFIG } from './PluginWorkflowComposer';
 export type { EnabledPluginSummary, PluginCapabilitySummary } from './PluginWorkflowComposer';
-//# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.js

@@ -29,4 +29,3 @@ var PluginWorkflowComposer_1 = require("./PluginWorkflowComposer");
 Object.defineProperty(exports, "DEFAULT_STITCH_PLUGIN_CONFIG", { enumerable: true, get: function () { return PluginWorkflowComposer_1.DEFAULT_STITCH_PLUGIN_CONFIG; } });
 Object.defineProperty(exports, "DEFAULT_CHECKPOINT_PLUGIN_CONFIG", { enumerable: true, get: function () { return PluginWorkflowComposer_1.DEFAULT_CHECKPOINT_PLUGIN_CONFIG; } });
 Object.defineProperty(exports, "PluginWorkflowComposer", { enumerable: true, get: function () { return PluginWorkflowComposer_1.PluginWorkflowComposer; } });
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@clawplays/ospec-cli",
-  "version": "0.3.7",
-  "description": "CLI tool for enforcing ospec workflow",
+  "version": "0.3.9",
+  "description": "Official OSpec CLI package for spec-driven development (SDD) and document-driven development in AI coding agent and CLI workflows.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -11,17 +11,23 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "tsc && node scripts/strip-sourcemap-refs.js",
+    "dev": "node scripts/dev-watch.js",
     "postinstall": "node scripts/postinstall.js",
+    "prepack": "node scripts/strip-sourcemap-refs.js",
     "test": "vitest",
     "test:run": "vitest --run",
     "lint": "eslint src tests --ext .ts",
     "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
     "index:rebuild": "node dist/tools/build-index.js",
     "validate": "node dist/cli/commands/validate.js",
+    "release:cut": "node scripts/release-cut.js",
+    "release:cut:patch": "node scripts/release-cut.js patch",
+    "release:cut:minor": "node scripts/release-cut.js minor",
+    "release:cut:major": "node scripts/release-cut.js major",
     "release:smoke": "node scripts/release-smoke.js",
     "release:notes": "node scripts/release-notes.js",
+    "release:upload-notes": "node scripts/release-upload-notes.js",
     "release:sync-version": "node scripts/sync-version.js",
     "release:bump:patch": "npm version patch --no-git-tag-version",
     "release:bump:minor": "npm version minor --no-git-tag-version",
@@ -32,16 +38,19 @@
   },
   "keywords": [
     "ospec",
-    "workflow",
-    "cli",
-    "automation"
+    "ospec-cli",
+    "spec-driven development",
+    "sdd",
+    "document-driven development",
+    "ai coding agents",
+    "cli workflows"
   ],
   "author": "clawplays <ai@clawplays.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/clawplays/ospec.git"
   },
-  "homepage": "https://github.com/clawplays/ospec",
+  "homepage": "https://ospec.ai/",
   "bugs": {
     "url": "https://github.com/clawplays/ospec/issues"
   },

package/skill.yaml

@@ -19,7 +19,7 @@ protocol:
     - ".skillrc"
     - "SKILL.md"
     - "SKILL.index.json"
-    - "build-index-auto.cjs"
+    - ".ospec/tools/build-index-auto.cjs"
     - "for-ai/ai-guide.md"
     - "for-ai/execution-protocol.md"
     - "for-ai/naming-conventions.md"
@@ -139,7 +139,7 @@ usage:
     - "Create the first active change explicitly."
     - "Run your project deployment and validation flow, then use ospec verify [changes/active/<change>]."
     - "Archive the validated change with ospec finalize [changes/active/<change>]."
-    - "Verify .skillrc, changes/, .ospec/, build-index-auto.cjs, for-ai docs, and docs/project/* before claiming init is complete."
+    - "Verify .skillrc, changes/, .ospec/, .ospec/tools/build-index-auto.cjs, for-ai docs, and docs/project/* before claiming init is complete."
     - "Use presets only as planning defaults; scaffold still requires explicit intent."
   prompt_shortcuts:
     - "initialize this project"