speccrew 0.6.6 → 0.6.9

package/.speccrew/skills/speccrew-pm-knowledge-detector/SKILL.md

@@ -29,7 +29,9 @@ Detect business knowledge base availability and completeness status. Scans the s
 
 | Variable | Type | Description | Required |
 |----------|------|-------------|----------|
-| `workspace_path` | string | Path to speccrew workspace (e.g., `speccrew-workspace`) | **Yes** |
+| `workspace_path` | string | Absolute path to speccrew workspace (e.g., `speccrew-workspace`) | **Yes** |
+| `sync_state_bizs_dir` | string | Absolute path to `knowledges/base/sync-state/knowledge-bizs/` directory | **Yes** |
+| `configs_dir` | string | Absolute path to `docs/configs/` directory | **Yes** |
 
 ## Output JSON
 
@@ -72,7 +74,7 @@ flowchart TD
 
 Check if the system overview file exists:
 
-1. Construct path: `{workspace_path}/knowledges/bizs/system-overview.md`
+1. Path: `{workspace_path}/knowledges/bizs/system-overview.md`
 2. Attempt to read the file
 3. Set `has_system_overview` = true if exists, false otherwise
 4. Set `system_overview_path` = path if exists, null otherwise
@@ -83,7 +85,7 @@ Check if the system overview file exists:
 
 Scan the sync-state directory for feature inventory files:
 
-1. Construct path: `{workspace_path}/knowledges/base/sync-state/knowledge-bizs/`
+1. Use provided path: `{sync_state_bizs_dir}/`
 2. Glob pattern: `features-*.json`
 3. Collect all matching files into `features_files` array
 4. Set `has_features` = true if any files found
@@ -94,7 +96,7 @@ Scan the sync-state directory for feature inventory files:
 
 Scan for entry directory configuration files:
 
-1. Use same sync-state path
+1. Use provided path: `{sync_state_bizs_dir}/`
 2. Glob pattern: `entry-dirs-*.json`
 3. Collect all matching files into `entry_dirs_files` array
 4. Set `has_entry_dirs` = true if any files found
@@ -137,6 +139,8 @@ Return the complete JSON output.
 3. **Graceful handling**: Return empty arrays if directories don't exist
 4. **Path format**: All returned paths should be relative to workspace_path
 
+> **MANDATORY**: Use the provided absolute paths directly. DO NOT construct or derive paths yourself.
+
 ## Task Completion Report
 
 When the task is complete, report:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.6.6",
+  "version": "0.6.9",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {

package/workspace-template/scripts/path-utils.js

@@ -0,0 +1,134 @@
+'use strict';
+
+const path = require('path');
+
+/**
+ * Path utility functions for speccrew workspace.
+ * All functions expect absolute paths as input.
+ */
+
+/**
+ * Get the sync-state bizs directory path.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @returns {string} Absolute path to knowledges/base/sync-state/knowledge-bizs/
+ */
+function getSyncStateBizsDir(workspacePath) {
+  return path.join(workspacePath, 'knowledges', 'base', 'sync-state', 'knowledge-bizs');
+}
+
+/**
+ * Get the sync-state techs directory path.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @returns {string} Absolute path to knowledges/base/sync-state/knowledge-techs/
+ */
+function getSyncStateTechsDir(workspacePath) {
+  return path.join(workspacePath, 'knowledges', 'base', 'sync-state', 'knowledge-techs');
+}
+
+/**
+ * Get the features JSON file path for a platform.
+ * @param {string} syncStateBizsDir - Absolute path to sync-state/knowledge-bizs/
+ * @param {string} platformId - Platform identifier (e.g., 'backend-spring')
+ * @returns {string} Absolute path to features-{platformId}.json
+ */
+function getFeaturesFilePath(syncStateBizsDir, platformId) {
+  return path.join(syncStateBizsDir, `features-${platformId}.json`);
+}
+
+/**
+ * Get the entry-dirs JSON file path for a platform.
+ * @param {string} syncStateBizsDir - Absolute path to sync-state/knowledge-bizs/
+ * @param {string} platformId - Platform identifier
+ * @returns {string} Absolute path to entry-dirs-{platformId}.json
+ */
+function getEntryDirsFilePath(syncStateBizsDir, platformId) {
+  return path.join(syncStateBizsDir, `entry-dirs-${platformId}.json`);
+}
+
+/**
+ * Get the feature document path in bizs knowledge base.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @param {string} platformId - Platform identifier
+ * @param {string} moduleName - Business module name
+ * @param {string} fileName - Document file name (without extension)
+ * @returns {string} Absolute path to the feature document
+ */
+function getFeatureDocPath(workspacePath, platformId, moduleName, fileName) {
+  return path.join(workspacePath, 'knowledges', 'bizs', platformId, moduleName, `${fileName}.md`);
+}
+
+/**
+ * Get the graph knowledge file path.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @param {string} platformId - Platform identifier
+ * @param {string} moduleName - Business module name
+ * @param {string} fileName - Graph file name (e.g., 'knowledge-graph.json')
+ * @returns {string} Absolute path to the graph file
+ */
+function getGraphFilePath(workspacePath, platformId, moduleName, fileName) {
+  return path.join(workspacePath, 'knowledges', 'bizs', platformId, moduleName, fileName);
+}
+
+/**
+ * Generate a standardized marker file name for dispatch tracking.
+ * Format: {module}-{subpath}-{fileName}.{type}.json
+ * @param {string} moduleName - Business module name
+ * @param {string} subpath - Sub-path within module (use '-' separator, empty string if none)
+ * @param {string} fileName - Source file name (without extension)
+ * @param {string} [type='done'] - Marker type ('done', 'error', 'skip')
+ * @returns {string} Marker file name
+ */
+function getMarkerFileName(moduleName, subpath, fileName, type = 'done') {
+  const subpathPart = subpath ? `-${subpath.replace(/[\/\\]/g, '-')}` : '';
+  return `${moduleName}${subpathPart}-${fileName}.${type}.json`;
+}
+
+/**
+ * Get the completed markers directory path.
+ * @param {string} syncStateBizsDir - Absolute path to sync-state/knowledge-bizs/
+ * @returns {string} Absolute path to completed/ directory
+ */
+function getCompletedDir(syncStateBizsDir) {
+  return path.join(syncStateBizsDir, 'completed');
+}
+
+/**
+ * Get the iterations directory path.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @returns {string} Absolute path to iterations/
+ */
+function getIterationsDir(workspacePath) {
+  return path.join(workspacePath, 'iterations');
+}
+
+/**
+ * Get the configs directory path.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @returns {string} Absolute path to docs/configs/
+ */
+function getConfigsDir(workspacePath) {
+  return path.join(workspacePath, 'docs', 'configs');
+}
+
+/**
+ * Get the update-progress.js script path.
+ * @param {string} workspacePath - Absolute path to speccrew-workspace
+ * @returns {string} Absolute path to scripts/update-progress.js
+ */
+function getUpdateProgressScript(workspacePath) {
+  return path.join(workspacePath, 'scripts', 'update-progress.js');
+}
+
+module.exports = {
+  getSyncStateBizsDir,
+  getSyncStateTechsDir,
+  getFeaturesFilePath,
+  getEntryDirsFilePath,
+  getFeatureDocPath,
+  getGraphFilePath,
+  getMarkerFileName,
+  getCompletedDir,
+  getIterationsDir,
+  getConfigsDir,
+  getUpdateProgressScript
+};