@reqord/cli 0.1.0

package/dist/services/validation-service.test.js

@@ -0,0 +1,136 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { validateRequirement } from "./validation-service.js";
+// Mock the repository module
+vi.mock("../repositories/requirement.js", () => ({
+    findById: vi.fn(),
+    findByIdOrThrow: vi.fn(),
+    loadDescription: vi.fn(),
+    findAll: vi.fn(),
+}));
+import * as reqRepo from "../repositories/requirement.js";
+function makeRequirement(overrides = {}) {
+    return {
+        id: "req-000001",
+        version: "1.0.0",
+        title: "テスト要件タイトル",
+        status: "draft",
+        priority: "medium",
+        createdAt: "2026-01-01T00:00:00Z",
+        updatedAt: "2026-01-01T00:00:00Z",
+        versionHistory: [],
+        files: { description: "requirements/req-000001/description.md", supplementary: [] },
+        successCriteria: [
+            "基準1: ユーザーがログインできる",
+            "基準2: セッションが24時間有効である",
+            "基準3: ログアウト後にセッションが無効になる",
+        ],
+        format: { type: "user-story", userStory: { as: "ユーザー", iWant: "ログインしたい", soThat: "利用できる" } },
+        dependencies: { blockedBy: [], blocks: [], relatedTo: [] },
+        estimatedComplexity: "medium",
+        estimatedHours: 16,
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    vi.resetAllMocks();
+});
+describe("validateRequirement", () => {
+    it("存在しない要件でエラーを投げる", async () => {
+        vi.mocked(reqRepo.findByIdOrThrow).mockRejectedValue(new Error("Requirement req-999999 not found."));
+        await expect(validateRequirement("/cwd", "req-999999")).rejects.toThrow("Requirement req-999999 not found.");
+    });
+    it("有効な要件でvalid=trueを返す", async () => {
+        const req = makeRequirement();
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue("## 概要\n\n詳細な説明文です。");
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.valid).toBe(true);
+        expect(result.id).toBe("req-000001");
+        expect(result.smartScore).toBeDefined();
+        expect(result.metadata.criteriaCount).toBe(3);
+        expect(result.metadata.hasDescription).toBe(true);
+        expect(result.metadata.hasDependencyIssues).toBe(false);
+    });
+    it("成功基準が0件の場合、error issueが含まれvalid=false", async () => {
+        const req = makeRequirement({ successCriteria: [] });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.type === "missing_criteria" && i.severity === "error")).toBe(true);
+    });
+    it("成功基準が2件の場合、warning issueが含まれる", async () => {
+        const req = makeRequirement({
+            successCriteria: ["基準1", "基準2"],
+        });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.issues.some((i) => i.type === "insufficient_criteria" && i.severity === "warning")).toBe(true);
+    });
+    it("成功基準が8件の場合、excessive warning", async () => {
+        const req = makeRequirement({
+            successCriteria: ["1", "2", "3", "4", "5", "6", "7", "8"],
+        });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.issues.some((i) => i.type === "excessive_criteria")).toBe(true);
+    });
+    it("曖昧表現を検出する", async () => {
+        const req = makeRequirement({
+            title: "適切にデータを処理する",
+            successCriteria: ["なるべく高速に処理される"],
+        });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        const ambiguousIssues = result.issues.filter((i) => i.type === "ambiguous");
+        expect(ambiguousIssues.length).toBeGreaterThanOrEqual(2);
+    });
+    it("存在しない依存先を検出する", async () => {
+        const req = makeRequirement({
+            dependencies: { blockedBy: ["req-999999"], blocks: [], relatedTo: [] },
+        });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.type === "invalid_dependency")).toBe(true);
+        expect(result.metadata.hasDependencyIssues).toBe(true);
+    });
+    it("循環依存を検出する", async () => {
+        const req1 = makeRequirement({
+            id: "req-000001",
+            dependencies: { blockedBy: ["req-000002"], blocks: [], relatedTo: [] },
+        });
+        const req2 = makeRequirement({
+            id: "req-000002",
+            dependencies: { blockedBy: ["req-000001"], blocks: [], relatedTo: [] },
+        });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req1);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req1, req2]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.valid).toBe(false);
+        expect(result.issues.some((i) => i.type === "circular_dependency")).toBe(true);
+    });
+    it("複雑度と見積もりの不整合を検出する", async () => {
+        const req = makeRequirement({
+            estimatedComplexity: "small",
+            estimatedHours: 100,
+        });
+        vi.mocked(reqRepo.findByIdOrThrow).mockResolvedValue(req);
+        vi.mocked(reqRepo.loadDescription).mockResolvedValue(null);
+        vi.mocked(reqRepo.findAll).mockResolvedValue([req]);
+        const result = await validateRequirement("/cwd", "req-000001");
+        expect(result.issues.some((i) => i.type === "inconsistent_estimate")).toBe(true);
+    });
+});
+//# sourceMappingURL=validation-service.test.js.map

