@pennyfarthing/core 10.4.0 → 11.0.0

package/packages/core/dist/shared/marker/constants.js

@@ -0,0 +1,46 @@
+/**
+ * Constants for the Reflector marker system.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+/**
+ * Regex pattern for CYCLIST markers.
+ *
+ * Format: <!-- CYCLIST:TYPE:value --> or <!-- CYCLIST:TYPE --> (for CONTINUE)
+ *
+ * - Case-insensitive for CYCLIST prefix and TYPE
+ * - Preserves value case
+ * - Handles whitespace variations
+ * - Value is optional (CONTINUE marker has no value)
+ *
+ * Groups:
+ * - [1] = TYPE (e.g., HANDOFF, CONTEXT_CLEAR, CONTINUE)
+ * - [2] = value (e.g., /dev, yesno, 1,2,3) - undefined for CONTINUE
+ *
+ * IMPORTANT: Reset lastIndex before each use since this is a global regex.
+ */
+export const MARKER_PATTERN = /<!--\s*CYCLIST:(\w+)(?::([^>]+?))?\s*-->/gi;
+/**
+ * Known marker type constants.
+ * Use these for type-safe comparisons instead of string literals.
+ */
+export const MARKER_TYPES = {
+    HANDOFF: 'handoff',
+    CONTEXT_CLEAR: 'context_clear',
+    INVOKE: 'invoke',
+    QUESTION: 'question',
+    CHOICES: 'choices',
+    CONTINUE: 'continue',
+};
+/**
+ * Valid marker types for validation.
+ */
+export const VALID_MARKER_TYPES = new Set([
+    'handoff',
+    'context_clear',
+    'invoke',
+    'question',
+    'choices',
+    'continue',
+]);
+//# sourceMappingURL=constants.js.map

package/packages/core/dist/shared/marker/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/shared/marker/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,4CAA4C,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,eAAe;IAC9B,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,SAAS;IACT,eAAe;IACf,QAAQ;IACR,UAAU;IACV,SAAS;IACT,UAAU;CACX,CAAC,CAAC"}

package/packages/core/dist/shared/marker/continue.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tests for the CONTINUE marker type
+ *
+ * Story: MSSCI-12787 - Implement CYCLIST Marker Parsing and Action Buttons
+ *
+ * The CONTINUE marker signals a status update - the user can continue
+ * or redirect. It has no value parameter.
+ *
+ * Format: <!-- CYCLIST:CONTINUE -->
+ */
+export {};
+//# sourceMappingURL=continue.test.d.ts.map

package/packages/core/dist/shared/marker/continue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue.test.d.ts","sourceRoot":"","sources":["../../../src/shared/marker/continue.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/packages/core/dist/shared/marker/continue.test.js

