@kmgeon/taskflow 0.1.3

package/src/cli/lib/trd.ts

@@ -0,0 +1,33 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+export interface TrdFile {
+  name: string;
+  fileName: string;
+  filePath: string;
+}
+
+export function findTrdFiles(projectRoot: string): TrdFile[] {
+  const taskflowDir = path.join(projectRoot, ".taskflow");
+  if (!fs.existsSync(taskflowDir)) return [];
+
+  return fs
+    .readdirSync(taskflowDir)
+    .filter((f) => f.startsWith("trd-") && f.endsWith(".md"))
+    .map((fileName) => {
+      const name = fileName
+        .replace(/^trd-/, "")
+        .replace(/\.md$/, "")
+        .replace(/-/g, " ");
+      return {
+        name,
+        fileName,
+        filePath: path.join(taskflowDir, fileName),
+      };
+    });
+}
+
+/** TRD 파일에서 그룹 이름 목록 반환 */
+export function getTrdGroupNames(projectRoot: string): string[] {
+  return findTrdFiles(projectRoot).map((t) => t.name);
+}

package/src/cli/lib/validate.test.ts

@@ -0,0 +1,89 @@
+import { describe, expect, it } from "vitest";
+import {
+  validateRequired,
+  validateName,
+  validateCommaList,
+  validateOptional,
+} from "./validate.js";
+
+describe("validateRequired", () => {
+  const validate = validateRequired("프로젝트명");
+
+  it("값이 있으면 true를 반환해야 한다", () => {
+    expect(validate("TaskFlow")).toBe(true);
+  });
+
+  it("빈 값이면 에러 메시지를 반환해야 한다", () => {
+    expect(validate("")).toContain("필수 입력");
+  });
+
+  it("공백만 있으면 에러 메시지를 반환해야 한다", () => {
+    expect(validate("   ")).toContain("필수 입력");
+  });
+
+  it("에러 메시지에 라벨이 포함되어야 한다", () => {
+    expect(validate("")).toContain("프로젝트명");
+  });
+});
+
+describe("validateName", () => {
+  const validate = validateName("기능명");
+
+  it("일반 이름은 통과해야 한다", () => {
+    expect(validate("사용자-인증")).toBe(true);
+  });
+
+  it("빈 값이면 에러를 반환해야 한다", () => {
+    expect(validate("")).toContain("필수 입력");
+  });
+
+  it("100자 초과 시 에러를 반환해야 한다", () => {
+    const long = "a".repeat(101);
+    expect(validate(long)).toContain("100자 이내");
+  });
+
+  it("100자 이하는 통과해야 한다", () => {
+    expect(validate("a".repeat(100))).toBe(true);
+  });
+
+  it("금지 문자 포함 시 에러를 반환해야 한다", () => {
+    expect(validate("name<bad>")).toContain("사용할 수 없는 문자");
+    expect(validate('name"bad')).toContain("사용할 수 없는 문자");
+    expect(validate("name|bad")).toContain("사용할 수 없는 문자");
+    expect(validate("name?bad")).toContain("사용할 수 없는 문자");
+  });
+
+  it("허용 문자는 통과해야 한다", () => {
+    expect(validate("auth-module_v2")).toBe(true);
+    expect(validate("한글기능")).toBe(true);
+  });
+});
+
+describe("validateCommaList", () => {
+  const validate = validateCommaList("요구사항");
+
+  it("값이 있으면 통과해야 한다", () => {
+    expect(validate("항목1, 항목2")).toBe(true);
+  });
+
+  it("빈 값이면 에러를 반환해야 한다", () => {
+    expect(validate("")).toContain("최소 하나");
+  });
+
+  it("500자 초과 시 에러를 반환해야 한다", () => {
+    const long = "a".repeat(501);
+    expect(validate(long)).toContain("500자 이내");
+  });
+});
+
+describe("validateOptional", () => {
+  const validate = validateOptional();
+
+  it("빈 값도 통과해야 한다", () => {
+    expect(validate("")).toBe(true);
+  });
+
+  it("값이 있어도 통과해야 한다", () => {
+    expect(validate("something")).toBe(true);
+  });
+});

package/src/cli/lib/validate.ts

