hammoc 1.0.0

package/packages/shared/dist/utils/__tests__/queueTemplateUtils.test.js

@@ -0,0 +1,138 @@
+/**
+ * Queue Template Utilities Tests
+ * [Source: Story 15.5 - Task 8.1]
+ */
+import { describe, it, expect } from 'vitest';
+import { extractStoryNumbers, generateQueueFromTemplate } from '../queueTemplateUtils';
+describe('extractStoryNumbers', () => {
+    // TC-QT-1
+    it('extracts ### Story N.N: Title patterns correctly', () => {
+        const content = `
+### Story 1.1: User Authentication
+Some description here.
+### Story 1.2: Login Flow
+More description.
+`;
+        const result = extractStoryNumbers(content);
+        expect(result).toHaveLength(2);
+        expect(result[0]).toEqual({
+            storyNum: '1.1',
+            epicNum: 1,
+            storyIndex: 1,
+            title: 'User Authentication',
+        });
+        expect(result[1]).toEqual({
+            storyNum: '1.2',
+            epicNum: 1,
+            storyIndex: 2,
+            title: 'Login Flow',
+        });
+    });
+    // TC-QT-2
+    it('extracts ## Story N.N patterns (no title)', () => {
+        const content = `
+## Story 2.1
+Some content.
+## Story 2.2
+More content.
+`;
+        const result = extractStoryNumbers(content);
+        expect(result).toHaveLength(2);
+        expect(result[0].storyNum).toBe('2.1');
+        expect(result[0].title).toBeUndefined();
+        expect(result[1].storyNum).toBe('2.2');
+    });
+    // TC-QT-3
+    it('returns sorted results by epicNum then storyIndex', () => {
+        const content = `
+### Story 3.2: Second
+### Story 1.1: First
+### Story 2.1: Middle
+### Story 1.2: Also First
+`;
+        const result = extractStoryNumbers(content);
+        expect(result.map((s) => s.storyNum)).toEqual(['1.1', '1.2', '2.1', '3.2']);
+    });
+    // TC-QT-4
+    it('returns empty array for content with no stories', () => {
+        const content = 'Just some regular markdown content without story headers.';
+        const result = extractStoryNumbers(content);
+        expect(result).toEqual([]);
+    });
+    it('handles dash separator in title', () => {
+        const content = '### Story 5.1 - Dashboard Setup\n';
+        const result = extractStoryNumbers(content);
+        expect(result).toHaveLength(1);
+        expect(result[0].title).toBe('Dashboard Setup');
+    });
+    it('handles en-dash separator in title', () => {
+        const content = '### Story 5.1\u2013Dashboard Setup\n';
+        const result = extractStoryNumbers(content);
+        expect(result).toHaveLength(1);
+        // The regex captures everything after the separator
+        expect(result[0].title).toBe('Dashboard Setup');
+    });
+});
+describe('generateQueueFromTemplate', () => {
+    const stories = [
+        { storyNum: '1.1', epicNum: 1, storyIndex: 1 },
+        { storyNum: '1.2', epicNum: 1, storyIndex: 2 },
+        { storyNum: '2.1', epicNum: 2, storyIndex: 1 },
+    ];
+    // TC-QT-5
+    it('replaces {story_num} with each story number', () => {
+        const template = '/dev {story_num} implement';
+        const result = generateQueueFromTemplate(template, stories, false);
+        expect(result).toContain('/dev 1.1 implement');
+        expect(result).toContain('/dev 1.2 implement');
+        expect(result).toContain('/dev 2.1 implement');
+    });
+    // TC-QT-6
+    it('inserts @pause between different epic groups when enabled', () => {
+        const template = '/dev {story_num}';
+        const result = generateQueueFromTemplate(template, stories, true);
+        const lines = result.split('\n');
+        expect(lines).toEqual([
+            '/dev 1.1',
+            '/dev 1.2',
+            '@pause Epic 1 완료',
+            '/dev 2.1',
+        ]);
+    });
+    // TC-QT-7
+    it('does not insert @pause when disabled', () => {
+        const template = '/dev {story_num}';
+        const result = generateQueueFromTemplate(template, stories, false);
+        expect(result).not.toContain('@pause');
+        const lines = result.split('\n');
+        expect(lines).toEqual(['/dev 1.1', '/dev 1.2', '/dev 2.1']);
+    });
+    // TC-QT-8
+    it('handles single story correctly', () => {
+        const single = [{ storyNum: '3.1', epicNum: 3, storyIndex: 1 }];
+        const result = generateQueueFromTemplate('/dev {story_num}', single, true);
+        expect(result).toBe('/dev 3.1');
+    });
+    // TC-QT-9
+    it('handles multi-line template', () => {
+        const template = '/dev {story_num} implement\n@pause review';
+        const single = [
+            { storyNum: '1.1', epicNum: 1, storyIndex: 1 },
+            { storyNum: '1.2', epicNum: 1, storyIndex: 2 },
+        ];
+        const result = generateQueueFromTemplate(template, single, false);
+        expect(result).toBe('/dev 1.1 implement\n@pause review\n/dev 1.2 implement\n@pause review');
+    });
+    // TC-QT-10
+    it('preserves template content around {story_num}', () => {
+        const template = 'prefix-{story_num}-suffix';
+        const single = [{ storyNum: '4.2', epicNum: 4, storyIndex: 2 }];
+        const result = generateQueueFromTemplate(template, single, false);
+        expect(result).toBe('prefix-4.2-suffix');
+    });
+    it('returns empty string for empty stories array', () => {
+        const result = generateQueueFromTemplate('/dev {story_num}', [], true);
+        expect(result).toBe('');
+    });
+});
+//# sourceMappingURL=queueTemplateUtils.test.js.map