@@ -0,0 +1,76 @@
+/**
+ * Tests for the CONTINUE marker type
+ *
+ * Story: MSSCI-12787 - Implement CYCLIST Marker Parsing and Action Buttons
+ *
+ * The CONTINUE marker signals a status update - the user can continue
+ * or redirect. It has no value parameter.
+ *
+ * Format: <!-- CYCLIST:CONTINUE -->
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { detectMarkers, MARKER_TYPES, VALID_MARKER_TYPES, } from './index.js';
+describe('CONTINUE marker type', () => {
+    describe('type definition', () => {
+        it('should include continue in MarkerType', () => {
+            // This test verifies the type includes 'continue'
+            const type = 'continue';
+            assert.strictEqual(type, 'continue');
+        });
+        it('should have CONTINUE constant in MARKER_TYPES', () => {
+            assert.strictEqual(MARKER_TYPES.CONTINUE, 'continue');
+        });
+        it('should include continue in VALID_MARKER_TYPES', () => {
+            assert.ok(VALID_MARKER_TYPES.has('continue'), 'VALID_MARKER_TYPES should include continue');
+        });
+    });
+    describe('detection', () => {
+        it('should detect CONTINUE marker without value', () => {
+            const text = '<!-- CYCLIST:CONTINUE -->';
+            const result = detectMarkers(text);
+            assert.ok(result !== null, 'Should detect CONTINUE marker');
+            assert.strictEqual(result.length, 1);
+            assert.strictEqual(result[0].type, 'continue');
+            // CONTINUE has no value, should be empty string or null
+            assert.ok(result[0].value === '' || result[0].value === null || result[0].value === undefined, 'CONTINUE marker should have no value');
+        });
+        it('should be case-insensitive for CONTINUE type', () => {
+            const texts = [
+                '<!-- CYCLIST:CONTINUE -->',
+                '<!-- CYCLIST:continue -->',
+                '<!-- CYCLIST:Continue -->',
+            ];
+            for (const text of texts) {
+                const result = detectMarkers(text);
+                assert.ok(result !== null, `Should detect marker in: ${text}`);
+                assert.strictEqual(result[0].type, 'continue', 'Type should be normalized to lowercase');
+            }
+        });
+        it('should detect CONTINUE alongside other markers', () => {
+            const text = `
+Some status update here.
+
+<!-- CYCLIST:CONTINUE -->
+
+Run \`/dev\` to continue
+`;
+            const result = detectMarkers(text);
+            assert.ok(result !== null, 'Should detect CONTINUE marker');
+            assert.strictEqual(result.length, 1);
+            assert.strictEqual(result[0].type, 'continue');
+        });
+        it('should ignore CONTINUE inside code blocks', () => {
+            const text = `
+Regular text
+\`\`\`
+<!-- CYCLIST:CONTINUE -->
+\`\`\`
+More text
+`;
+            const result = detectMarkers(text);
+            assert.strictEqual(result, null, 'Should not detect marker inside code block');
+        });
+    });
+});
+//# sourceMappingURL=continue.test.js.map

package/packages/core/dist/shared/marker/continue.test.js.map

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

package/packages/core/dist/shared/marker/detect.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Marker detection for the Reflector protocol.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+import type { Marker } from './types.js';
+/**
+ * Detect CYCLIST markers in text.
+ *
+ * Scans text for CYCLIST markers and returns an array of parsed markers.
+ * Code blocks are stripped before detection to prevent false positives
+ * from markers appearing inside code examples.
+ *
+ * @param text - Text to scan for markers
+ * @returns Array of markers found, or null if none
+ *
+ * @example
+ * ```typescript
+ * const text = '<!-- CYCLIST:HANDOFF:/dev -->';
+ * const markers = detectMarkers(text);
+ * // markers = [{ type: 'handoff', value: '/dev', source: 'structured_marker' }]
+ * ```
+ */
+export declare function detectMarkers(text: string): Marker[] | null;
+//# sourceMappingURL=detect.d.ts.map

package/packages/core/dist/shared/marker/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/shared/marker/detect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAkC3D"}

package/packages/core/dist/shared/marker/detect.js

@@ -0,0 +1,53 @@
+/**
+ * Marker detection for the Reflector protocol.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+import { MARKER_PATTERN, VALID_MARKER_TYPES } from './constants.js';
+import { stripCodeBlocks } from './strip.js';
+/**
+ * Detect CYCLIST markers in text.
+ *
+ * Scans text for CYCLIST markers and returns an array of parsed markers.
+ * Code blocks are stripped before detection to prevent false positives
+ * from markers appearing inside code examples.
+ *
+ * @param text - Text to scan for markers
+ * @returns Array of markers found, or null if none
+ *
+ * @example
+ * ```typescript
+ * const text = '<!-- CYCLIST:HANDOFF:/dev -->';
+ * const markers = detectMarkers(text);
+ * // markers = [{ type: 'handoff', value: '/dev', source: 'structured_marker' }]
+ * ```
+ */
+export function detectMarkers(text) {
+    // Handle null/undefined/empty input
+    if (!text) {
+        return null;
+    }
+    // Strip code blocks first - markers inside code should be ignored
+    const withoutCode = stripCodeBlocks(text);
+    if (!withoutCode.trim()) {
+        return null;
+    }
+    const markers = [];
+    // Reset lastIndex for global regex
+    MARKER_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = MARKER_PATTERN.exec(withoutCode)) !== null) {
+        const rawType = match[1].toLowerCase();
+        // Skip unknown marker types
+        if (!VALID_MARKER_TYPES.has(rawType)) {
+            continue;
+        }
+        markers.push({
+            type: rawType,
+            value: match[2]?.trim() ?? '',
+            source: 'structured_marker',
+        });
+    }
+    return markers.length > 0 ? markers : null;
+}
+//# sourceMappingURL=detect.js.map

package/packages/core/dist/shared/marker/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../src/shared/marker/detect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,oCAAoC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kEAAkE;IAClE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mCAAmC;IACnC,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC;IAE7B,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAEvC,4BAA4B;QAC5B,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,OAAqB;YAC3B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;YAC7B,MAAM,EAAE,mBAAmB;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/packages/core/dist/shared/marker/detect.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for the marker detection module.
+ *
+ * These tests cover the shared marker parsing logic that will be used by
+ * both Cyclist terminal and VS Code extension.
+ *
+ * @see docs/adr/0011-reflector-marker-consolidation.md
+ */
+export {};
+//# sourceMappingURL=detect.test.d.ts.map

package/packages/core/dist/shared/marker/detect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.test.d.ts","sourceRoot":"","sources":["../../../src/shared/marker/detect.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}