package/dist/services/validation-service.test.js.map

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

package/dist/services/version-service.d.ts

@@ -0,0 +1,85 @@
+import type { Requirement, Specification, Status, VersionHistoryEntry } from "@reqord/shared";
+/**
+ * Parse X.Y version string into components
+ */
+export declare function parseVersion(version: string): {
+    major: number;
+    minor: number;
+};
+/**
+ * Format version components into X.Y version string
+ */
+export declare function formatVersion(major: number, minor: number): string;
+/**
+ * Apply explicit version bump to a version string
+ *
+ * In X.Y format:
+ * - "major": X.0 (breaking changes, major feature additions)
+ * - "patch": .Y (all other changes, equivalent to MINOR+PATCH in semver)
+ *
+ * @param currentVersion - Current version in X.Y format
+ * @param bumpType - Type of version bump to apply
+ * @returns New version string in X.Y format
+ */
+export declare function applyVersionBump(currentVersion: string, bumpType: "major" | "patch"): string;
+/**
+ * Determine next version based on changes between requirements
+ *
+ * Version is always preserved here. Version changes are handled
+ * explicitly by the reqord req draft command.
+ *
+ * @param before - Previous requirement state
+ * @param _after - New requirement state (unused, version changes are explicit)
+ * @returns The preserved version from before
+ */
+export declare function determineNextVersion(before: Requirement, _after: Requirement): string;
+/**
+ * Minimal interface for creating version history entries.
+ * Accepts both Requirement and Specification objects.
+ */
+interface Versionable {
+    version: string;
+    status: Status;
+}
+/**
+ * Create version history entry
+ */
+export declare function createHistoryEntry(source: Versionable, options?: {
+    summary?: string;
+}): VersionHistoryEntry;
+/**
+ * Get allowed state transitions map
+ */
+export declare function getStateTransitions(): Map<Status, Status[]>;
+/**
+ * Check if status transition is valid
+ */
+export declare function isValidTransition(from: Status, to: Status): boolean;
+/**
+ * Determine if requirement should revert to draft due to content changes
+ */
+export declare function shouldRevertToDraft(currentStatus: Status, hasContentChanges: boolean): boolean;
+/**
+ * Generate change summary from requirement differences
+ */
+export declare function generateChangeSummary(before: Requirement, after: Requirement): string;
+/**
+ * Determine next version based on changes between specifications
+ *
+ * Version is always preserved here. Version changes are handled
+ * explicitly by the reqord spec draft command.
+ *
+ * @param before - Previous specification state
+ * @param _after - New specification state (unused, version changes are explicit)
+ * @returns The preserved version from before
+ */
+export declare function determineNextVersionForSpec(before: Specification, _after: Specification): string;
+/**
+ * Generate change summary from specification differences
+ *
+ * Note: Status changes are NOT included here to prevent duplicate messages,
+ * as they are already handled by the caller (specification-service.ts).
+ */
+export declare function generateSpecChangeSummary(before: Specification, after: Specification): string;
+export {};
+//# sourceMappingURL=version-service.d.ts.map

package/dist/services/version-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-service.d.ts","sourceRoot":"","sources":["../../src/services/version-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAY9F;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAS9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,OAAO,GAAG,OAAO,GAC1B,MAAM,CAQR;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAErF;AAED;;;GAGG;AACH,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,mBAAmB,CAkBrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAO3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAInE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CA4BrF;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAkB7F"}

package/dist/services/version-service.js

