ralphctl 0.1.0 → 0.1.2

package/src/utils/paths.ts

@@ -1,108 +0,0 @@
-import { fileURLToPath } from 'node:url';
-import { dirname, isAbsolute, join, resolve, sep } from 'node:path';
-import { homedir } from 'node:os';
-import { lstat, realpath, stat } from 'node:fs/promises';
-
-// Repo root: always the cloned repo directory (for schemas, etc.)
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-function getRepoRoot(): string {
-  return join(__dirname, '..', '..');
-}
-
-// Data directory: RALPHCTL_ROOT env var (if set) or ~/.ralphctl/
-export function getDataDir(): string {
-  return process.env['RALPHCTL_ROOT'] ?? join(homedir(), '.ralphctl');
-}
-
-// Config path (moved to data directory)
-export function getConfigPath(): string {
-  return join(getDataDir(), 'config.json');
-}
-
-// Projects file path
-export function getProjectsFilePath(): string {
-  return join(getDataDir(), 'projects.json');
-}
-
-// Sprint directory and file paths
-export function getSprintsDir(): string {
-  return join(getDataDir(), 'sprints');
-}
-
-export function getSprintDir(sprintId: string): string {
-  const sprintsDir = getSprintsDir();
-  const resolved = resolve(sprintsDir, sprintId);
-  if (!resolved.startsWith(sprintsDir + sep) && resolved !== sprintsDir) {
-    throw new Error(`Path traversal detected in sprint ID: ${sprintId}`);
-  }
-  return resolved;
-}
-
-export function getSprintFilePath(sprintId: string): string {
-  return join(getSprintDir(sprintId), 'sprint.json');
-}
-
-export function getTasksFilePath(sprintId: string): string {
-  return join(getSprintDir(sprintId), 'tasks.json');
-}
-
-export function getProgressFilePath(sprintId: string): string {
-  return join(getSprintDir(sprintId), 'progress.md');
-}
-
-export function getRefinementDir(sprintId: string, ticketId: string): string {
-  return join(getSprintDir(sprintId), 'refinement', ticketId);
-}
-
-export function getPlanningDir(sprintId: string): string {
-  return join(getSprintDir(sprintId), 'planning');
-}
-
-export function getIdeateDir(sprintId: string, ticketId: string): string {
-  return join(getSprintDir(sprintId), 'ideation', ticketId);
-}
-
-export function getSchemaPath(schemaName: string): string {
-  return join(getRepoRoot(), 'schemas', schemaName);
-}
-
-/**
- * Validate a path is safe to use as execSync/spawn cwd.
- * Rejects null bytes, newlines, and non-absolute paths.
- * @throws Error if path is unsafe
- */
-export function assertSafeCwd(path: string): void {
-  if (!path || path.includes('\0') || path.includes('\n') || path.includes('\r')) {
-    throw new Error('Unsafe path for cwd: contains null bytes or newlines');
-  }
-  if (!isAbsolute(path)) {
-    throw new Error(`Unsafe path for cwd: must be absolute, got: ${path}`);
-  }
-}
-
-/**
- * Validate that a path exists and is a directory.
- * Returns `true` if valid, or an error message string if invalid.
- */
-export async function validateProjectPath(path: string): Promise<string | true> {
-  try {
-    const resolved = resolve(path);
-    const lstats = await lstat(resolved);
-    if (lstats.isSymbolicLink()) {
-      const realPath = await realpath(resolved);
-      const realStats = await stat(realPath);
-      if (!realStats.isDirectory()) {
-        return 'Symlink target is not a directory';
-      }
-      return true;
-    }
-    if (!lstats.isDirectory()) {
-      return 'Path is not a directory';
-    }
-    return true;
-  } catch {
-    return 'Directory does not exist';
-  }
-}

package/src/utils/provider.ts

@@ -1,34 +0,0 @@
-import { select } from '@inquirer/prompts';
-import type { AiProvider } from '@src/schemas/index.ts';
-import { getAiProvider, setAiProvider } from '@src/store/config.ts';
-import { emoji } from '@src/theme/ui.ts';
-
-/**
- * Resolve the active AI provider.
- * Reads from config; if not set, prompts the user to choose and saves the selection.
- */
-export async function resolveProvider(): Promise<AiProvider> {
-  const stored = await getAiProvider();
-  if (stored) return stored;
-
-  const choice = await select<AiProvider>({
-    message: `${emoji.donut} Which AI buddy should help with my homework?`,
-    choices: [
-      { name: 'Claude Code', value: 'claude' as const },
-      { name: 'GitHub Copilot', value: 'copilot' as const },
-    ],
-  });
-
-  await setAiProvider(choice);
-  return choice;
-}
-
-/** Human-readable display name for a provider. */
-export function providerDisplayName(provider: AiProvider): string {
-  return provider === 'claude' ? 'Claude' : 'Copilot';
-}
-
-/** CLI binary name for a provider. */
-export function providerBinary(provider: AiProvider): string {
-  return provider === 'claude' ? 'claude' : 'copilot';
-}

package/src/utils/requirements-export.ts