package/packages/shared/dist/utils/__tests__/queueTemplateUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueTemplateUtils.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/queueTemplateUtils.test.ts"],"names":[],"mappings":"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"}

package/packages/shared/dist/utils/queueParser.d.ts

@@ -0,0 +1,3 @@
+import type { QueueParseResult } from '../types/queue.js';
+export declare function parseQueueScript(script: string): QueueParseResult;
+//# sourceMappingURL=queueParser.d.ts.map

package/packages/shared/dist/utils/queueParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueParser.d.ts","sourceRoot":"","sources":["../../src/utils/queueParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,gBAAgB,EAAqB,MAAM,mBAAmB,CAAC;AAExF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAmLjE"}

package/packages/shared/dist/utils/queueParser.js

@@ -0,0 +1,165 @@
+export function parseQueueScript(script) {
+    const items = [];
+    const warnings = [];
+    if (!script) {
+        return { items, warnings };
+    }
+    const lines = script.split('\n');
+    let inMultilineBlock = false;
+    let multilineContent = [];
+    let multilineStartLine = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = i + 1;
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Inside multiline block
+        if (inMultilineBlock) {
+            if (trimmed.toLowerCase() === '@)') {
+                items.push({
+                    prompt: multilineContent.join('\n'),
+                    isNewSession: false,
+                    isMultiline: true,
+                });
+                inMultilineBlock = false;
+                multilineContent = [];
+            }
+            else {
+                multilineContent.push(line);
+            }
+            continue;
+        }
+        // Empty line
+        if (trimmed === '') {
+            continue;
+        }
+        // Comment line
+        if (trimmed.startsWith('#')) {
+            continue;
+        }
+        // Escape handling: \\@ -> literal \@ prompt
+        if (trimmed.startsWith('\\\\@')) {
+            items.push({
+                prompt: trimmed.slice(1), // remove first backslash
+                isNewSession: false,
+            });
+            continue;
+        }
+        // Escape handling: \@ -> literal @ prompt
+        if (trimmed.startsWith('\\@')) {
+            items.push({
+                prompt: trimmed.slice(1), // remove backslash
+                isNewSession: false,
+            });
+            continue;
+        }
+        // Directive detection
+        if (trimmed.startsWith('@')) {
+            const spaceIndex = trimmed.indexOf(' ');
+            const directive = spaceIndex === -1
+                ? trimmed.toLowerCase()
+                : trimmed.slice(0, spaceIndex).toLowerCase();
+            const argStr = spaceIndex === -1
+                ? ''
+                : trimmed.slice(spaceIndex + 1).trim();
+            switch (directive) {
+                case '@new':
+                    items.push({
+                        prompt: '',
+                        isNewSession: true,
+                    });
+                    break;
+                case '@save':
+                    if (!argStr) {
+                        warnings.push({ line: lineNum, message: '@save requires a session name' });
+                    }
+                    else {
+                        items.push({
+                            prompt: '',
+                            isNewSession: false,
+                            saveSessionName: argStr,
+                        });
+                    }
+                    break;
+                case '@load':
+                    if (!argStr) {
+                        warnings.push({ line: lineNum, message: '@load requires a session name' });
+                    }
+                    else {
+                        items.push({
+                            prompt: '',
+                            isNewSession: false,
+                            loadSessionName: argStr,
+                        });
+                    }
+                    break;
+                case '@pause': {
+                    items.push({
+                        prompt: argStr,
+                        isNewSession: false,
+                        isBreakpoint: true,
+                    });
+                    break;
+                }
+                case '@model':
+                    if (!argStr) {
+                        warnings.push({ line: lineNum, message: '@model requires a model name' });
+                    }
+                    else {
+                        items.push({
+                            prompt: '',
+                            isNewSession: false,
+                            modelName: argStr,
+                        });
+                    }
+                    break;
+                case '@delay': {
+                    const ms = parseInt(argStr, 10);
+                    if (!argStr || isNaN(ms) || ms <= 0 || !Number.isInteger(ms) || argStr !== String(ms)) {
+                        warnings.push({ line: lineNum, message: '@delay requires a positive integer value' });
+                    }
+                    else {
+                        items.push({
+                            prompt: '',
+                            isNewSession: false,
+                            delayMs: ms,
+                        });
+                    }
+                    break;
+                }
+                case '@(':
+                    inMultilineBlock = true;
+                    multilineStartLine = lineNum;
+                    multilineContent = [];
+                    break;
+                default:
+                    // Unknown directive
+                    warnings.push({ line: lineNum, message: `Unknown directive: ${directive}` });
+                    items.push({
+                        prompt: trimmed,
+                        isNewSession: false,
+                    });
+                    break;
+            }
+            continue;
+        }
+        // Regular line (prompt)
+        items.push({
+            prompt: trimmed,
+            isNewSession: false,
+        });
+    }
+    // Unclosed multiline block
+    if (inMultilineBlock) {
+        warnings.push({
+            line: multilineStartLine,
+            message: 'Unclosed multiline block: missing @)',
+        });
+        items.push({
+            prompt: multilineContent.join('\n'),
+            isNewSession: false,
+            isMultiline: true,
+        });
+    }
+    return { items, warnings };
+}
+//# sourceMappingURL=queueParser.js.map