@@ -0,0 +1,184 @@
+/**
+ * Compare two values for equality, using JSON serialization for objects
+ */
+function hasChanged(before, after) {
+    if (typeof before === "object" || typeof after === "object") {
+        return JSON.stringify(before) !== JSON.stringify(after);
+    }
+    return before !== after;
+}
+/**
+ * Parse X.Y version string into components
+ */
+export function parseVersion(version) {
+    const match = version.match(/^(\d+)\.(\d+)$/);
+    if (!match) {
+        throw new Error(`Invalid version format: ${version}. Must be X.Y format`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+    };
+}
+/**
+ * Format version components into X.Y version string
+ */
+export function formatVersion(major, minor) {
+    return `${major}.${minor}`;
+}
+/**
+ * Apply explicit version bump to a version string
+ *
+ * In X.Y format:
+ * - "major": X.0 (breaking changes, major feature additions)
+ * - "patch": .Y (all other changes, equivalent to MINOR+PATCH in semver)
+ *
+ * @param currentVersion - Current version in X.Y format
+ * @param bumpType - Type of version bump to apply
+ * @returns New version string in X.Y format
+ */
+export function applyVersionBump(currentVersion, bumpType) {
+    const { major, minor } = parseVersion(currentVersion);
+    switch (bumpType) {
+        case "major":
+            return formatVersion(major + 1, 0);
+        case "patch":
+            return formatVersion(major, minor + 1);
+    }
+}
+/**
+ * Determine next version based on changes between requirements
+ *
+ * Version is always preserved here. Version changes are handled
+ * explicitly by the reqord req draft command.
+ *
+ * @param before - Previous requirement state
+ * @param _after - New requirement state (unused, version changes are explicit)
+ * @returns The preserved version from before
+ */
+export function determineNextVersion(before, _after) {
+    return before.version;
+}
+/**
+ * Create version history entry
+ */
+export function createHistoryEntry(source, options) {
+    const now = new Date().toISOString();
+    const summary = options?.summary ?? "Updated";
+    const entry = {
+        version: source.version,
+        status: source.status,
+        changedAt: now,
+        summary,
+    };
+    // Add approval metadata if status is approved
+    if (source.status === "approved") {
+        entry.approvedAt = now;
+        entry.approvedBy = [];
+    }
+    return entry;
+}
+/**
+ * Get allowed state transitions map
+ */
+export function getStateTransitions() {
+    return new Map([
+        ["draft", ["approved"]],
+        ["approved", ["implemented", "draft"]],
+        ["implemented", ["draft"]],
+        ["deprecated", []],
+    ]);
+}
+/**
+ * Check if status transition is valid
+ */
+export function isValidTransition(from, to) {
+    const transitions = getStateTransitions();
+    const allowedTransitions = transitions.get(from) ?? [];
+    return allowedTransitions.includes(to);
+}
+/**
+ * Determine if requirement should revert to draft due to content changes
+ */
+export function shouldRevertToDraft(currentStatus, hasContentChanges) {
+    return (currentStatus === "approved" || currentStatus === "implemented") && hasContentChanges;
+}
+/**
+ * Generate change summary from requirement differences
+ */
+export function generateChangeSummary(before, after) {
+    const changes = [];
+    if (hasChanged(before.status, after.status)) {
+        changes.push(`Status changed from ${before.status} to ${after.status}`);
+    }
+    if (hasChanged(before.title, after.title)) {
+        changes.push("Title updated");
+    }
+    if (hasChanged(before.format, after.format)) {
+        changes.push("Format updated");
+    }
+    if (hasChanged(before.dependencies, after.dependencies)) {
+        changes.push("Dependencies updated");
+    }
+    if (hasChanged(before.successCriteria, after.successCriteria)) {
+        changes.push("Success criteria updated");
+    }
+    if (hasChanged(before.priority, after.priority)) {
+        changes.push("Priority updated");
+    }
+    return changes.length > 0 ? changes.join(", ") : "Requirement updated";
+}
+/**
+ * Count supplementary file differences between two Specification snapshots
+ */
+function countSupplementaryDiff(before, after) {
+    const beforeSet = new Set(before.files.supplementary);
+    const afterSet = new Set(after.files.supplementary);
+    let added = 0;
+    for (const file of afterSet) {
+        if (!beforeSet.has(file)) {
+            added++;
+        }
+    }
+    let removed = 0;
+    for (const file of beforeSet) {
+        if (!afterSet.has(file)) {
+            removed++;
+        }
+    }
+    return { added, removed };
+}
+/**
+ * Determine next version based on changes between specifications
+ *
+ * Version is always preserved here. Version changes are handled
+ * explicitly by the reqord spec draft command.
+ *
+ * @param before - Previous specification state
+ * @param _after - New specification state (unused, version changes are explicit)
+ * @returns The preserved version from before
+ */
+export function determineNextVersionForSpec(before, _after) {
+    return before.version;
+}
+/**
+ * Generate change summary from specification differences
+ *
+ * Note: Status changes are NOT included here to prevent duplicate messages,
+ * as they are already handled by the caller (specification-service.ts).
+ */
+export function generateSpecChangeSummary(before, after) {
+    const changes = [];
+    const { added, removed } = countSupplementaryDiff(before, after);
+    if (added > 0) {
+        changes.push(`${added} supplementary file(s) added`);
+    }
+    if (removed > 0) {
+        changes.push(`${removed} supplementary file(s) removed`);
+    }
+    if (before.files.design !== after.files.design) {
+        changes.push("Design file path updated");
+    }
+    return changes.length > 0 ? changes.join(", ") : "Specification updated";
+}
+//# sourceMappingURL=version-service.js.map

package/dist/services/version-service.js.map

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

package/dist/services/version-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=version-service.test.d.ts.map

package/dist/services/version-service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-service.test.d.ts","sourceRoot":"","sources":["../../src/services/version-service.test.ts"],"names":[],"mappings":""}