@dev-guard/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 everyshare
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+# dev-guard CLI
+
+`dev-guard` is a local CLI guardrail for Codex / Claude coding workflows. It watches project changes, processes completed work, and generates quality reports plus handoff prompts under `.devguard/`.
+
+## Install Or Update
+
+```bash
+npm install -g @dev-guard/cli@latest
+dev-guard --help
+```
+
+Run without a global install:
+
+```bash
+npx @dev-guard/cli --help
+```
+
+## Initial Setup
+
+Run from your project root:
+
+```bash
+dev-guard init
+dev-guard install-agent-instructions
+dev-guard install-hooks
+dev-guard status
+```
+
+## GPT Setup
+
+The default `watch`, `done`, `status`, and `handoff` workflow does not require GPT/API setup. Configure an OpenAI provider only for AI-assisted commands such as `review`, `task-ai`, and `prompt`.
+
+```bash
+export OPENAI_API_KEY="your_api_key"
+dev-guard configure ai --provider openai --model gpt-4o-mini
+dev-guard config show
+```
+
+Do not store API keys in project files.
+
+## Agent Instruction Files
+
+`dev-guard install-agent-instructions` creates or updates `AGENTS.md` and `CLAUDE.md` with instructions to read:
+
+- `.devguard/context/agent-context.md`
+- `.devguard/reports/project-handoff.md`
+- `.devguard/reports/quality-report.md`
+
+This keeps new Codex / Claude sessions aligned with the latest dev-guard state before broad repository exploration.
+
+## Daily CLI Flow
+
+```bash
+dev-guard watch
+# Codex/Claude edits files; verified hook/notify runs dev-guard done
+dev-guard status
+```
+
+Manual fallback:
+
+```bash
+dev-guard watch --manual
+dev-guard done
+dev-guard status
+```
+
+Resume a new session:
+
+```bash
+dev-guard handoff
+cat .devguard/reports/project-handoff.md
+```
+
+Full documentation:
+
+- Korean npm guide: https://github.com/projectbom/dev-guard/blob/main/docs/npm-setup.ko.md
+- English npm guide: https://github.com/projectbom/dev-guard/blob/main/docs/npm-setup.md
+- Repository README: https://github.com/projectbom/dev-guard
+

package/dist/agent-strategies.d.ts

@@ -0,0 +1,23 @@
+export type AgentStrategyName = "claude-stop-hook" | "codex-notify" | "codex-stop-hook" | "codex-jsonl-listener" | "manual";
+export interface AgentStrategyStatus {
+    name: AgentStrategyName;
+    agent: "Claude Code" | "Codex" | "Manual";
+    available: boolean;
+    installed: boolean;
+    scriptVerified: boolean;
+    runtimeVerified: boolean;
+    requiresUserTrust: boolean;
+    recommended: boolean;
+    next: string;
+}
+export interface AgentStrategyReport {
+    strategies: AgentStrategyStatus[];
+    claude: AgentStrategyStatus;
+    codexNotify: AgentStrategyStatus;
+    codexStopHook: AgentStrategyStatus;
+    codexJsonlListener: AgentStrategyStatus;
+    manual: AgentStrategyStatus;
+}
+export declare function getAgentStrategyReport(root: string): Promise<AgentStrategyReport>;
+export declare function formatStrategyFlag(value: boolean): string;
+export declare function pathExists(root: string, path: string): Promise<boolean>;

package/dist/agent-strategies.js