package/packages/shared/dist/utils/queueParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueParser.js","sourceRoot":"","sources":["../../src/utils/queueParser.ts"],"names":[],"mappings":"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"}

package/packages/shared/dist/utils/queueTemplateUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Queue Template Utilities — extract stories from PRD and generate queue scripts
+ * [Source: Story 15.5 - Task 2]
+ */
+import type { QueueStoryInfo } from '../types/queue.js';
+/**
+ * Extract story numbers from PRD content by matching "## Story N.N" / "### Story N.N" headers.
+ * Also matches standalone "## Story N" / "### Story N" when epicContext is provided.
+ * Returns sorted array by epicNum then storyIndex.
+ */
+export declare function extractStoryNumbers(prdContent: string, epicContext?: number): QueueStoryInfo[];
+/**
+ * Generate a queue script by replacing {story_num} in template for each selected story.
+ * Optionally inserts @pause between different epic groups.
+ */
+export declare function generateQueueFromTemplate(template: string, stories: QueueStoryInfo[], insertPauseBetweenEpics: boolean): string;
+//# sourceMappingURL=queueTemplateUtils.d.ts.map

package/packages/shared/dist/utils/queueTemplateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueTemplateUtils.d.ts","sourceRoot":"","sources":["../../src/utils/queueTemplateUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAoC9F;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EAAE,EACzB,uBAAuB,EAAE,OAAO,GAC/B,MAAM,CAmBR"}

package/packages/shared/dist/utils/queueTemplateUtils.js

