@clawplays/ospec-cli 0.3.8 → 0.3.10

package/dist/tools/build-index.js

@@ -4,7 +4,6 @@ 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';
@@ -65,7 +64,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;
       }
@@ -469,7 +468,7 @@ function analyzeWorkflowChecklistDocument(content, options) {
 
   if (hasFrontmatter) {
     try {
-      parsed = matter(content);
+      parsed = parseFrontmatter(content, { strict: true });
     } catch (error) {
       parseError = error;
     }
@@ -484,8 +483,8 @@ function analyzeWorkflowChecklistDocument(content, options) {
   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 checklistItems = parsed?.body.match(/^\s*-\s+\[(?: |x|X)\]\s+.+$/gm) ?? [];
+  const uncheckedItems = parsed?.body.match(/^\s*-\s+\[ \]\s+.+$/gm) ?? [];
   const checklistStructureValid = checklistItems.length > 0;
 
   let frontmatterMessage = `${options.name} frontmatter parsed successfully`;
@@ -553,40 +552,61 @@ function normalizeLineEndings(content) {
   return String(content || '').replace(/\r\n?/g, '\n');
 }
 
-function parseFrontmatter(content) {
-  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+function parseFrontmatter(content, options = {}) {
+  const normalizedContent = normalizeLineEndings(content);
+  const match = normalizedContent.match(/^---\n([\s\S]*?)\n---(?:\n|$)/);
   if (!match) {
-    return { data: {}, body: content };
+    return { data: {}, body: normalizedContent };
   }
 
   const data = {};
-  const lines = match[1].split(/\r?\n/);
+  const lines = match[1].split('\n');
   let currentKey = null;
 
-  for (const line of lines) {
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    const lineNumber = index + 1;
+    const trimmed = line.trim();
+
+    if (trimmed === '' || trimmed.startsWith('#')) {
+      continue;
+    }
+
     if (/^\s*-\s+/.test(line) && currentKey) {
       if (!Array.isArray(data[currentKey])) {
         data[currentKey] = [];
       }
-      data[currentKey].push(parseValue(line.replace(/^\s*-\s+/, '').trim()));
+      data[currentKey].push(
+        parseValue(line.replace(/^\s*-\s+/, '').trim(), options, {
+          key: currentKey,
+          lineNumber,
+        })
+      );
       continue;
     }
 
+    if (/^\s*-\s+/.test(line) && options.strict) {
+      throw createFrontmatterParseError('Unexpected list item outside an array field', lineNumber);
+    }
+
     const keyMatch = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
     if (!keyMatch) {
+      if (options.strict) {
+        throw createFrontmatterParseError(`Invalid frontmatter line: ${trimmed}`, lineNumber);
+      }
       currentKey = null;
       continue;
     }
 
     const key = keyMatch[1];
     const rawValue = keyMatch[2].trim();
-    data[key] = parseValue(rawValue);
+    data[key] = parseValue(rawValue, options, { key, lineNumber });
     currentKey = Array.isArray(data[key]) && rawValue === '' ? key : null;
   }
 
   return {
     data,
-    body: content.slice(match[0].length),
+    body: normalizedContent.slice(match[0].length),
   };
 }
 
@@ -609,7 +629,7 @@ function isValidFrontmatterField(value, type) {
   return false;
 }
 
-function parseValue(rawValue) {
+function parseValue(rawValue, options = {}, context = {}) {
   if (rawValue === '') {
     return [];
   }
@@ -622,25 +642,102 @@ function parseValue(rawValue) {
   if (rawValue === 'false') {
     return false;
   }
+  if (options.strict) {
+    validateFrontmatterValue(rawValue, context);
+  }
   if (/^\[(.*)\]$/.test(rawValue)) {
     const inner = rawValue.slice(1, -1).trim();
     if (!inner) {
       return [];
     }
 
-    return inner
-      .split(',')
-      .map(item => stripQuotes(item.trim()))
-      .filter(Boolean);
+    return splitInlineArray(inner, options, context);
   }
 
   return stripQuotes(rawValue);
 }
 
+function validateFrontmatterValue(rawValue, context) {
+  const startsArray = rawValue.startsWith('[');
+  const endsArray = rawValue.endsWith(']');
+  if (startsArray !== endsArray) {
+    throw createFrontmatterParseError(
+      `Unterminated inline array for ${context.key || 'field'}`,
+      context.lineNumber
+    );
+  }
+
+  if (!rawValue) {
+    return;
+  }
+
+  const quote = rawValue[0];
+  if ((quote === '"' || quote === "'") && rawValue[rawValue.length - 1] !== quote) {
+    throw createFrontmatterParseError(
+      `Unterminated quoted string for ${context.key || 'field'}`,
+      context.lineNumber
+    );
+  }
+}
+
+function splitInlineArray(inner, options = {}, context = {}) {
+  const values = [];
+  let current = '';
+  let activeQuote = null;
+
+  for (let index = 0; index < inner.length; index += 1) {
+    const char = inner[index];
+    if (activeQuote) {
+      current += char;
+      if (char === activeQuote && inner[index - 1] !== '\\') {
+        activeQuote = null;
+      }
+      continue;
+    }
+
+    if (char === '"' || char === "'") {
+      activeQuote = char;
+      current += char;
+      continue;
+    }
+
+    if (char === ',') {
+      const parsed = parseValue(current.trim(), {}, context);
+      if (parsed !== '') {
+        values.push(parsed);
+      }
+      current = '';
+      continue;
+    }
+
+    current += char;
+  }
+
+  if (activeQuote && options.strict) {
+    throw createFrontmatterParseError(
+      `Unterminated quoted string in inline array for ${context.key || 'field'}`,
+      context.lineNumber
+    );
+  }
+
+  const parsed = parseValue(current.trim(), {}, context);
+  if (parsed !== '') {
+    values.push(parsed);
+  }
+
+  return values.filter(value => value !== '');
+}
+
 function stripQuotes(value) {
   return value.replace(/^['"]|['"]$/g, '');
 }
 
+function createFrontmatterParseError(message, lineNumber) {
+  const error = new Error(lineNumber ? `line ${lineNumber}: ${message}` : message);
+  error.name = 'FrontmatterParseError';
+  return error;
+}
+
 function extractSections(content) {
   const sections = {};
   const matches = [];

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.8",
-  "description": "CLI tool for enforcing ospec workflow",
+  "version": "0.3.10",
+  "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,9 +11,10 @@
     "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",
@@ -26,6 +27,7 @@
     "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",
@@ -36,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"