kspec 1.0.21 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kspec",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Spec-driven development workflow for Kiro CLI",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -411,6 +411,34 @@ function getCurrentTask(folder) {
   return null;
 }
 
+// Check if spec.md has been modified after spec-lite.md
+function isSpecStale(folder) {
+  const specFile = path.join(folder, 'spec.md');
+  const specLiteFile = path.join(folder, 'spec-lite.md');
+
+  if (!fs.existsSync(specFile)) return false;
+  if (!fs.existsSync(specLiteFile)) return true; // No spec-lite means stale
+
+  const specMtime = fs.statSync(specFile).mtime;
+  const specLiteMtime = fs.statSync(specLiteFile).mtime;
+
+  return specMtime > specLiteMtime;
+}
+
+// Check staleness and prompt user before proceeding
+async function checkStaleness(folder) {
+  if (!isSpecStale(folder)) return true; // Not stale, proceed
+
+  console.log('\n⚠️  spec.md has been modified since spec-lite.md was generated.');
+  console.log('   This may cause outdated information to be used.\n');
+  console.log('   Options:');
+  console.log('   1. Run `kspec refresh` to update spec-lite.md first (recommended)');
+  console.log('   2. Continue anyway with potentially stale context\n');
+
+  const proceed = await confirm('Continue with potentially stale spec?');
+  return proceed;
+}
+
 function refreshContext() {
   const contextFile = path.join(KSPEC_DIR, 'CONTEXT.md');
   const current = getCurrentSpec();
@@ -429,11 +457,22 @@ No active spec. Run: \`kspec spec "Feature Name"\`
   const specName = path.basename(current);
   const stats = getTaskStats(current);
   const currentTask = getCurrentTask(current);
+  const stale = isSpecStale(current);
 
-  // Read spec-lite if exists
+  // Read spec-lite if exists, or fall back to spec.md if stale
   const specLiteFile = path.join(current, 'spec-lite.md');
+  const specFile = path.join(current, 'spec.md');
   let specLite = '';
-  if (fs.existsSync(specLiteFile)) {
+  let usingSpecFallback = false;
+
+  if (stale && fs.existsSync(specFile)) {
+    // Use spec.md directly when stale (truncate if too long)
+    const specContent = fs.readFileSync(specFile, 'utf8');
+    specLite = specContent.length > 3000
+      ? specContent.slice(0, 3000) + '\n\n... (truncated, run `kspec refresh` for full summary)'
+      : specContent;
+    usingSpecFallback = true;
+  } else if (fs.existsSync(specLiteFile)) {
     specLite = fs.readFileSync(specLiteFile, 'utf8');
   }
 
@@ -460,8 +499,17 @@ No active spec. Run: \`kspec spec "Feature Name"\`
 ## Current Spec
 **${specName}**
 Path: \`${current}\`
+`;
+
+  if (stale) {
+    content += `
+**NOTE: spec.md was modified. Using spec.md directly for context.**
+Run \`kspec refresh\` to generate optimized spec-lite.md summary.
 
 `;
+  } else {
+    content += '\n';
+  }
 
   if (stats) {
     content += `## Progress
@@ -1077,6 +1125,9 @@ Report created subtasks with their URLs.`, 'kspec-jira');
 
   async tasks(args) {
     const folder = getOrSelectSpec(args.join(' '));
+
+    if (!await checkStaleness(folder)) return;
+
     log(`Generating tasks: ${folder}`);
 
     await chat(`Generate tasks from specification.
@@ -1093,8 +1144,11 @@ Create ${folder}/tasks.md with:
 
   async 'verify-tasks'(args) {
     const folder = getOrSelectSpec(args.join(' '));
+
+    if (!await checkStaleness(folder)) return;
+
     const stats = getTaskStats(folder);
-    
+
     log(`Verifying tasks: ${folder}`);
     if (stats) log(`Progress: ${stats.done}/${stats.total} tasks completed`);
 
@@ -1110,6 +1164,9 @@ Report: X/Y tasks done, gaps found, coverage assessment.`, 'kspec-verify');
 
   async build(args) {
     const folder = getOrSelectSpec(args.join(' '));
+
+    if (!await checkStaleness(folder)) return;
+
     const stats = getTaskStats(folder);
 
     log(`Building: ${folder}`);
@@ -1144,6 +1201,9 @@ NEVER delete .kiro or .kspec folders.`, 'kspec-build');
 
   async verify(args) {
     const folder = getOrSelectSpec(args.join(' '));
+
+    if (!await checkStaleness(folder)) return;
+
     const stats = getTaskStats(folder);
 
     log(`Verifying implementation: ${folder}`);
@@ -1159,11 +1219,69 @@ NEVER delete .kiro or .kspec folders.`, 'kspec-build');
 
 Report:
 - Requirements: X/Y implemented
-- Tasks: X/Y completed  
+- Tasks: X/Y completed
 - Tests: PASS/FAIL
 - Gaps: [list any]`, 'kspec-verify');
   },
 
+  async refresh(args) {
+    const folder = getOrSelectSpec(args.join(' '));
+    const specFile = path.join(folder, 'spec.md');
+    const specLiteFile = path.join(folder, 'spec-lite.md');
+
+    if (!fs.existsSync(specFile)) {
+      die(`No spec.md found in ${folder}`);
+    }
+
+    const stale = isSpecStale(folder);
+    if (!stale && !args.includes('--force')) {
+      log('spec-lite.md is up to date with spec.md');
+      log('Use --force to regenerate anyway');
+      return;
+    }
+
+    // Read the current spec.md content
+    const specContent = fs.readFileSync(specFile, 'utf8');
+
+    log(`Refreshing spec-lite.md from ${folder}/spec.md...`);
+
+    await chat(`URGENT: Regenerate spec-lite.md NOW.
+
+TARGET FILE: ${specLiteFile}
+
+CURRENT spec.md CONTENT (source of truth):
+---
+${specContent}
+---
+
+YOUR TASK:
+1. Write a NEW ${specLiteFile} file immediately
+2. Summarize the above spec.md content (under 500 words)
+3. MUST include:
+   - All tech stack with EXACT versions (e.g., Next.js 16+, NOT 14+)
+   - Key requirements and acceptance criteria
+   - Any Jira references
+
+DO THIS NOW:
+- Use your write tool to create ${specLiteFile}
+- Copy the tech stack details EXACTLY as shown above
+- Do not read the old spec-lite.md, replace it completely
+
+After writing, show me what you wrote.`, 'kspec-spec');
+
+    // Verify spec-lite.md was updated
+    if (isSpecStale(folder)) {
+      console.log('\n⚠️  spec-lite.md may not have been updated correctly.');
+      console.log('   Please verify the file was written with updated content.\n');
+    } else {
+      log('spec-lite.md updated successfully');
+    }
+
+    // Update CONTEXT.md with new spec-lite
+    refreshContext();
+    log('Context refreshed');
+  },
+
   async done(args) {
     const folder = getOrSelectSpec(args.join(' '));
     const stats = getTaskStats(folder);
@@ -1347,6 +1465,7 @@ Jira Integration (requires Atlassian MCP):
                           Create subtasks under specific issue
 
 Other:
+  kspec refresh           Regenerate spec-lite.md after editing spec.md
   kspec context           Refresh/view context file
   kspec review [target]   Code review
   kspec list              List all specs
@@ -1389,4 +1508,4 @@ async function run(args) {
   }
 }
 
-module.exports = { run, commands, loadConfig, detectCli, requireCli, agentTemplates, getTaskStats, refreshContext, getCurrentSpec, getCurrentTask, checkForUpdates, compareVersions, hasAtlassianMcp, getMcpConfig, slugify, generateSlug };
+module.exports = { run, commands, loadConfig, detectCli, requireCli, agentTemplates, getTaskStats, refreshContext, getCurrentSpec, getCurrentTask, checkForUpdates, compareVersions, hasAtlassianMcp, getMcpConfig, slugify, generateSlug, isSpecStale };