@@ -0,0 +1,43 @@
+const MAX_INPUT_LENGTH = 500;
+const MAX_NAME_LENGTH = 100;
+const FORBIDDEN_CHARS = /[<>:"/\\|?*\x00-\x1f]/;
+
+export function validateRequired(label: string) {
+  return (value: string): true | string => {
+    if (!value.trim()) {
+      return `${label}은(는) 필수 입력입니다.`;
+    }
+    return true;
+  };
+}
+
+export function validateName(label: string) {
+  return (value: string): true | string => {
+    if (!value.trim()) {
+      return `${label}은(는) 필수 입력입니다.`;
+    }
+    if (value.length > MAX_NAME_LENGTH) {
+      return `${label}은(는) ${MAX_NAME_LENGTH}자 이내로 입력해주세요.`;
+    }
+    if (FORBIDDEN_CHARS.test(value)) {
+      return `${label}에 사용할 수 없는 문자가 포함되어 있습니다. (< > : " / \\ | ? *)`;
+    }
+    return true;
+  };
+}
+
+export function validateCommaList(label: string) {
+  return (value: string): true | string => {
+    if (!value.trim()) {
+      return `최소 하나의 ${label}을(를) 입력하세요.`;
+    }
+    if (value.length > MAX_INPUT_LENGTH) {
+      return `입력이 너무 깁니다. ${MAX_INPUT_LENGTH}자 이내로 입력해주세요.`;
+    }
+    return true;
+  };
+}
+
+export function validateOptional() {
+  return (_value: string): true => true;
+}

package/src/cli/prompts/task-run.md

@@ -0,0 +1,25 @@
+당신은 소프트웨어 구현 전문 에이전트입니다.
+
+## 임무
+주어진 그룹의 태스크를 순서대로 모두 구현하세요.
+
+## 워크플로우
+다음 루프를 그룹 내 모든 태스크가 완료될 때까지 반복하세요:
+
+1. MCP `get_next_task`를 호출하여 다음 태스크를 가져옵니다 (group 파라미터 사용)
+2. 태스크가 없으면 종료합니다
+3. MCP `set_task_status`로 상태를 `InProgress`로 변경합니다
+4. 태스크의 요구사항에 따라 구현합니다:
+   - 코드 작성/수정
+   - 테스트 작성 및 실행
+   - 기존 코드 패턴을 따르세요
+5. 구현 완료 후 MCP `set_task_status`로 상태를 `Done`으로 변경합니다
+6. 다음 태스크로 이동합니다
+
+## 규칙
+- 한 번에 하나의 태스크만 처리합니다
+- 태스크를 건너뛰지 마세요
+- 기존 코드 스타일과 패턴을 따르세요
+- 테스트가 있으면 반드시 실행하세요
+- 막히면 해당 태스크를 `Blocked`로 설정하고 다음 태스크로 넘어가세요
+- 모든 태스크 완료 시 작업 요약을 출력하세요

package/src/components/layout/AppLayout.tsx

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+import { Sidebar } from "./Sidebar";
+
+type AppLayoutProps = {
+  children: ReactNode;
+};
+
+export function AppLayout({ children }: AppLayoutProps) {
+  return (
+    <div className="flex h-screen overflow-hidden bg-background">
+      <Sidebar />
+      <main className="flex-1 overflow-auto">{children}</main>
+    </div>
+  );
+}

package/src/components/layout/Sidebar.tsx

@@ -0,0 +1,124 @@
+"use client";
+
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import {
+  LayoutGrid,
+  GitFork,
+  Clock,
+  Settings,
+  Search,
+  ChevronDown,
+} from "lucide-react";
+import { cn } from "@/lib/utils";
+import { Separator } from "@/components/ui/separator";
+
+type NavItem = {
+  label: string;
+  href: string;
+  icon: React.ReactNode;
+  shortcut?: string;
+};
+
+const navItems: NavItem[] = [
+  {
+    label: "칸반 보드",
+    href: "/dashboard",
+    icon: <LayoutGrid className="h-4 w-4" />,
+    shortcut: "G K",
+  },
+  {
+    label: "의존성 그래프",
+    href: "/dashboard/graph",
+    icon: <GitFork className="h-4 w-4" />,
+    shortcut: "G D",
+  },
+  {
+    label: "타임라인",
+    href: "/dashboard/timeline",
+    icon: <Clock className="h-4 w-4" />,
+    shortcut: "G T",
+  },
+  {
+    label: "설정",
+    href: "/dashboard/settings",
+    icon: <Settings className="h-4 w-4" />,
+  },
+];
+
+export function Sidebar() {
+  const pathname = usePathname();
+
+  return (
+    <aside className="flex h-screen w-60 shrink-0 flex-col border-r border-border bg-secondary/50">
+      {/* Project selector */}
+      <div className="flex h-14 items-center gap-2 px-4">
+        <div className="flex h-7 w-7 items-center justify-center rounded-md bg-accent text-xs font-bold text-accent-foreground">
+          TF
+        </div>
+        <div className="flex flex-1 items-center gap-1">
+          <span className="text-sm font-semibold text-foreground">
+            TaskFlow
+          </span>
+          <ChevronDown className="h-3.5 w-3.5 text-muted-foreground" />
+        </div>
+      </div>
+
+      <Separator />
+
+      {/* Command palette trigger */}
+      <div className="px-3 py-3">
+        <button
+          type="button"
+          className="flex w-full items-center gap-2 rounded-md border border-border bg-background px-3 py-1.5 text-sm text-muted-foreground transition-colors hover:border-foreground/20"
+        >
+          <Search className="h-3.5 w-3.5" />
+          <span className="flex-1 text-left">검색...</span>
+          <kbd className="rounded border border-border bg-muted px-1.5 py-0.5 text-[10px] font-medium">
+            /
+          </kbd>
+        </button>
+      </div>
+
+      {/* Navigation */}
+      <nav className="flex-1 space-y-1 px-3">
+        {navItems.map((item) => {
+          const isActive = pathname === item.href;
+          return (
+            <Link
+              key={item.href}
+              href={item.href}
+              className={cn(
+                "flex items-center gap-3 rounded-md px-3 py-2 text-sm transition-colors",
+                isActive
+                  ? "bg-accent/15 font-medium text-accent"
+                  : "text-muted-foreground hover:bg-muted hover:text-foreground",
+              )}
+            >
+              {item.icon}
+              <span className="flex-1">{item.label}</span>
+              {item.shortcut && (
+                <span className="text-[10px] text-muted-foreground/60">
+                  {item.shortcut}
+                </span>
+              )}
+            </Link>
+          );
+        })}
+      </nav>
+
+      <Separator />
+
+      {/* Bottom status */}
+      <div className="px-4 py-3">
+        <div className="flex items-center gap-2 text-xs text-muted-foreground">
+          <div className="h-2 w-2 rounded-full bg-green-500" />
+          <span>로컬 서버 연결됨</span>
+        </div>
+        <p className="mt-1 text-[10px] text-muted-foreground/60">
+          v0.1.0 &middot; 3 태스크 진행 중
+        </p>
+      </div>
+    </aside>
+  );
+}

package/src/components/ui/accordion.tsx

@@ -0,0 +1,58 @@
+"use client"
+
+import * as React from "react"
+import * as AccordionPrimitive from "@radix-ui/react-accordion"
+import { ChevronDown } from "lucide-react"
+
+import { cn } from "@/lib/utils"
+
+const Accordion = AccordionPrimitive.Root
+
+const AccordionItem = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Item>
+>(({ className, ...props }, ref) => (
+  <AccordionPrimitive.Item
+    ref={ref}
+    className={cn("border-b", className)}
+    {...props}
+  />
+))
+AccordionItem.displayName = "AccordionItem"
+
+const AccordionTrigger = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Trigger>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Trigger>
+>(({ className, children, ...props }, ref) => (
+  <AccordionPrimitive.Header className="flex">
+    <AccordionPrimitive.Trigger
+      ref={ref}
+      className={cn(
+        "flex flex-1 items-center justify-between py-4 font-medium transition-all hover:underline [&[data-state=open]>svg]:rotate-180",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <ChevronDown className="h-4 w-4 shrink-0 transition-transform duration-200" />
+    </AccordionPrimitive.Trigger>
+  </AccordionPrimitive.Header>
+))
+AccordionTrigger.displayName = AccordionPrimitive.Trigger.displayName
+
+const AccordionContent = React.forwardRef<
+  React.ElementRef<typeof AccordionPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof AccordionPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
+  <AccordionPrimitive.Content
+    ref={ref}
+    className="overflow-hidden text-sm transition-all data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down"
+    {...props}
+  >
+    <div className={cn("pb-4 pt-0", className)}>{children}</div>
+  </AccordionPrimitive.Content>
+))
+
+AccordionContent.displayName = AccordionPrimitive.Content.displayName
+
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent }

