@dev-guard/cli 0.1.0

package/dist/project-identity.js

@@ -0,0 +1,93 @@
+import { createHash } from "node:crypto";
+import { resolve } from "node:path";
+import { fromRoot, readJsonFile, writeTextFile } from "./fs.js";
+import { getGitRemoteOrigin } from "./git.js";
+const identityPath = ".devguard/project-identity.json";
+export async function buildProjectIdentity(root, projectFiles = []) {
+    const absoluteRoot = resolve(root);
+    const [origin, packageJson] = await Promise.all([
+        getGitRemoteOrigin(root).catch(() => ""),
+        readJsonFile(fromRoot(root, "package.json"), {})
+    ]);
+    const frameworkKeywords = inferFrameworkKeywords(packageJson, projectFiles);
+    const fingerprint = createHash("sha256")
+        .update(JSON.stringify({
+        root: absoluteRoot,
+        origin,
+        packageName: packageJson.name ?? "",
+        frameworkKeywords
+    }))
+        .digest("hex")
+        .slice(0, 16);
+    return {
+        root: absoluteRoot,
+        gitRemoteOrigin: origin || undefined,
+        packageName: packageJson.name,
+        frameworkKeywords,
+        fingerprint
+    };
+}
+export async function writeProjectIdentity(root, identity) {
+    await writeTextFile(fromRoot(root, identityPath), `${JSON.stringify(identity, null, 2)}\n`);
+}
+export async function readStoredProjectIdentity(root) {
+    const identity = await readJsonFile(fromRoot(root, identityPath), undefined);
+    return identity?.fingerprint ? identity : undefined;
+}
+export async function loadCurrentProjectIdentity(root, projectFiles = []) {
+    return buildProjectIdentity(root, projectFiles);
+}
+export function sameProjectIdentity(current, stored) {
+    if (!stored) {
+        return false;
+    }
+    return current.fingerprint === stored.fingerprint && resolve(current.root) === resolve(stored.root);
+}
+export function formatProjectIdentityWarning(source, current, stored) {
+    if (!stored) {
+        return `${source} has no project identity; run dev-guard scan to refresh project memory.`;
+    }
+    return `${source} project identity mismatch; ignoring cached context (current=${current.fingerprint}, cached=${stored.fingerprint}).`;
+}
+function inferFrameworkKeywords(packageJson, projectFiles) {
+    const dependencyNames = new Set([
+        ...Object.keys(packageJson.dependencies ?? {}),
+        ...Object.keys(packageJson.devDependencies ?? {})
+    ]);
+    const keywords = new Set();
+    const dependencyKeywordMap = [
+        ["next", "next"],
+        ["react", "react"],
+        ["vite", "vite"],
+        ["vue", "vue"],
+        ["nuxt", "nuxt"],
+        ["svelte", "svelte"],
+        ["astro", "astro"],
+        ["@remix-run/react", "remix"],
+        ["tailwindcss", "tailwind"],
+        ["@supabase/supabase-js", "supabase"],
+        ["typescript", "typescript"]
+    ];
+    for (const [dependency, keyword] of dependencyKeywordMap) {
+        if (dependencyNames.has(dependency)) {
+            keywords.add(keyword);
+        }
+    }
+    const fileHints = [
+        [/^app\//, "app-router"],
+        [/^pages\//, "pages-router"],
+        [/^supabase\//, "supabase"],
+        [/tailwind\.config/i, "tailwind"],
+        [/vite\.config/i, "vite"],
+        [/next\.config/i, "next"]
+    ];
+    for (const file of projectFiles) {
+        for (const [pattern, keyword] of fileHints) {
+            if (pattern.test(file)) {
+                keywords.add(keyword);
+            }
+        }
+    }
+    return [...keywords].sort();
+}
+//# sourceMappingURL=project-identity.js.map

package/dist/project-identity.js.map

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

package/dist/project-memory.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectScanInputFile } from "@dev-guard/core";
+export declare function readScanInputFile(root: string, path: string): Promise<ProjectScanInputFile>;
+export declare function fileExists(root: string, path: string): Promise<boolean>;
+export declare function readFileHash(root: string, path: string): Promise<string>;

package/dist/project-memory.js

@@ -0,0 +1,32 @@
+import { createHash } from "node:crypto";
+import { access } from "node:fs/promises";
+import { fileMetadata, fromRoot, readTextFile } from "./fs.js";
+const maxScanFileCharacters = 20000;
+export async function readScanInputFile(root, path) {
+    const fullPath = fromRoot(root, path);
+    const [metadata, fullContent] = await Promise.all([fileMetadata(fullPath), readTextFile(fullPath)]);
+    const content = fullContent.slice(0, maxScanFileCharacters);
+    return {
+        path,
+        content,
+        size: metadata.size,
+        lastModified: metadata.lastModified,
+        hash: hashText(fullContent)
+    };
+}
+export async function fileExists(root, path) {
+    try {
+        await access(fromRoot(root, path));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readFileHash(root, path) {
+    return hashText(await readTextFile(fromRoot(root, path)));
+}
+function hashText(text) {
+    return createHash("sha256").update(text).digest("hex");
+}
+//# sourceMappingURL=project-memory.js.map

package/dist/project-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory.js","sourceRoot":"","sources":["../src/project-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY;IAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;IAE5D,OAAO;QACL,IAAI;QACJ,OAAO;QACP,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IAC3D,OAAO,QAAQ,CAAC,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1,13 @@
+interface PromptOptions {
+    copy: boolean;
+    compact: boolean;
+    ultraCompact: boolean;
+    density?: "ultra" | "compact" | "verbose";
+    includeContextFiles: boolean;
+    saveRun: boolean;
+    maxPromptTokens?: number;
+    output?: string;
+}
+export declare function runPrompt(root: string, options: PromptOptions): Promise<void>;
+export declare function parsePromptOptions(args: string[]): PromptOptions;
+export {};

package/dist/prompt.js

@@ -0,0 +1,125 @@
+import { buildImpactHints, filterDevGuardContextFiles, generateCodexPrompt } from "@dev-guard/core";
+import { copyTextToClipboard } from "./clipboard.js";
+import { fromRoot, readJsonFile, readTextFile, writeTextFile } from "./fs.js";
+import { getGitChanges } from "./git.js";
+import { loadCurrentProjectIdentity } from "./project-identity.js";
+import { filterRelevantMarkdown } from "./rule-filter.js";
+import { createRunLog, logRunSaved, upsertLatestRun } from "./runs.js";
+export async function runPrompt(root, options) {
+    const [gitChanges, task, rules, mistakes, projectState, decisions, identity, codeGraph] = await Promise.all([
+        getGitChanges(root),
+        readMarkdown(root, ".devguard/task.md"),
+        readMarkdown(root, ".devguard/rules.md"),
+        readMarkdown(root, ".devguard/mistakes.md"),
+        readMarkdown(root, "docs/PROJECT_STATE.md"),
+        readMarkdown(root, "docs/DECISIONS.md"),
+        loadCurrentProjectIdentity(root).catch(() => undefined),
+        readJsonFile(fromRoot(root, ".devguard/code-graph.json"), [])
+    ]);
+    const impactHints = buildImpactHints(gitChanges.changedFiles, codeGraph);
+    const missingFiles = [task, rules, mistakes, projectState, decisions].filter((result) => result.missing);
+    for (const file of missingFiles) {
+        console.error(`dev-guard warning: ${file.path} not found; using empty content.`);
+    }
+    const relevanceText = [task.content, gitChanges.changedFiles.join("\n"), projectState.content, decisions.content].join("\n");
+    const filteredRules = filterRelevantMarkdown(rules.content, relevanceText, identity);
+    const filteredMistakes = filterRelevantMarkdown(mistakes.content, relevanceText, identity);
+    const prompt = generateCodexPrompt({
+        taskMarkdown: task.content,
+        rulesMarkdown: filteredRules.filteredMarkdown,
+        mistakesMarkdown: filteredMistakes.filteredMarkdown,
+        projectStateMarkdown: projectState.content,
+        decisionsMarkdown: decisions.content,
+        changedFiles: gitChanges.changedFiles,
+        changeFiles: gitChanges.changeFiles,
+        diffText: gitChanges.diffText,
+        compact: options.compact,
+        ultraCompact: options.ultraCompact,
+        density: options.density,
+        maxPromptTokens: options.maxPromptTokens,
+        includeContextFiles: options.includeContextFiles,
+        impactHints
+    });
+    if (options.output) {
+        await writeTextFile(fromRoot(root, options.output), prompt.promptText);
+        console.error(`dev-guard prompt: wrote ${options.output}`);
+    }
+    if (options.copy) {
+        const result = await copyTextToClipboard(prompt.promptText);
+        if (result.ok) {
+            console.error("dev-guard prompt: copied to clipboard.");
+        }
+        else {
+            console.error(`dev-guard prompt: clipboard copy failed (${result.reason}). Printing prompt to stdout instead.`);
+        }
+    }
+    if (options.saveRun || options.copy || options.output) {
+        const save = options.saveRun ? createRunLog : upsertLatestRun;
+        const relatedChangeFiles = filterDevGuardContextFiles(gitChanges.changeFiles, options.includeContextFiles);
+        const relatedFiles = [...new Set(relatedChangeFiles.map((file) => file.path))].sort();
+        const run = await save(root, {
+            command: "prompt",
+            userRequest: options.saveRun ? "Generated Codex prompt from current dev-guard context." : undefined,
+            generatedTaskMarkdown: task.content,
+            generatedCodexPrompt: prompt.promptText,
+            relatedFiles,
+            changedFilesAtCreation: relatedFiles,
+            projectIdentity: identity,
+            status: "created"
+        });
+        logRunSaved(run);
+    }
+    console.log(prompt.promptText);
+}
+export function parsePromptOptions(args) {
+    const options = {
+        copy: args.includes("--copy"),
+        compact: true,
+        ultraCompact: args.includes("--ultra-compact"),
+        density: parseDensityOption(args),
+        includeContextFiles: args.includes("--include-context-files"),
+        saveRun: args.includes("--save-run"),
+        maxPromptTokens: parseNumberOption(args, "--max-prompt-tokens")
+    };
+    const outputIndex = args.indexOf("--output");
+    if (outputIndex >= 0) {
+        const output = args[outputIndex + 1];
+        if (!output || output.startsWith("--")) {
+            throw new Error("dev-guard prompt --output 옵션에는 파일 경로가 필요합니다.");
+        }
+        options.output = output;
+    }
+    return options;
+}
+function parseDensityOption(args) {
+    const index = args.indexOf("--density");
+    if (index < 0) {
+        return undefined;
+    }
+    const value = args[index + 1];
+    if (value !== "ultra" && value !== "compact" && value !== "verbose") {
+        throw new Error("dev-guard prompt --density 옵션은 ultra, compact, verbose 중 하나여야 합니다.");
+    }
+    return value;
+}
+function parseNumberOption(args, flag) {
+    const index = args.indexOf(flag);
+    if (index < 0) {
+        return undefined;
+    }
+    const value = Number(args[index + 1]);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`dev-guard prompt ${flag} 옵션에는 양수 값이 필요합니다.`);
+    }
+    return value;
+}
+async function readMarkdown(root, path) {
+    const sentinel = "\0__DEV_GUARD_MISSING__\0";
+    const content = await readTextFile(fromRoot(root, path), sentinel);
+    return {
+        path,
+        content: content === sentinel ? "" : content,
+        missing: content === sentinel
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/refresh.d.ts

@@ -0,0 +1,15 @@
+export interface RefreshOptions {
+    full: boolean;
+    ai: boolean;
+    dryRun: boolean;
+}
+export interface RefreshResult {
+    mode: "incremental" | "full";
+    ai: boolean;
+    dryRun: boolean;
+    updatedPaths: string[];
+    removedPaths: string[];
+    unchangedCount: number;
+}
+export declare function runRefresh(root: string, args: string[]): Promise<void>;
+export declare function refreshProjectMemory(root: string, options: RefreshOptions): Promise<RefreshResult>;

package/dist/refresh.js

@@ -0,0 +1,146 @@
+import { buildProjectScan, refreshProjectScan } from "@dev-guard/core";
+import { writeAIContext } from "./ai-context.js";
+import { loadConfig } from "./config.js";
+import { fileMetadata, fromRoot, readJsonFile, writeTextFile } from "./fs.js";
+import { getGitChanges, getProjectFiles } from "./git.js";
+import { fileExists, readFileHash, readScanInputFile } from "./project-memory.js";
+import { loadCurrentProjectIdentity, writeProjectIdentity } from "./project-identity.js";
+export async function runRefresh(root, args) {
+    const options = parseRefreshOptions(args);
+    const result = await refreshProjectMemory(root, options);
+    printRefreshPlan(result);
+}
+export async function refreshProjectMemory(root, options) {
+    const resolvedConfig = await loadConfig(root);
+    const config = resolvedConfig.config;
+    for (const warning of resolvedConfig.warnings) {
+        console.error(`dev-guard refresh: warning: ${warning}`);
+    }
+    const [existingIndex, existingSummaries, existingCodeGraph] = await Promise.all([
+        readJsonFile(fromRoot(root, ".devguard/project-index.json"), []),
+        readJsonFile(fromRoot(root, ".devguard/file-summaries.json"), []),
+        readJsonFile(fromRoot(root, ".devguard/code-graph.json"), [])
+    ]);
+    if (options.full || existingIndex.length === 0 || existingCodeGraph.length === 0) {
+        return runFullRefresh(root, options, config);
+    }
+    const [gitChanges, projectFiles] = await Promise.all([getGitChanges(root), getProjectFiles(root)]);
+    const projectFileSet = new Set(projectFiles);
+    const changedPaths = new Set();
+    const removedPaths = new Set();
+    for (const change of gitChanges.changeFiles) {
+        if (change.oldPath) {
+            removedPaths.add(change.oldPath);
+        }
+        if (change.status === "deleted") {
+            removedPaths.add(change.path);
+            continue;
+        }
+        if (projectFileSet.has(change.path)) {
+            changedPaths.add(change.path);
+        }
+    }
+    let unchangedCount = 0;
+    for (const entry of existingIndex) {
+        if (removedPaths.has(entry.path)) {
+            continue;
+        }
+        if (!(await fileExists(root, entry.path))) {
+            removedPaths.add(entry.path);
+            continue;
+        }
+        if (changedPaths.has(entry.path)) {
+            continue;
+        }
+        const metadata = await fileMetadata(fromRoot(root, entry.path));
+        const hash = await readFileHash(root, entry.path);
+        if (entry.lastModified !== metadata.lastModified || entry.hash !== hash) {
+            changedPaths.add(entry.path);
+        }
+        else {
+            unchangedCount += 1;
+        }
+    }
+    const updatedPaths = [...changedPaths].filter((path) => projectFileSet.has(path)).sort();
+    const removed = [...removedPaths].sort();
+    const result = {
+        mode: "incremental",
+        ai: options.ai && config.ai?.provider !== "none",
+        dryRun: options.dryRun,
+        updatedPaths,
+        removedPaths: removed,
+        unchangedCount
+    };
+    if (options.dryRun) {
+        return result;
+    }
+    const updatedFiles = await Promise.all(updatedPaths.map((path) => readScanInputFile(root, path)));
+    const refreshed = refreshProjectScan({
+        existingIndex,
+        existingSummaries,
+        existingCodeGraph,
+        updatedFiles,
+        removedPaths: removed
+    });
+    await writeMemoryFiles(root, refreshed.index, refreshed.summaries, refreshed.projectMapMarkdown, refreshed.codeGraph);
+    await writeAIContext(root).catch(() => undefined);
+    return result;
+}
+function parseRefreshOptions(args) {
+    return {
+        full: args.includes("--full"),
+        ai: args.includes("--ai"),
+        dryRun: args.includes("--dry-run")
+    };
+}
+async function runFullRefresh(root, options, config) {
+    const projectFiles = await getProjectFiles(root);
+    const inputFiles = await Promise.all(projectFiles.map((path) => readScanInputFile(root, path)));
+    const scan = buildProjectScan(inputFiles);
+    const result = {
+        mode: "full",
+        ai: options.ai && config.ai?.provider !== "none",
+        dryRun: options.dryRun,
+        updatedPaths: scan.index.map((entry) => entry.path),
+        removedPaths: [],
+        unchangedCount: 0
+    };
+    if (options.dryRun) {
+        return result;
+    }
+    await writeMemoryFiles(root, scan.index, scan.summaries, scan.projectMapMarkdown, scan.codeGraph);
+    await writeAIContext(root).catch(() => undefined);
+    return result;
+}
+async function writeMemoryFiles(root, index, summaries, projectMapMarkdown, codeGraph) {
+    const identity = await loadCurrentProjectIdentity(root, index.map((entry) => entry.path));
+    await Promise.all([
+        writeTextFile(fromRoot(root, ".devguard/project-index.json"), `${JSON.stringify(index, null, 2)}\n`),
+        writeTextFile(fromRoot(root, ".devguard/file-summaries.json"), `${JSON.stringify(summaries, null, 2)}\n`),
+        writeTextFile(fromRoot(root, ".devguard/code-graph.json"), `${JSON.stringify(codeGraph, null, 2)}\n`),
+        writeTextFile(fromRoot(root, ".devguard/project-map.md"), projectMapMarkdown),
+        writeProjectIdentity(root, identity)
+    ]);
+}
+function printRefreshPlan(plan) {
+    console.log("dev-guard refresh");
+    console.log(`- mode: ${plan.mode}`);
+    console.log(`- dry-run: ${plan.dryRun ? "yes" : "no"}`);
+    console.log(`- summaries: ${plan.ai ? "rule-based (AI summary hook reserved)" : "rule-based"}`);
+    console.log(`- updated summaries: ${plan.updatedPaths.length}`);
+    console.log(`- removed summaries: ${plan.removedPaths.length}`);
+    console.log(`- unchanged files skipped: ${plan.unchangedCount}`);
+    console.log("- writes: .devguard/project-index.json, .devguard/file-summaries.json, .devguard/code-graph.json, .devguard/project-map.md, .devguard/project-identity.json, .devguard/AI_CONTEXT.md");
+    console.log("- reason: keep project memory current for task-ai/review/report");
+    if (plan.updatedPaths.length > 0) {
+        console.log(`- updated files: ${plan.updatedPaths.join(", ")}`);
+    }
+    if (plan.removedPaths.length > 0) {
+        console.log(`- removed files: ${plan.removedPaths.join(", ")}`);
+    }
+    if (plan.updatedPaths.length === 0 && plan.removedPaths.length === 0) {
+        console.log("- skipped: no changed project files detected");
+    }
+    console.log("- next: run dev-guard check or dev-guard report");
+}
+//# sourceMappingURL=refresh.js.map

package/dist/refresh.js.map

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

package/dist/report.d.ts

@@ -0,0 +1 @@
+export declare function runReport(root: string, args: string[]): Promise<void>;

package/dist/report.js

@@ -0,0 +1,109 @@
+import { analyzeDiff, defaultConfig, filterDevGuardContextFiles, generateCompactReport } from "@dev-guard/core";
+import { copyTextToClipboard } from "./clipboard.js";
+import { fromRoot, readJsonFile, readTextFile } from "./fs.js";
+import { getCommitGitChanges, getGitChanges } from "./git.js";
+import { loadCurrentProjectIdentity } from "./project-identity.js";
+import { formatEffectiveTaskContext, resolveEffectiveTaskContext } from "./effective-task.js";
+export async function runReport(root, args) {
+    const options = parseReportOptions(args);
+    const [gitChanges, taskText, rulesText, config, codeGraph, currentIdentity] = await Promise.all([
+        options.since ? getCommitGitChanges(root, options.since) : getGitChanges(root),
+        readTextFile(fromRoot(root, ".devguard/task.md")),
+        readTextFile(fromRoot(root, ".devguard/rules.md")),
+        readJsonFile(fromRoot(root, ".devguard/config.json"), defaultConfig),
+        readJsonFile(fromRoot(root, ".devguard/code-graph.json"), []),
+        loadCurrentProjectIdentity(root).catch(() => undefined)
+    ]);
+    const reportChangeFiles = filterDevGuardContextFiles(gitChanges.changeFiles, false);
+    const changedFiles = [...new Set(reportChangeFiles.map((file) => file.path))].sort();
+    const effective = await resolveEffectiveTaskContext({
+        root,
+        taskMarkdown: taskText,
+        gitChanges: { diffText: gitChanges.diffText, changedFiles, changeFiles: reportChangeFiles },
+        changedFiles,
+        reviewChangeFiles: reportChangeFiles,
+        codeGraph,
+        currentIdentity
+    });
+    const effectiveTaskText = effective.effectiveTaskMarkdown;
+    const anchorMode = effective.useTaskMarkdown ? "task-first" : "diff-first";
+    const checkReport = analyzeDiff({
+        changedFiles: gitChanges.changedFiles,
+        changeFiles: gitChanges.changeFiles,
+        diffText: gitChanges.diffText,
+        taskText: effectiveTaskText,
+        rulesText,
+        config,
+        includeContextFiles: false
+    });
+    const report = generateCompactReport({
+        taskMarkdown: effectiveTaskText,
+        changedFiles,
+        checkReport,
+        runLog: effective.effectiveRunLog,
+        scanStale: false,
+        anchorMode
+    });
+    if (changedFiles.length > 0) {
+        for (const line of formatEffectiveTaskContext("dev-guard report", effective)) {
+            console.error(line);
+        }
+        if (effective.runSelection.warning) {
+            console.error(`dev-guard report: warning: ${effective.runSelection.warning}`);
+        }
+    }
+    const output = options.json ? `${JSON.stringify(report, null, 2)}\n` : options.compact ? formatCompactReport(report) : formatReport(report);
+    if (options.copy) {
+        const result = await copyTextToClipboard(output);
+        if (result.ok) {
+            console.error("dev-guard report: copied to clipboard.");
+        }
+        else {
+            console.error(`dev-guard report: clipboard copy failed (${result.reason}).`);
+        }
+    }
+    console.log(output.trimEnd());
+}
+function parseReportOptions(args) {
+    const sinceIndex = args.indexOf("--since");
+    const since = sinceIndex >= 0 ? args[sinceIndex + 1] : undefined;
+    if (sinceIndex >= 0 && (!since || since.startsWith("--"))) {
+        throw new Error("dev-guard report --since 옵션에는 기준 ref가 필요합니다.");
+    }
+    return {
+        compact: args.includes("--compact"),
+        copy: args.includes("--copy"),
+        json: args.includes("--json"),
+        since
+    };
+}
+function formatCompactReport(report) {
+    const changed = report.changedFiles.length > 0 ? report.changedFiles.slice(0, 5).join(", ") : "none";
+    const more = report.changedFiles.length > 5 ? ` (+${report.changedFiles.length - 5})` : "";
+    return [
+        `Task: ${report.task}`,
+        `Request: ${report.userRequest}`,
+        `Changed: ${changed}${more}`,
+        `Check: ${report.check}`,
+        `Review: ${report.review}`,
+        `Run: ${report.runId}`,
+        `Next: ${report.nextAction}`
+    ].join("\n");
+}
+function formatReport(report) {
+    return [
+        "dev-guard report",
+        "",
+        `Current task: ${report.task}`,
+        `User request: ${report.userRequest}`,
+        `Run id: ${report.runId}`,
+        "",
+        "Changed files:",
+        ...(report.changedFiles.length > 0 ? report.changedFiles.map((file) => `- ${file}`) : ["- none"]),
+        "",
+        `Check: ${report.check}`,
+        `Latest review: ${report.review}`,
+        `Suggested next action: ${report.nextAction}`
+    ].join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/review.d.ts

@@ -0,0 +1,2 @@
+export declare function runReview(root: string, args: string[]): Promise<void>;
+export declare function runFixPrompt(root: string, args: string[]): Promise<void>;