@@ -0,0 +1,130 @@
+import { constants, existsSync } from "node:fs";
+import { access, stat } from "node:fs/promises";
+import { spawnSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fromRoot, readTextFile } from "./fs.js";
+import { getHookStatus, hookConfigPaths } from "./hooks.js";
+import { devguardPaths } from "./paths.js";
+import { getCodexNotifyConfigStatus } from "./codex-notify.js";
+const codexUserConfigPath = join(homedir(), ".codex", "config.toml");
+export async function getAgentStrategyReport(root) {
+    const hookStatus = await getHookStatus(root);
+    const [claudeScriptVerified, codexStopScriptVerified, codexNotifyScriptVerified, codexJsonlScriptVerified] = await Promise.all([
+        isExecutable(root, devguardPaths.claudeHook),
+        isExecutable(root, devguardPaths.codexHook),
+        isExecutable(root, devguardPaths.codexNotifyHook),
+        isExecutable(root, devguardPaths.codexEventListener)
+    ]);
+    const codexNotifyInstalled = await isCodexNotifyConfigured(root);
+    const codexNotifyConfig = await getCodexNotifyConfigStatus();
+    const codexNotifyRuntimeVerified = await hasFinalLogLine(root, devguardPaths.codexNotifyLog, /hook=codex\.notify status=success\b.*source=agent_runtime\b/);
+    const codexJsonlRuntimeVerified = await hasFinalLogLine(root, devguardPaths.codexLog, /hook=codex\.turn\.completed status=success\b/);
+    const claudeInstalled = hookStatus.claudeInstalled && hookStatus.claudeHookFile;
+    const codexStopInstalled = hookStatus.codexInstalled && hookStatus.codexHookFile;
+    const codexCliAvailable = commandAvailable("codex");
+    const claudeRuntimeVerified = await hasFinalLogLine(root, devguardPaths.claudeLog, /hook=claude\.stop status=success\b/);
+    const codexStopRuntimeVerified = await hasFinalLogLine(root, devguardPaths.codexLog, /hook=codex\.stop status=success\b.*source=agent_runtime\b/);
+    const claude = {
+        name: "claude-stop-hook",
+        agent: "Claude Code",
+        available: commandAvailable("claude") || existsSync(fromRoot(root, hookConfigPaths.claudeSettingsPath)),
+        installed: claudeInstalled,
+        scriptVerified: claudeScriptVerified,
+        runtimeVerified: claudeRuntimeVerified,
+        requiresUserTrust: false,
+        recommended: true,
+        next: claudeRuntimeVerified ? "Claude Stop Hook runtime verified." : "Run Claude Code in this repo and check .devguard/logs/claude-hook.log."
+    };
+    const codexNotify = {
+        name: "codex-notify",
+        agent: "Codex",
+        available: codexCliAvailable,
+        installed: codexNotifyInstalled || codexNotifyConfig.notifyIsDispatcher,
+        scriptVerified: codexNotifyScriptVerified,
+        runtimeVerified: codexNotifyRuntimeVerified,
+        requiresUserTrust: false,
+        recommended: true,
+        next: codexNotifyConfig.existingNotifyDetected
+            ? "Existing Codex notify detected. Run dev-guard install-hooks --agent codex-notify --install-dispatcher."
+            : codexNotifyInstalled || codexNotifyConfig.notifyIsDispatcher
+                ? "Run a Codex turn and check .devguard/logs/codex-notify.log."
+                : "Configure user-level ~/.codex/config.toml notify to call .devguard/hooks/codex-notify.sh."
+    };
+    const codexStopHook = {
+        name: "codex-stop-hook",
+        agent: "Codex",
+        available: codexCliAvailable,
+        installed: codexStopInstalled,
+        scriptVerified: codexStopScriptVerified,
+        runtimeVerified: codexStopRuntimeVerified,
+        requiresUserTrust: true,
+        recommended: false,
+        next: codexStopRuntimeVerified ? "Codex Stop Hook runtime verified." : "Open Codex TUI in this repo and run /hooks to review/trust the Stop Hook."
+    };
+    const codexJsonlListener = {
+        name: "codex-jsonl-listener",
+        agent: "Codex",
+        available: codexCliAvailable,
+        installed: existsSync(fromRoot(root, devguardPaths.codexEventListener)),
+        scriptVerified: codexJsonlScriptVerified,
+        runtimeVerified: codexJsonlRuntimeVerified,
+        requiresUserTrust: false,
+        recommended: false,
+        next: "Use codex exec --json ... | .devguard/hooks/codex-event-listener.ts for non-interactive runs."
+    };
+    const manual = {
+        name: "manual",
+        agent: "Manual",
+        available: true,
+        installed: true,
+        scriptVerified: true,
+        runtimeVerified: true,
+        requiresUserTrust: false,
+        recommended: false,
+        next: "Run dev-guard done when the agent task finishes."
+    };
+    return {
+        strategies: [claude, codexNotify, codexStopHook, codexJsonlListener, manual],
+        claude,
+        codexNotify,
+        codexStopHook,
+        codexJsonlListener,
+        manual
+    };
+}
+export function formatStrategyFlag(value) {
+    return value ? "yes" : "no";
+}
+async function isCodexNotifyConfigured(root) {
+    const text = await readTextFile(codexUserConfigPath);
+    if (!text)
+        return false;
+    return text.includes(fromRoot(root, devguardPaths.codexNotifyHook)) || text.includes(devguardPaths.codexNotifyHook);
+}
+async function hasFinalLogLine(root, path, pattern) {
+    const text = await readTextFile(fromRoot(root, path));
+    return text.split(/\r?\n/).some((line) => pattern.test(line));
+}
+async function isExecutable(root, path) {
+    try {
+        await access(fromRoot(root, path), constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function commandAvailable(command) {
+    return spawnSync("sh", ["-c", `command -v ${command}`], { encoding: "utf8" }).status === 0;
+}
+export async function pathExists(root, path) {
+    try {
+        await stat(fromRoot(root, path));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=agent-strategies.js.map

package/dist/agent-strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-strategies.js","sourceRoot":"","sources":["../src/agent-strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAyB/D,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,wBAAwB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7H,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC;QAC5C,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC;QAC3C,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC;QACjD,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC;KACrD,CAAC,CAAC;IACH,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,iBAAiB,GAAG,MAAM,0BAA0B,EAAE,CAAC;IAC7D,MAAM,0BAA0B,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,cAAc,EAAE,6DAA6D,CAAC,CAAC;IAC5J,MAAM,yBAAyB,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,8CAA8C,CAAC,CAAC;IACtI,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,IAAI,UAAU,CAAC,cAAc,CAAC;IAChF,MAAM,kBAAkB,GAAG,UAAU,CAAC,cAAc,IAAI,UAAU,CAAC,aAAa,CAAC;IACjF,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEpD,MAAM,qBAAqB,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAC;IACzH,MAAM,wBAAwB,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,2DAA2D,CAAC,CAAC;IAElJ,MAAM,MAAM,GAAwB;QAClC,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;QACvG,SAAS,EAAE,eAAe;QAC1B,cAAc,EAAE,oBAAoB;QACpC,eAAe,EAAE,qBAAqB;QACtC,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,wEAAwE;KAC9I,CAAC;IAEF,MAAM,WAAW,GAAwB;QACvC,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,oBAAoB,IAAI,iBAAiB,CAAC,kBAAkB;QACvE,cAAc,EAAE,yBAAyB;QACzC,eAAe,EAAE,0BAA0B;QAC3C,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,IAAI;QACjB,IAAI,EAAE,iBAAiB,CAAC,sBAAsB;YAC5C,CAAC,CAAC,wGAAwG;YAC1G,CAAC,CAAC,oBAAoB,IAAI,iBAAiB,CAAC,kBAAkB;gBAC9D,CAAC,CAAC,6DAA6D;gBAC/D,CAAC,CAAC,2FAA2F;KAChG,CAAC;IAEF,MAAM,aAAa,GAAwB;QACzC,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,kBAAkB;QAC7B,cAAc,EAAE,uBAAuB;QACvC,eAAe,EAAE,wBAAwB;QACzC,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,KAAK;QAClB,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,2EAA2E;KACnJ,CAAC;IAEF,MAAM,kBAAkB,GAAwB;QAC9C,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;QACvE,cAAc,EAAE,wBAAwB;QACxC,eAAe,EAAE,yBAAyB;QAC1C,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,KAAK;QAClB,IAAI,EAAE,+FAA+F;KACtG,CAAC;IAEF,MAAM,MAAM,GAAwB;QAClC,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,KAAK;QAClB,IAAI,EAAE,kDAAkD;KACzD,CAAC;IAEF,OAAO;QACL,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,CAAC;QAC5E,MAAM;QACN,WAAW;QACX,aAAa;QACb,kBAAkB;QAClB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,IAAY;IACjD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;AACtH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;IACxE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,OAAO,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,IAAY;IACzD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/ai-context.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generates and writes .devguard/AI_CONTEXT.md.
+ * Called after refresh, infer-task --write, and task-ai --write.
+ * Silent on error to avoid breaking the main workflow.
+ */
+export declare function writeAIContext(root: string): Promise<void>;
+/**
+ * Short preamble prepended to Codex/Claude prompts so they know to read AI_CONTEXT.md first.
+ */
+export declare function buildAIContextPreamble(): string;

package/dist/ai-context.js

@@ -0,0 +1,143 @@
+import { filterDevGuardContextFiles, inferDiffIntentClusters, scoreTaskAnchorFreshness } from "@dev-guard/core";
+import { fromRoot, readJsonFile, readTextFile, writeTextFile } from "./fs.js";
+import { getGitChanges } from "./git.js";
+/**
+ * Generates and writes .devguard/AI_CONTEXT.md.
+ * Called after refresh, infer-task --write, and task-ai --write.
+ * Silent on error to avoid breaking the main workflow.
+ */
+export async function writeAIContext(root) {
+    const [gitChanges, taskMarkdown, codeGraph] = await Promise.all([
+        getGitChanges(root),
+        readTextFile(fromRoot(root, ".devguard/task.md")),
+        readJsonFile(fromRoot(root, ".devguard/code-graph.json"), [])
+    ]);
+    const changeFiles = filterDevGuardContextFiles(gitChanges.changeFiles, false);
+    const changedFiles = [...new Set(changeFiles.map((f) => f.path))].sort();
+    const anchor = scoreTaskAnchorFreshness({
+        taskMarkdown,
+        diffText: gitChanges.diffText,
+        changedFiles,
+        changeFiles
+    });
+    const clusters = changedFiles.length > 0
+        ? inferDiffIntentClusters({ changedFiles, changeFiles, diffText: gitChanges.diffText, codeGraph })
+        : null;
+    const content = generateAIContextMarkdown({ anchor, clusters, changedFiles, taskMarkdown });
+    await writeTextFile(fromRoot(root, ".devguard/AI_CONTEXT.md"), content);
+}
+/**
+ * Short preamble prepended to Codex/Claude prompts so they know to read AI_CONTEXT.md first.
+ */
+export function buildAIContextPreamble() {
+    return "Start by reading `.devguard/AI_CONTEXT.md` for task anchor and project context.\n\n---\n\n";
+}
+function generateAIContextMarkdown(input) {
+    const { anchor, clusters, changedFiles } = input;
+    const now = new Date().toISOString();
+    const anchorStatus = anchor.mode === "anchor_absent"
+        ? "absent"
+        : anchor.mode === "stale"
+            ? `stale (match score: ${anchor.matchScore})`
+            : anchor.mode === "uncertain"
+                ? `uncertain (match score: ${anchor.matchScore})`
+                : `fresh (match score: ${anchor.matchScore})`;
+    const anchorMode = anchor.mode === "anchor_absent" || anchor.mode === "stale" ? "diff-first" : "task-first";
+    const taskSection = buildTaskSection(anchor, clusters, input.taskMarkdown);
+    const changedSection = changedFiles.length > 0
+        ? [
+            ...changedFiles.slice(0, 12).map((f) => `- ${f}`),
+            ...(changedFiles.length > 12 ? [`- ... +${changedFiles.length - 12} more`] : [])
+        ].join("\n")
+        : "- (no current changes)";
+    const readFirst = [
+        "- `.devguard/project-map.md` — project structure overview",
+        "- `.devguard/file-summaries.json` — per-file roles and keywords",
+        ...(anchorMode === "task-first"
+            ? ["- `.devguard/task.md` — current task specification", "- `docs/CURRENT_TASK.md` — task history (if relevant)"]
+            : [])
+    ].join("\n");
+    return [
+        "# dev-guard AI Context",
+        `Generated: ${now}`,
+        "",
+        "Start here before scanning the full project.",
+        "",
+        "## Task Anchor",
+        `- status: ${anchorStatus}`,
+        `- mode: ${anchorMode}`,
+        "",
+        "## Current Task",
+        taskSection,
+        "",
+        "## Changed Files",
+        changedSection,
+        "",
+        "## Read First",
+        readFirst,
+        "",
+        "## Use If Needed",
+        "- `.devguard/code-graph.json` — import/export graph",
+        "- `docs/PROJECT_STATE.md` — project state",
+        "- `docs/DECISIONS.md` — past decisions",
+        "- `docs/DO_NOT_REPEAT.md` — mistakes to avoid",
+        "",
+        "## AI Rules",
+        "- Do not scan the whole project directory first.",
+        "- Use current git diff as source of truth when task anchor is absent or stale.",
+        "- Open targeted files only — use project-map + file-summaries for discovery.",
+        "- Verify stale context before trusting it.",
+        "- When task.md is fresh, treat it as the authoritative task specification.",
+        ""
+    ].join("\n");
+}
+function buildTaskSection(anchor, clusters, taskMarkdown) {
+    if (anchor.mode === "anchor_absent") {
+        if (!clusters)
+            return "- (no diff to infer from)";
+        const intent = clusters.primaryIntent;
+        return [
+            `- type: ${intent.type}`,
+            intent.subtype ? `- subtype: ${intent.subtype}` : "",
+            intent.targetCommand ? `- target: ${intent.targetCommand}` : "",
+            `- scope: ${intent.scope.join(", ") || "changed files"}`,
+            `- confidence: ${intent.confidence}`,
+            "- source: inferred from diff (task anchor absent)"
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }
+    if (anchor.mode === "stale") {
+        if (!clusters)
+            return "- (task.md stale, no diff)";
+        const intent = clusters.primaryIntent;
+        return [
+            `- type: ${intent.type}`,
+            intent.subtype ? `- subtype: ${intent.subtype}` : "",
+            `- scope: ${intent.scope.join(", ") || "changed files"}`,
+            `- confidence: ${intent.confidence}`,
+            anchor.taskType ? `- task.md type (stale): ${anchor.taskType}` : "",
+            "- source: inferred from diff (task.md stale)"
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }
+    // uncertain or use_task
+    const goalLine = extractTaskGoalLine(taskMarkdown);
+    return [
+        anchor.taskType ? `- type: ${anchor.taskType}` : "",
+        goalLine ? `- goal: ${goalLine}` : "",
+        anchor.mode === "uncertain"
+            ? `- note: task.md uncertain (match score ${anchor.matchScore}), verify before trusting`
+            : "",
+        "- source: task.md"
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function extractTaskGoalLine(markdown) {
+    const match = markdown.match(/^##\s+목표\s*\n[-•]\s+(.+)/m) ??
+        markdown.match(/^##\s+Goal\s*\n[-•]\s+(.+)/im);
+    return match?.[1]?.trim().slice(0, 120);
+}
+//# sourceMappingURL=ai-context.js.map

package/dist/ai-context.js.map

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

package/dist/check.d.ts

@@ -0,0 +1,6 @@
+interface CheckOptions {
+    includeContextFiles: boolean;
+    local?: boolean;
+}
+export declare function runCheck(root: string, options: CheckOptions): Promise<void>;
+export {};

package/dist/check.js

@@ -0,0 +1,89 @@
+import { analyzeDiff, analyzeGeneratedDiffDrift } from "@dev-guard/core";
+import { recordDriftTelemetry } from "./drift-telemetry.js";
+import { fromRoot, readJsonFile, readTextFile } from "./fs.js";
+import { getGitChanges, hasGitBaseline } from "./git.js";
+import { loadConfig } from "./config.js";
+export async function runCheck(root, options) {
+    const [gitChanges, taskText, rulesText, resolvedConfig, baseline, codeGraph] = await Promise.all([
+        getGitChanges(root),
+        readTextFile(fromRoot(root, ".devguard/task.md")),
+        readTextFile(fromRoot(root, ".devguard/rules.md")),
+        loadConfig(root),
+        hasGitBaseline(root),
+        readJsonFile(fromRoot(root, ".devguard/code-graph.json"), [])
+    ]);
+    const report = analyzeDiff({
+        changedFiles: gitChanges.changedFiles,
+        changeFiles: gitChanges.changeFiles,
+        diffText: gitChanges.diffText,
+        taskText,
+        rulesText,
+        config: resolvedConfig.config,
+        includeContextFiles: options.includeContextFiles,
+        codeGraph
+    });
+    await recordDriftTelemetry(root, {
+        result: analyzeGeneratedDiffDrift({
+            requirementText: taskText,
+            taskMarkdown: taskText,
+            diffText: gitChanges.diffText,
+            changedFiles: report.changedFiles,
+            changeFiles: report.changeFiles
+        }),
+        source: "check:local",
+        subtype: taskText.match(/subtype:\s*([a-z_.]+)/i)?.[1]
+    }).catch((error) => console.error(`dev-guard check: telemetry warning: ${errorMessage(error)}`));
+    printReport(report, { mode: options.local ? "local heuristic" : "local heuristic", configSource: resolvedConfig.source, baseline });
+}
+function printReport(report, meta) {
+    console.log("dev-guard check");
+    console.log(`Mode: ${meta.mode}`);
+    console.log(`Config Source: ${meta.configSource}`);
+    if (!meta.baseline) {
+        console.log("Git baseline: none");
+        console.log("No git baseline found. Initial/untracked files can make check output noisy.");
+        console.log('Run: git add . && git commit -m "initial commit"');
+    }
+    console.log("");
+    console.log("Changed files:");
+    if (report.changeFiles.length === 0) {
+        console.log("- none");
+    }
+    else {
+        printChangeSection("Working tree", report.changeFiles.filter((file) => file.source === "workingTree"));
+        printChangeSection("Staged", report.changeFiles.filter((file) => file.source === "staged"));
+        printChangeSection("Untracked", report.changeFiles.filter((file) => file.source === "untracked"));
+    }
+    console.log("");
+    console.log("Findings:");
+    if (report.findings.length === 0) {
+        console.log("- no warnings");
+    }
+    else {
+        for (const finding of report.findings) {
+            const prefix = finding.severity === "warning" ? "warning" : "info";
+            console.log(`- [${prefix}] ${finding.title}`);
+            console.log(`  ${finding.message}`);
+            if (finding.files && finding.files.length > 0) {
+                console.log(`  files: ${finding.files.join(", ")}`);
+            }
+        }
+    }
+    console.log("");
+    console.log(`Docs update needed: ${report.docsUpdateNeeded ? "yes" : "no"}`);
+}
+function printChangeSection(title, files) {
+    console.log(`${title}:`);
+    if (files.length === 0) {
+        console.log("- none");
+        return;
+    }
+    for (const file of files) {
+        const rename = file.oldPath ? ` from ${file.oldPath}` : "";
+        console.log(`- ${file.path} (${file.status}${rename})`);
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/clipboard.d.ts

@@ -0,0 +1,6 @@
+export declare function copyTextToClipboard(text: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+}>;

package/dist/clipboard.js

@@ -0,0 +1,43 @@
+import { spawn } from "node:child_process";
+export async function copyTextToClipboard(text) {
+    const command = clipboardCommand();
+    if (!command) {
+        return { ok: false, reason: "unsupported OS clipboard command" };
+    }
+    try {
+        await writeToCommand(command.command, command.args, text);
+        return { ok: true };
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        return { ok: false, reason };
+    }
+}
+function writeToCommand(command, args, input) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: ["pipe", "ignore", "pipe"] });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(stderr.trim() || `${command} exited with code ${code}`));
+        });
+        child.stdin.end(input);
+    });
+}
+function clipboardCommand() {
+    if (process.platform === "darwin") {
+        return { command: "pbcopy", args: [] };
+    }
+    if (process.platform === "win32") {
+        return { command: "clip", args: [] };
+    }
+    return { command: "wl-copy", args: [] };
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IACnE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,IAAc,EAAE,KAAa;IACpE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1E,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC1C,CAAC"}

package/dist/codex-notify.d.ts

@@ -0,0 +1,23 @@
+export interface CodexNotifyConfigStatus {
+    configPath: string;
+    dispatcherPath: string;
+    dispatcherInstalled: boolean;
+    notify?: string[];
+    notifyConfigured: boolean;
+    notifyIsDispatcher: boolean;
+    existingNotifyDetected: boolean;
+}
+export interface InstallCodexNotifyDispatcherResult {
+    changed: boolean;
+    backupPath?: string;
+    dispatcherPath: string;
+    message: string;
+}
+export declare const codexNotifyConfigPath: string;
+export declare const codexNotifyDispatcherPath: string;
+export declare const codexNotifyDispatcherLogPath: string;
+export declare function getCodexNotifyConfigStatus(): Promise<CodexNotifyConfigStatus>;
+export declare function installCodexNotifyDispatcher(options?: {
+    force?: boolean;
+}): Promise<InstallCodexNotifyDispatcherResult>;
+export declare function formatNotifyCommand(command: string[] | undefined): string;