package/src/components/ui/avatar.tsx

@@ -0,0 +1,50 @@
+"use client"
+
+import * as React from "react"
+import * as AvatarPrimitive from "@radix-ui/react-avatar"
+
+import { cn } from "@/lib/utils"
+
+const Avatar = React.forwardRef<
+  React.ElementRef<typeof AvatarPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>
+>(({ className, ...props }, ref) => (
+  <AvatarPrimitive.Root
+    ref={ref}
+    className={cn(
+      "relative flex h-10 w-10 shrink-0 overflow-hidden rounded-full",
+      className
+    )}
+    {...props}
+  />
+))
+Avatar.displayName = AvatarPrimitive.Root.displayName
+
+const AvatarImage = React.forwardRef<
+  React.ElementRef<typeof AvatarPrimitive.Image>,
+  React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Image>
+>(({ className, ...props }, ref) => (
+  <AvatarPrimitive.Image
+    ref={ref}
+    className={cn("aspect-square h-full w-full", className)}
+    {...props}
+  />
+))
+AvatarImage.displayName = AvatarPrimitive.Image.displayName
+
+const AvatarFallback = React.forwardRef<
+  React.ElementRef<typeof AvatarPrimitive.Fallback>,
+  React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Fallback>
+>(({ className, ...props }, ref) => (
+  <AvatarPrimitive.Fallback
+    ref={ref}
+    className={cn(
+      "flex h-full w-full items-center justify-center rounded-full bg-muted",
+      className
+    )}
+    {...props}
+  />
+))
+AvatarFallback.displayName = AvatarPrimitive.Fallback.displayName
+
+export { Avatar, AvatarImage, AvatarFallback }

