@applica-software-guru/sdd-core 1.8.0 → 1.8.2

package/src/prompt/draft-prompt-generator.ts

@@ -8,67 +8,47 @@ export interface DraftElements {
 
 export function generateDraftEnrichmentPrompt(
   drafts: DraftElements,
-  projectContext: StoryFile[],
-  projectDescription: string,
 ): string | null {
   const totalDrafts = drafts.docs.length + drafts.crs.length + drafts.bugs.length;
   if (totalDrafts === 0) {
     return null;
   }
 
-  const sections: string[] = [];
+  const sections: string[] = [
+    '# Draft Tasks',
+    '',
+    'Enrich all draft elements listed below.',
+    'Read each file directly from disk, complete missing details, and save it keeping `status: draft`.',
+    'Do not mark statuses automatically in this step.',
+    '',
+  ];
 
-  // Project context header
-  sections.push(`# Draft Enrichment\n`);
-  sections.push(`## Project\n\n${projectDescription}\n`);
-
-  // Global context: all non-draft documents
-  if (projectContext.length > 0) {
-    const ctxLines = [`## Project context (${projectContext.length} documents)\n`];
-    ctxLines.push('Use the following existing documents as context to produce complete, coherent documentation.\n');
-    for (const f of projectContext) {
-      ctxLines.push(`### \`${f.relativePath}\` — ${f.frontmatter.title}\n`);
-      ctxLines.push(f.body.trim());
-      ctxLines.push('');
-    }
-    sections.push(ctxLines.join('\n'));
-  }
-
-  // Draft documents
   if (drafts.docs.length > 0) {
-    const lines = [`## Draft documents to enrich (${drafts.docs.length})\n`];
-    lines.push('Each draft below contains incomplete human-written content. Produce a complete version for each document, preserving the original intent while adding missing details based on project context.\n');
+    const lines = [`## Draft documents (${drafts.docs.length})`];
     for (const f of drafts.docs) {
-      lines.push(`### \`${f.relativePath}\` — ${f.frontmatter.title}\n`);
-      lines.push(f.body.trim());
-      lines.push('');
+      lines.push(`- \`${f.relativePath}\` — ${f.frontmatter.title}`);
     }
     sections.push(lines.join('\n'));
+    sections.push('');
   }
 
-  // Draft change requests
   if (drafts.crs.length > 0) {
-    const lines = [`## Draft change requests to enrich (${drafts.crs.length})\n`];
-    lines.push('Each draft CR contains a rough description of requested changes. Produce a complete, actionable change request for each, specifying which documents are affected and what changes should be made.\n');
+    const lines = [`## Draft change requests (${drafts.crs.length})`];
     for (const cr of drafts.crs) {
-      lines.push(`### \`${cr.relativePath}\` — ${cr.frontmatter.title}\n`);
-      lines.push(cr.body.trim());
-      lines.push('');
+      lines.push(`- \`${cr.relativePath}\` — ${cr.frontmatter.title}`);
     }
     sections.push(lines.join('\n'));
+    sections.push('');
   }
 
-  // Draft bugs
   if (drafts.bugs.length > 0) {
-    const lines = [`## Draft bugs to enrich (${drafts.bugs.length})\n`];
-    lines.push('Each draft bug contains a rough description of an issue. Produce a complete bug report for each, including affected components, expected vs actual behavior, and steps to reproduce when possible.\n');
+    const lines = [`## Draft bugs (${drafts.bugs.length})`];
     for (const bug of drafts.bugs) {
-      lines.push(`### \`${bug.relativePath}\` — ${bug.frontmatter.title}\n`);
-      lines.push(bug.body.trim());
-      lines.push('');
+      lines.push(`- \`${bug.relativePath}\` — ${bug.frontmatter.title}`);
     }
     sections.push(lines.join('\n'));
+    sections.push('');
   }
 
-  return sections.join('\n\n');
+  return sections.join('\n');
 }

package/src/remote/api-client.ts

@@ -180,7 +180,7 @@ export async function pushDocs(
 }
 
 /** GET /cli/pending-crs */
-export async function fetchPendingCRs(config: ApiClientConfig): Promise<RemoteCRResponse[]> {
+export async function pullPendingCRs(config: ApiClientConfig): Promise<RemoteCRResponse[]> {
   return request<RemoteCRResponse[]>(config, 'GET', '/cli/pending-crs');
 }
 
@@ -193,7 +193,7 @@ export async function pushCRs(
 }
 
 /** GET /cli/open-bugs */
-export async function fetchOpenBugs(config: ApiClientConfig): Promise<RemoteBugResponse[]> {
+export async function pullOpenBugs(config: ApiClientConfig): Promise<RemoteBugResponse[]> {
   return request<RemoteBugResponse[]>(config, 'GET', '/cli/open-bugs');
 }
 

package/src/remote/sync-engine.ts

@@ -8,7 +8,7 @@ import { readConfig } from '../config/config-manager.js';
 import { parseAllStoryFiles } from '../parser/story-parser.js';
 import { parseAllCRFiles } from '../parser/cr-parser.js';
 import { parseAllBugFiles } from '../parser/bug-parser.js';
-import { buildApiConfig, pullDocs, pushDocs, pushCRs, pushBugs, deleteDocs, deleteCRs, deleteBugs, fetchPendingCRs, fetchOpenBugs, resetProject } from './api-client.js';
+import { buildApiConfig, pullDocs, pushDocs, pushCRs, pushBugs, deleteDocs, deleteCRs, deleteBugs, pullPendingCRs, pullOpenBugs, resetProject } from './api-client.js';
 import { readRemoteState, writeRemoteState } from './state.js';
 import type {
   PushResult,
@@ -194,13 +194,13 @@ export async function pushToRemote(root: string, options?: PushOptions): Promise
     const crResult = await pushCRs(api, crPayload);
 
     for (const cr of crResult.change_requests) {
-      const localPath = crsToPush.find(
-        (f) => f.frontmatter.title === cr.title,
-      )?.relativePath;
+      const localPath = cr.path
+        ?? crsToPush.find((f) => f.frontmatter.title === cr.title)?.relativePath;
       if (localPath) {
-        const absPath = resolve(root, localPath);
+        const normalized = normalizePath(localPath);
+        const absPath = resolve(root, normalized);
         const rawContent = existsSync(absPath) ? await readFile(absPath, 'utf-8') : '';
-        state.changeRequests![normalizePath(localPath)] = {
+        state.changeRequests![normalized] = {
           remoteId: cr.id,
           localHash: sha256(rawContent),
           lastSynced: new Date().toISOString(),
@@ -247,13 +247,13 @@ export async function pushToRemote(root: string, options?: PushOptions): Promise
     const bugResult = await pushBugs(api, bugPayload);
 
     for (const bug of bugResult.bugs) {
-      const localPath = bugsToPush.find(
-        (b) => b.frontmatter.title === bug.title,
-      )?.relativePath;
+      const localPath = bug.path
+        ?? bugsToPush.find((b) => b.frontmatter.title === bug.title)?.relativePath;
       if (localPath) {
-        const absPath = resolve(root, localPath);
+        const normalized = normalizePath(localPath);
+        const absPath = resolve(root, normalized);
         const rawContent = existsSync(absPath) ? await readFile(absPath, 'utf-8') : '';
-        state.bugs![normalizePath(localPath)] = {
+        state.bugs![normalized] = {
           remoteId: bug.id,
           localHash: sha256(rawContent),
           lastSynced: new Date().toISOString(),
@@ -432,7 +432,7 @@ export async function pullCRsFromRemote(root: string, timeout?: number): Promise
   const config = await readConfig(root);
   const api = buildApiConfig(config, timeout);
 
-  const remoteCRs = await fetchPendingCRs(api);
+  const remoteCRs = await pullPendingCRs(api);
   const state = await readRemoteState(root);
   if (!state.changeRequests) state.changeRequests = {};
 
@@ -448,7 +448,7 @@ export async function pullCRsFromRemote(root: string, timeout?: number): Promise
 
   // Detect remote deletions: tracked locally but not in remote response
   const remoteCRIdSet = new Set(remoteCRs.map((cr) => cr.id));
-  for (const [localPath, tracked] of Object.entries(state.changeRequests!)) {
+  for (const [localPath, tracked] of Object.entries(state.changeRequests)) {
     if (!remoteCRIdSet.has(tracked.remoteId)) {
       const absPath = resolve(root, localPath);
       if (existsSync(absPath)) {
@@ -522,7 +522,7 @@ export async function pullBugsFromRemote(root: string, timeout?: number): Promis
   const config = await readConfig(root);
   const api = buildApiConfig(config, timeout);
 
-  const remoteBugs = await fetchOpenBugs(api);
+  const remoteBugs = await pullOpenBugs(api);
   const state = await readRemoteState(root);
   if (!state.bugs) state.bugs = {};
 
@@ -538,7 +538,7 @@ export async function pullBugsFromRemote(root: string, timeout?: number): Promis
 
   // Detect remote deletions: tracked locally but not in remote response
   const remoteBugIdSet = new Set(remoteBugs.map((b) => b.id));
-  for (const [localPath, tracked] of Object.entries(state.bugs!)) {
+  for (const [localPath, tracked] of Object.entries(state.bugs)) {
     if (!remoteBugIdSet.has(tracked.remoteId)) {
       const absPath = resolve(root, localPath);
       if (existsSync(absPath)) {

package/src/scaffold/skill-adapters.ts

@@ -6,6 +6,7 @@ import {
   CHANGE_REQUESTS_REFERENCE,
   FILE_FORMAT_REFERENCE,
   SKILL_MD_TEMPLATE,
+  SKILL_REMOTE_MD_TEMPLATE,
   SKILL_UI_MD_TEMPLATE,
 } from "./templates.js";
 
@@ -81,22 +82,20 @@ const CANONICAL_SKILLS: Array<{
       },
     ],
   },
+  {
+    id: "sdd-remote",
+    files: [
+      {
+        path: `${CANONICAL_BASE_DIR}/sdd-remote/SKILL.md`,
+        content: SKILL_REMOTE_MD_TEMPLATE,
+      },
+    ],
+  },
 ];
 
 const CANONICAL_FILES: Array<{ path: string; content: string }> =
   CANONICAL_SKILLS.flatMap((skill) => skill.files);
 
-export interface SkillPathsDefinition {
-  skillId: string;
-  paths: string[];
-}
-
-export interface SkillAdapterDefinition {
-  id: string;
-  mode: AdapterMode;
-  skills: SkillPathsDefinition[];
-}
-
 export const SKILL_ADAPTERS: SkillAdapterDefinition[] = [
   {
     id: "claude",
@@ -115,6 +114,10 @@ export const SKILL_ADAPTERS: SkillAdapterDefinition[] = [
         skillId: "sdd-ui",
         paths: [".claude/skills/sdd-ui/SKILL.md"],
       },
+      {
+        skillId: "sdd-remote",
+        paths: [".claude/skills/sdd-remote/SKILL.md"],
+      },
     ],
   },
   {
@@ -134,6 +137,10 @@ export const SKILL_ADAPTERS: SkillAdapterDefinition[] = [
         skillId: "sdd-ui",
         paths: [".agents/skills/sdd-ui/SKILL.md"],
       },
+      {
+        skillId: "sdd-remote",
+        paths: [".agents/skills/sdd-remote/SKILL.md"],
+      },
     ],
   },
 ];