gsd-remix 1.0.0

package/sdk/src/query/utils.test.ts

@@ -0,0 +1,82 @@
+/**
+ * Unit tests for utility query handlers.
+ *
+ * Covers: generateSlug and currentTimestamp functions with output parity
+ * to gsd-tools.cjs cmdGenerateSlug and cmdCurrentTimestamp.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { generateSlug, currentTimestamp } from './utils.js';
+import { GSDError, ErrorClassification } from '../errors.js';
+
+const PROJECT_DIR = '/tmp/test-project';
+
+describe('generateSlug', () => {
+  it('converts simple text to kebab-case slug', async () => {
+    const result = await generateSlug(['My Phase Name'], PROJECT_DIR);
+    expect(result).toEqual({ data: { slug: 'my-phase-name' } });
+  });
+
+  it('strips non-alphanumeric characters and collapses runs', async () => {
+    const result = await generateSlug(['  Hello   World!!!  '], PROJECT_DIR);
+    expect(result).toEqual({ data: { slug: 'hello-world' } });
+  });
+
+  it('strips leading and trailing hyphens', async () => {
+    const result = await generateSlug(['---test---'], PROJECT_DIR);
+    expect(result).toEqual({ data: { slug: 'test' } });
+  });
+
+  it('truncates slug to 60 characters', async () => {
+    const longText = 'a'.repeat(100);
+    const result = await generateSlug([longText], PROJECT_DIR);
+    expect((result.data as { slug: string }).slug).toHaveLength(60);
+  });
+
+  it('throws GSDError with Validation classification for empty text', async () => {
+    await expect(generateSlug([''], PROJECT_DIR)).rejects.toThrow(GSDError);
+    try {
+      await generateSlug([''], PROJECT_DIR);
+    } catch (err) {
+      expect(err).toBeInstanceOf(GSDError);
+      expect((err as GSDError).classification).toBe(ErrorClassification.Validation);
+    }
+  });
+
+  it('throws GSDError with Validation classification for missing text', async () => {
+    await expect(generateSlug([], PROJECT_DIR)).rejects.toThrow(GSDError);
+    try {
+      await generateSlug([], PROJECT_DIR);
+    } catch (err) {
+      expect(err).toBeInstanceOf(GSDError);
+      expect((err as GSDError).classification).toBe(ErrorClassification.Validation);
+    }
+  });
+});
+
+describe('currentTimestamp', () => {
+  it('returns full ISO timestamp by default', async () => {
+    const result = await currentTimestamp([], PROJECT_DIR);
+    const ts = (result.data as { timestamp: string }).timestamp;
+    expect(ts).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/);
+  });
+
+  it('returns full ISO timestamp for "full" format', async () => {
+    const result = await currentTimestamp(['full'], PROJECT_DIR);
+    const ts = (result.data as { timestamp: string }).timestamp;
+    expect(ts).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+  });
+
+  it('returns date-only string for "date" format', async () => {
+    const result = await currentTimestamp(['date'], PROJECT_DIR);
+    const ts = (result.data as { timestamp: string }).timestamp;
+    expect(ts).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+  });
+
+  it('returns filename-safe string for "filename" format', async () => {
+    const result = await currentTimestamp(['filename'], PROJECT_DIR);
+    const ts = (result.data as { timestamp: string }).timestamp;
+    expect(ts).not.toContain(':');
+    expect(ts).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}$/);
+  });
+});

package/sdk/src/query/utils.ts

@@ -0,0 +1,92 @@
+/**
+ * Utility query handlers — pure SDK implementations of simple commands.
+ *
+ * These handlers are direct TypeScript ports of gsd-tools.cjs functions:
+ * - `generateSlug` ← `cmdGenerateSlug` (commands.cjs lines 38-48)
+ * - `currentTimestamp` ← `cmdCurrentTimestamp` (commands.cjs lines 50-71)
+ *
+ * @example
+ * ```typescript
+ * import { generateSlug, currentTimestamp } from './utils.js';
+ *
+ * const slug = await generateSlug(['My Phase Name'], '/path/to/project');
+ * // { data: { slug: 'my-phase-name' } }
+ *
+ * const ts = await currentTimestamp(['date'], '/path/to/project');
+ * // { data: { timestamp: '2026-04-08' } }
+ * ```
+ */
+
+import { GSDError, ErrorClassification } from '../errors.js';
+
+// ─── Types ──────────────────────────────────────────────────────────────────
+
+/** Structured result returned by all query handlers. */
+export interface QueryResult {
+  data: unknown;
+}
+
+/** Signature for a query handler function. */
+export type QueryHandler = (args: string[], projectDir: string) => Promise<QueryResult>;
+
+// ─── generateSlug ───────────────────────────────────────────────────────────
+
+/**
+ * Converts text into a URL-safe kebab-case slug.
+ *
+ * Port of `cmdGenerateSlug` from `get-shit-done/bin/lib/commands.cjs`.
+ * Algorithm: lowercase, replace non-alphanumeric with hyphens,
+ * strip leading/trailing hyphens, truncate to 60 characters.
+ *
+ * @param args - `args[0]` is the text to slugify
+ * @param _projectDir - Unused (pure function)
+ * @returns Query result with `{ slug: string }`
+ * @throws GSDError with Validation classification if text is missing or empty
+ */
+export const generateSlug: QueryHandler = async (args, _projectDir) => {
+  const text = args[0];
+  if (!text) {
+    throw new GSDError('text required for slug generation', ErrorClassification.Validation);
+  }
+
+  const slug = text
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .substring(0, 60);
+
+  return { data: { slug } };
+};
+
+// ─── currentTimestamp ───────────────────────────────────────────────────────
+
+/**
+ * Returns the current timestamp in the requested format.
+ *
+ * Port of `cmdCurrentTimestamp` from `get-shit-done/bin/lib/commands.cjs`.
+ * Formats: `'full'` (ISO 8601), `'date'` (YYYY-MM-DD), `'filename'` (colons replaced).
+ *
+ * @param args - `args[0]` is the format (`'full'` | `'date'` | `'filename'`), defaults to `'full'`
+ * @param _projectDir - Unused (pure function)
+ * @returns Query result with `{ timestamp: string }`
+ */
+export const currentTimestamp: QueryHandler = async (args, _projectDir) => {
+  const format = args[0] || 'full';
+  const now = new Date();
+  let result: string;
+
+  switch (format) {
+    case 'date':
+      result = now.toISOString().split('T')[0];
+      break;
+    case 'filename':
+      result = now.toISOString().replace(/:/g, '-').replace(/\..+/, '');
+      break;
+    case 'full':
+    default:
+      result = now.toISOString();
+      break;
+  }
+
+  return { data: { timestamp: result } };
+};