package/src/components/ui/badge.tsx

@@ -0,0 +1,36 @@
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const badgeVariants = cva(
+  "inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-hidden focus:ring-2 focus:ring-ring focus:ring-offset-2",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground hover:bg-primary/80",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        destructive:
+          "border-transparent bg-destructive text-destructive-foreground hover:bg-destructive/80",
+        outline: "text-foreground",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  },
+);
+
+export interface BadgeProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant, ...props }: BadgeProps) {
+  return (
+    <div className={cn(badgeVariants({ variant }), className)} {...props} />
+  );
+}
+
+export { Badge, badgeVariants };

package/src/components/ui/button.tsx

@@ -0,0 +1,56 @@
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-10 px-4 py-2",
+        sm: "h-9 rounded-md px-3",
+        lg: "h-11 rounded-md px-8",
+        icon: "h-10 w-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  },
+);
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean;
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button";
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    );
+  },
+);
+Button.displayName = "Button";
+
+export { Button, buttonVariants };

package/src/components/ui/card.tsx

@@ -0,0 +1,79 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+const Card = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "rounded-lg border bg-card text-card-foreground shadow-xs",
+      className
+    )}
+    {...props}
+  />
+))
+Card.displayName = "Card"
+
+const CardHeader = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex flex-col space-y-1.5 p-6", className)}
+    {...props}
+  />
+))
+CardHeader.displayName = "CardHeader"
+
+const CardTitle = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "text-2xl font-semibold leading-none tracking-tight",
+      className
+    )}
+    {...props}
+  />
+))
+CardTitle.displayName = "CardTitle"
+
+const CardDescription = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+))
+CardDescription.displayName = "CardDescription"
+
+const CardContent = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+))
+CardContent.displayName = "CardContent"
+
+const CardFooter = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex items-center p-6 pt-0", className)}
+    {...props}
+  />
+))
+CardFooter.displayName = "CardFooter"
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }

package/src/components/ui/checkbox.tsx

@@ -0,0 +1,30 @@
+"use client";
+
+import * as React from "react";
+import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
+import { Check } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+const Checkbox = React.forwardRef<
+  React.ElementRef<typeof CheckboxPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>
+>(({ className, ...props }, ref) => (
+  <CheckboxPrimitive.Root
+    ref={ref}
+    className={cn(
+      "peer h-4 w-4 shrink-0 rounded-sm border border-primary ring-offset-background focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground",
+      className,
+    )}
+    {...props}
+  >
+    <CheckboxPrimitive.Indicator
+      className={cn("flex items-center justify-center text-current")}
+    >
+      <Check className="h-4 w-4" />
+    </CheckboxPrimitive.Indicator>
+  </CheckboxPrimitive.Root>
+));
+Checkbox.displayName = CheckboxPrimitive.Root.displayName;
+
+export { Checkbox };