@@ -0,0 +1,65 @@
+/**
+ * Queue Template Utilities — extract stories from PRD and generate queue scripts
+ * [Source: Story 15.5 - Task 2]
+ */
+/**
+ * Extract story numbers from PRD content by matching "## Story N.N" / "### Story N.N" headers.
+ * Also matches standalone "## Story N" / "### Story N" when epicContext is provided.
+ * Returns sorted array by epicNum then storyIndex.
+ */
+export function extractStoryNumbers(prdContent, epicContext) {
+    const regex = /^#{2,3}\s+Story\s+(\d+)(?:\.(\d+))?(?:[: \t\u2013-]+(.+))?/gm;
+    const stories = [];
+    let match;
+    while ((match = regex.exec(prdContent)) !== null) {
+        let epicNum;
+        let storyIndex;
+        let title;
+        if (match[2] != null) {
+            // Dotted format: "Story 3.1" → epic 3, story index 1
+            epicNum = parseInt(match[1], 10);
+            storyIndex = parseInt(match[2], 10);
+            title = match[3]?.trim() || undefined;
+        }
+        else if (epicContext != null) {
+            // Standalone format: "Story 1" in an epic-specific file
+            epicNum = epicContext;
+            storyIndex = parseInt(match[1], 10);
+            title = match[3]?.trim() || undefined;
+        }
+        else {
+            // Standalone without context — can't determine epic, skip
+            continue;
+        }
+        stories.push({
+            storyNum: `${epicNum}.${storyIndex}`,
+            epicNum,
+            storyIndex,
+            title,
+        });
+    }
+    stories.sort((a, b) => a.epicNum - b.epicNum || a.storyIndex - b.storyIndex);
+    return stories;
+}
+/**
+ * Generate a queue script by replacing {story_num} in template for each selected story.
+ * Optionally inserts @pause between different epic groups.
+ */
+export function generateQueueFromTemplate(template, stories, insertPauseBetweenEpics) {
+    if (stories.length === 0)
+        return '';
+    // Normalize CRLF → LF and strip leading/trailing blank lines
+    const trimmed = template.replace(/\r\n/g, '\n').replace(/^\n+|\n+$/g, '');
+    const blocks = [];
+    let prevEpicNum = stories[0].epicNum;
+    for (const story of stories) {
+        if (insertPauseBetweenEpics && story.epicNum !== prevEpicNum) {
+            blocks.push(`@pause Epic ${prevEpicNum} 완료`);
+            prevEpicNum = story.epicNum;
+        }
+        const replaced = trimmed.replace(/\{story_num\}/g, story.storyNum);
+        blocks.push(replaced);
+    }
+    return blocks.join('\n');
+}
+//# sourceMappingURL=queueTemplateUtils.js.map

package/packages/shared/dist/utils/queueTemplateUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queueTemplateUtils.js","sourceRoot":"","sources":["../../src/utils/queueTemplateUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,WAAoB;IAC1E,MAAM,KAAK,GAAG,8DAA8D,CAAC;IAC7E,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,IAAI,OAAe,CAAC;QACpB,IAAI,UAAkB,CAAC;QACvB,IAAI,KAAyB,CAAC;QAE9B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,qDAAqD;YACrD,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACxC,CAAC;aAAM,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YAC/B,wDAAwD;YACxD,OAAO,GAAG,WAAW,CAAC;YACtB,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,0DAA0D;YAC1D,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,GAAG,OAAO,IAAI,UAAU,EAAE;YACpC,OAAO;YACP,UAAU;YACV,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAE7E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,OAAyB,EACzB,uBAAgC;IAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,6DAA6D;IAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,uBAAuB,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,eAAe,WAAW,KAAK,CAAC,CAAC;YAC7C,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/packages/shared/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@hammoc/shared",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+'use strict';
+
+// Link @howdah/shared into node_modules after npm install.
+// In workspace (development) mode, npm handles this via symlinks.
+// In global/standalone install, we need to create the link manually
+// so the server can resolve `import ... from '@howdah/shared'`.
+
+const fs = require('fs');
+const path = require('path');
+
+const root = path.resolve(__dirname, '..');
+const sharedPkg = path.resolve(root, 'packages', 'shared');
+const nmScope = path.resolve(root, 'node_modules', '@howdah');
+const nmTarget = path.resolve(nmScope, 'shared');
+
+// Only create link if shared package exists in tarball but not in node_modules
+if (fs.existsSync(sharedPkg) && !fs.existsSync(nmTarget)) {
+  fs.mkdirSync(nmScope, { recursive: true });
+  // Use junction on Windows (no admin privileges needed), symlink on Unix
+  const type = process.platform === 'win32' ? 'junction' : 'dir';
+  fs.symlinkSync(sharedPkg, nmTarget, type);
+}