@@ -1,63 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import { dirname } from 'node:path';
-import type { Sprint, Ticket } from '@src/schemas/index.ts';
-import { ensureDir } from '@src/utils/storage.ts';
-
-/**
- * Format requirements as a markdown document.
- */
-function formatRequirementsMarkdown(sprint: Sprint): string {
-  const lines: string[] = [];
-
-  lines.push(`# Sprint Requirements: ${sprint.name}`);
-  lines.push('');
-  lines.push(`Sprint ID: ${sprint.id}`);
-  lines.push(`Generated: ${new Date().toISOString()}`);
-  lines.push(`Status: ${sprint.status}`);
-
-  if (sprint.tickets.length === 0) {
-    lines.push('');
-    lines.push('---');
-    lines.push('');
-    lines.push('_No tickets in this sprint._');
-    return lines.join('\n') + '\n';
-  }
-
-  for (const ticket of sprint.tickets) {
-    lines.push('');
-    lines.push('---');
-    lines.push('');
-    lines.push(formatTicketSection(ticket));
-  }
-
-  return lines.join('\n') + '\n';
-}
-
-function formatTicketSection(ticket: Ticket): string {
-  const lines: string[] = [];
-
-  lines.push(`## ${ticket.projectName} - ${ticket.title}`);
-  lines.push('');
-  lines.push(`**Ticket ID:** ${ticket.id}`);
-  lines.push(`**Status:** ${ticket.requirementStatus}`);
-
-  if (ticket.link) {
-    lines.push(`**Link:** ${ticket.link}`);
-  }
-
-  lines.push('');
-  lines.push('### Requirements');
-  lines.push('');
-  lines.push(ticket.requirements ?? '_No requirements defined_');
-
-  return lines.join('\n');
-}
-
-/**
- * Export sprint requirements to a markdown file.
- */
-export async function exportRequirementsToMarkdown(sprint: Sprint, outputPath: string): Promise<void> {
-  const content = formatRequirementsMarkdown(sprint);
-  await ensureDir(dirname(outputPath));
-  await writeFile(outputPath, content, 'utf-8');
-}

package/src/utils/storage.ts

@@ -1,107 +0,0 @@
-import { access, appendFile, mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
-import { dirname } from 'node:path';
-import type { ZodType } from 'zod';
-
-export class ValidationError extends Error {
-  public readonly path: string;
-
-  constructor(message: string, path: string, cause?: unknown) {
-    super(message, { cause });
-    this.name = 'ValidationError';
-    this.path = path;
-  }
-}
-
-export class FileNotFoundError extends Error {
-  public readonly path: string;
-
-  constructor(message: string, path: string) {
-    super(message);
-    this.name = 'FileNotFoundError';
-    this.path = path;
-  }
-}
-
-export async function ensureDir(dirPath: string): Promise<void> {
-  await mkdir(dirPath, { recursive: true });
-}
-
-export async function removeDir(dirPath: string): Promise<void> {
-  await rm(dirPath, { recursive: true, force: true });
-}
-
-export async function fileExists(filePath: string): Promise<boolean> {
-  try {
-    await access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export async function listDirs(dirPath: string): Promise<string[]> {
-  try {
-    const entries = await readdir(dirPath, { withFileTypes: true });
-    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
-  } catch {
-    return [];
-  }
-}
-
-export async function readValidatedJson<Output>(filePath: string, schema: ZodType<Output>): Promise<Output> {
-  let content: string;
-  try {
-    content = await readFile(filePath, 'utf-8');
-  } catch (err) {
-    if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
-      throw new FileNotFoundError(`File not found: ${filePath}`, filePath);
-    }
-    throw err;
-  }
-
-  let data: unknown;
-  try {
-    data = JSON.parse(content);
-  } catch (err) {
-    throw new ValidationError(`Invalid JSON in ${filePath}`, filePath, err);
-  }
-
-  const result = schema.safeParse(data);
-  if (!result.success) {
-    const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\n');
-    throw new ValidationError(`Validation failed for ${filePath}:\n${issues}`, filePath, result.error);
-  }
-
-  return result.data;
-}
-
-export async function writeValidatedJson<Output>(
-  filePath: string,
-  data: Output,
-  schema: ZodType<Output>
-): Promise<void> {
-  const result = schema.safeParse(data);
-  if (!result.success) {
-    const issues = result.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\n');
-    throw new ValidationError(`Validation failed before writing to ${filePath}:\n${issues}`, filePath, result.error);
-  }
-
-  await ensureDir(dirname(filePath));
-  await writeFile(filePath, JSON.stringify(result.data, null, 2) + '\n', { encoding: 'utf-8', mode: 0o600 });
-}
-
-export async function appendToFile(filePath: string, content: string): Promise<void> {
-  await ensureDir(dirname(filePath));
-  await appendFile(filePath, content, { encoding: 'utf-8', mode: 0o600 });
-}
-
-export async function readTextFile(filePath: string): Promise<string> {
-  try {
-    return await readFile(filePath, 'utf-8');
-  } catch (err) {
-    if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
-      throw new FileNotFoundError(`File not found: ${filePath}`, filePath);
-    }
-    throw err;
-  }
-}

package/tsconfig.json

@@ -1,25 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2024",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-    "allowImportingTsExtensions": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-    "noPropertyAccessFromIndexSignature": true,
-    "forceConsistentCasingInFileNames": true,
-    "baseUrl": ".",
-    "paths": {
-      "@src/*": ["src/*"]
-    }
-  },
-  "include": ["src/**/*", "bin/*"],
-  "exclude": ["node_modules", "dist"]
-}