@dev-guard/cli 0.1.0

package/dist/infer-task.js

@@ -0,0 +1,120 @@
+import { formatInferredDiffIntentClusters, inferredIntentToRequirement } from "@dev-guard/core";
+import { writeAIContext } from "./ai-context.js";
+import { fromRoot, readJsonFile, readTextFile, writeTextFile } from "./fs.js";
+import { getGitChanges } from "./git.js";
+import { loadCurrentProjectIdentity } from "./project-identity.js";
+import { formatEffectiveTaskContext, resolveEffectiveTaskContext } from "./effective-task.js";
+export async function runInferTask(root, args) {
+    const options = parseInferTaskOptions(args);
+    const [gitChanges, taskMarkdown, codeGraph, currentIdentity] = await Promise.all([
+        getGitChanges(root),
+        readTextFile(fromRoot(root, ".devguard/task.md")),
+        readJsonFile(fromRoot(root, ".devguard/code-graph.json"), []),
+        loadCurrentProjectIdentity(root).catch(() => undefined)
+    ]);
+    if (gitChanges.changedFiles.length === 0) {
+        console.log("dev-guard infer-task");
+        console.log("");
+        console.log("no diff to infer task from: 변경 사항이 없습니다.");
+        return;
+    }
+    const effective = await resolveEffectiveTaskContext({
+        root,
+        taskMarkdown,
+        gitChanges,
+        codeGraph,
+        currentIdentity
+    });
+    const clusters = effective.inferredTask;
+    const intent = clusters.primaryIntent;
+    console.log("dev-guard infer-task");
+    console.log("");
+    for (const line of formatEffectiveTaskContext("dev-guard infer-task", effective)) {
+        console.log(line);
+    }
+    if (effective.runSelection.warning) {
+        console.log(`dev-guard infer-task: warning: ${effective.runSelection.warning}`);
+    }
+    console.log("");
+    const inferredMarkdown = buildInferredTaskMarkdown(intent, clusters, gitChanges.changedFiles);
+    console.log("Inferred Current Task:");
+    console.log(`- type: ${intent.type}`);
+    if (intent.subtype)
+        console.log(`- subtype: ${intent.subtype}`);
+    if (intent.targetCommand)
+        console.log(`- target: ${intent.targetCommand}`);
+    console.log(`- scope: ${intent.scope.join(", ") || gitChanges.changedFiles.slice(0, 3).join(", ")}`);
+    console.log(`- confidence: ${intent.confidence}`);
+    if (intent.evidence.length > 0) {
+        console.log(`- evidence: ${intent.evidence.slice(0, 3).join("; ")}`);
+    }
+    if (clusters.secondaryIntents.length > 0) {
+        console.log(`- clusters: ${formatInferredDiffIntentClusters(clusters)}`);
+    }
+    console.log("");
+    console.log("Changed files:");
+    for (const file of gitChanges.changedFiles.slice(0, 10)) {
+        console.log(`  - ${file}`);
+    }
+    if (gitChanges.changedFiles.length > 10) {
+        console.log(`  ... +${gitChanges.changedFiles.length - 10} more`);
+    }
+    if (options.write) {
+        const taskPath = fromRoot(root, ".devguard/task.md");
+        await writeTextFile(taskPath, inferredMarkdown);
+        await writeAIContext(root).catch(() => undefined);
+        console.log("");
+        console.log("[written] .devguard/task.md updated with inferred task.");
+        console.log("[written] .devguard/AI_CONTEXT.md updated.");
+    }
+    else {
+        console.log("");
+        if (effective.anchorStatus === "absent") {
+            console.log("task.md absent. Use --write to create from current diff:");
+        }
+        else if (!effective.useTaskMarkdown) {
+            console.log("task.md is not the active anchor. Use --write to replace with current diff:");
+        }
+        else {
+            console.log("Preview only. Use --write to replace .devguard/task.md:");
+        }
+        console.log("  dev-guard infer-task --write");
+    }
+}
+function parseInferTaskOptions(args) {
+    return { write: args.includes("--write") };
+}
+function buildInferredTaskMarkdown(intent, clusters, changedFiles) {
+    const scope = intent.scope.join(", ") || changedFiles.slice(0, 5).join(", ");
+    const requirement = inferredIntentToRequirement(intent);
+    const lines = [
+        "# Current Task",
+        "",
+        `> Auto-inferred from git diff by dev-guard infer-task`,
+        "",
+        "## Goal",
+        `- ${requirement}`,
+        "",
+        "## Task type",
+        `- type: ${intent.type}`,
+        intent.subtype ? `- subtype: ${intent.subtype}` : null,
+        intent.targetCommand ? `- target: ${intent.targetCommand}` : null,
+        `- confidence: ${intent.confidence}`,
+        `- scope: ${scope}`,
+        "",
+        "## Changed files",
+        ...changedFiles.slice(0, 15).map((file) => `- ${file}`),
+        changedFiles.length > 15 ? `- ... +${changedFiles.length - 15} more` : null,
+        "",
+        "## Allowed Paths",
+        ...changedFiles.slice(0, 8).map((file) => `- ${file}`),
+        "",
+        "## Out of Scope",
+        "- (inferred task — define scope manually if needed)",
+        "",
+        "## Diff clusters",
+        `- ${formatInferredDiffIntentClusters(clusters)}`
+    ];
+    return lines.filter((line) => line !== null).join("\n") + "\n";
+}
+//# sourceMappingURL=infer-task.js.map

package/dist/infer-task.js.map

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

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function runInit(root: string): Promise<void>;

package/dist/init.js

@@ -0,0 +1,50 @@
+import { configTemplate, currentTaskTemplate, decisionsTemplate, doNotRepeatTemplate, mistakesTemplate, projectStateTemplate, rulesTemplate, taskTemplate } from "@dev-guard/core";
+import { fromRoot, writeFileIfMissing } from "./fs.js";
+const initFiles = [
+    {
+        path: ".devguard/config.json",
+        content: `${JSON.stringify(configTemplate, null, 2)}\n`
+    },
+    {
+        path: ".devguard/task.md",
+        content: taskTemplate
+    },
+    {
+        path: ".devguard/rules.md",
+        content: rulesTemplate
+    },
+    {
+        path: ".devguard/mistakes.md",
+        content: mistakesTemplate
+    },
+    {
+        path: "docs/PROJECT_STATE.md",
+        content: projectStateTemplate
+    },
+    {
+        path: "docs/CURRENT_TASK.md",
+        content: currentTaskTemplate
+    },
+    {
+        path: "docs/DECISIONS.md",
+        content: decisionsTemplate
+    },
+    {
+        path: "docs/DO_NOT_REPEAT.md",
+        content: doNotRepeatTemplate
+    }
+];
+export async function runInit(root) {
+    const results = await Promise.all(initFiles.map(async (file) => {
+        const status = await writeFileIfMissing(fromRoot(root, file.path), file.content);
+        return { path: file.path, status };
+    }));
+    console.log("dev-guard init");
+    for (const result of results) {
+        const label = result.status === "created" ? "created" : "exists";
+        console.log(`- ${label}: ${result.path}`);
+    }
+    console.log("- write policy: existing files are preserved; missing files are created only");
+    console.log("- next: edit .devguard/task.md, then run dev-guard scan or dev-guard task-ai \"<requirement>\"");
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAOvD,MAAM,SAAS,GAAe;IAC5B;QACE,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;KACxD;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,YAAY;KACtB;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,aAAa;KACvB;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,gBAAgB;KAC1B;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,oBAAoB;KAC9B;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,mBAAmB;KAC7B;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,iBAAiB;KAC3B;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,mBAAmB;KAC7B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,8EAA8E,CAAC,CAAC;IAC5F,OAAO,CAAC,GAAG,CAAC,gGAAgG,CAAC,CAAC;AAChH,CAAC"}

package/dist/install-agent-instructions.d.ts

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

package/dist/install-agent-instructions.js

@@ -0,0 +1,113 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { devguardPaths } from "./paths.js";
+const SECTION_START = "<!-- dev-guard-section-start -->";
+const SECTION_END = "<!-- dev-guard-section-end -->";
+function agentsMdSection() {
+    return [
+        SECTION_START,
+        "",
+        "## Agent Instructions",
+        "",
+        "Before doing any work:",
+        "",
+        `1. Read \`${devguardPaths.agentContext}\``,
+        `2. Read \`${devguardPaths.projectHandoff}\``,
+        `3. Read \`${devguardPaths.qualityReport}\``,
+        "",
+        "Use dev-guard artifacts as the primary source of project context.",
+        "Do not perform repository-wide scans before reading them.",
+        "Only open additional files when required for the current task.",
+        "Continue from the latest dev-guard state.",
+        "",
+        SECTION_END
+    ].join("\n");
+}
+function claudeMdSection() {
+    return [
+        SECTION_START,
+        "",
+        "## Startup Instructions",
+        "",
+        "Always read the latest dev-guard context before exploring the repository.",
+        "",
+        "Required reading:",
+        "",
+        `* \`${devguardPaths.agentContext}\``,
+        `* \`${devguardPaths.projectHandoff}\``,
+        `* \`${devguardPaths.qualityReport}\``,
+        "",
+        "Avoid repository-wide scans unless the dev-guard context is insufficient.",
+        "Prefer continuing from dev-guard context rather than rediscovering project state.",
+        "",
+        SECTION_END
+    ].join("\n");
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function installSection(filePath, section, force) {
+    const exists = await fileExists(filePath);
+    if (!exists) {
+        await writeFile(filePath, section + "\n", "utf8");
+        return "created";
+    }
+    const existing = await readFile(filePath, "utf8");
+    const hasSection = existing.includes(SECTION_START) && existing.includes(SECTION_END);
+    if (hasSection) {
+        if (!force) {
+            return "already_installed";
+        }
+        const startIdx = existing.indexOf(SECTION_START);
+        const endIdx = existing.indexOf(SECTION_END) + SECTION_END.length;
+        const updated = existing.slice(0, startIdx) + section + existing.slice(endIdx);
+        await writeFile(filePath, updated, "utf8");
+        return "section_updated";
+    }
+    const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+    await writeFile(filePath, existing + separator + section + "\n", "utf8");
+    return "section_added";
+}
+function describeResult(result) {
+    switch (result) {
+        case "created":
+            return "created";
+        case "section_added":
+            return "dev-guard section added";
+        case "section_updated":
+            return "dev-guard section updated (--force)";
+        case "already_installed":
+            return "already installed (use --force to update)";
+    }
+}
+export async function runInstallAgentInstructions(root, args) {
+    const force = args.includes("--force");
+    const agentsMdPath = join(root, "AGENTS.md");
+    const claudeMdPath = join(root, "CLAUDE.md");
+    const [agentsResult, claudeResult] = await Promise.all([
+        installSection(agentsMdPath, agentsMdSection(), force),
+        installSection(claudeMdPath, claudeMdSection(), force)
+    ]);
+    console.log("dev-guard install-agent-instructions");
+    console.log("");
+    console.log(`AGENTS.md: ${describeResult(agentsResult)}`);
+    console.log(`CLAUDE.md: ${describeResult(claudeResult)}`);
+    if (agentsResult === "already_installed" || claudeResult === "already_installed") {
+        console.log("");
+        console.log("Note: use --force to update existing dev-guard sections");
+    }
+    console.log("");
+    console.log("Purpose:");
+    console.log("  These files suggest to agents that they should read dev-guard context");
+    console.log("  before exploring the repository. They are guidance, not enforced rules.");
+    console.log("");
+    console.log("Resume prompt for new sessions:");
+    console.log(`  Read ${devguardPaths.agentContext} and continue.`);
+}
+//# sourceMappingURL=install-agent-instructions.js.map

package/dist/install-agent-instructions.js.map

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

package/dist/migration.d.ts

@@ -0,0 +1,8 @@
+export interface LegacyMigrationResult {
+    action: "none" | "renamed" | "backup" | "warning";
+    message?: string;
+}
+export declare function migrateLegacyDevguardDir(root: string, options?: {
+    force?: boolean;
+}): Promise<LegacyMigrationResult>;
+export declare function legacyDevguardWarning(root: string): string | undefined;

package/dist/migration.js

@@ -0,0 +1,43 @@
+import { existsSync } from "node:fs";
+import { rename } from "node:fs/promises";
+import { fromRoot } from "./fs.js";
+import { DEVGUARD_DIR, LEGACY_DEVGUARD_DIR } from "./paths.js";
+export async function migrateLegacyDevguardDir(root, options = {}) {
+    const legacy = fromRoot(root, LEGACY_DEVGUARD_DIR);
+    const current = fromRoot(root, DEVGUARD_DIR);
+    const hasLegacy = existsSync(legacy);
+    const hasCurrent = existsSync(current);
+    if (!hasLegacy) {
+        return { action: "none" };
+    }
+    if (!hasCurrent) {
+        await rename(legacy, current);
+        return {
+            action: "renamed",
+            message: `Migrated legacy ${LEGACY_DEVGUARD_DIR}/ to ${DEVGUARD_DIR}/.`
+        };
+    }
+    if (options.force) {
+        const backupName = `${LEGACY_DEVGUARD_DIR}.backup-${timestampForPath()}`;
+        await rename(legacy, fromRoot(root, backupName));
+        return {
+            action: "backup",
+            message: `Legacy ${LEGACY_DEVGUARD_DIR}/ moved to ${backupName}/ because ${DEVGUARD_DIR}/ already exists.`
+        };
+    }
+    return {
+        action: "warning",
+        message: `Legacy ${LEGACY_DEVGUARD_DIR}/ directory detected. Recommended path is ${DEVGUARD_DIR}/. Move or back up legacy files before continuing.`
+    };
+}
+export function legacyDevguardWarning(root) {
+    if (existsSync(fromRoot(root, LEGACY_DEVGUARD_DIR))) {
+        return `Legacy ${LEGACY_DEVGUARD_DIR}/ directory detected. Recommended path is ${DEVGUARD_DIR}/. Run migration or move files before continuing.`;
+    }
+    return undefined;
+}
+function timestampForPath() {
+    const value = new Date().toISOString().replace(/[-:]/g, "").replace(/\..+$/, "");
+    return value.replace("T", "-");
+}
+//# sourceMappingURL=migration.js.map

package/dist/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAO/D,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAY,EAAE,UAA+B,EAAE;IAC5F,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,mBAAmB,mBAAmB,QAAQ,YAAY,IAAI;SACxE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,GAAG,mBAAmB,WAAW,gBAAgB,EAAE,EAAE,CAAC;QACzE,MAAM,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,UAAU,mBAAmB,cAAc,UAAU,aAAa,YAAY,mBAAmB;SAC3G,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,UAAU,mBAAmB,6CAA6C,YAAY,oDAAoD;KACpJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,UAAU,mBAAmB,6CAA6C,YAAY,mDAAmD,CAAC;IACnJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,38 @@
+export declare const DEVGUARD_DIR = ".devguard";
+export declare const LEGACY_DEVGUARD_DIR = "devguard";
+export declare const devguardPaths: {
+    readonly config: ".devguard/config.json";
+    readonly task: ".devguard/task.md";
+    readonly rules: ".devguard/rules.md";
+    readonly mistakes: ".devguard/mistakes.md";
+    readonly project: ".devguard/project.md";
+    readonly architecture: ".devguard/architecture.md";
+    readonly decisions: ".devguard/decisions.md";
+    readonly tasks: ".devguard/tasks.md";
+    readonly runtime: ".devguard/runtime.json";
+    readonly state: ".devguard/state.json";
+    readonly history: ".devguard/history.jsonl";
+    readonly hooksDir: ".devguard/hooks";
+    readonly logsDir: ".devguard/logs";
+    readonly reportsDir: ".devguard/reports";
+    readonly promptsDir: ".devguard/prompts";
+    readonly contextDir: ".devguard/context";
+    readonly claudeHook: ".devguard/hooks/claude-stop.sh";
+    readonly codexHook: ".devguard/hooks/codex-stop.sh";
+    readonly codexNotifyHook: ".devguard/hooks/codex-notify.sh";
+    readonly codexEventListener: ".devguard/hooks/codex-event-listener.ts";
+    readonly claudeLog: ".devguard/logs/claude-hook.log";
+    readonly codexLog: ".devguard/logs/codex-hook.log";
+    readonly codexNotifyLog: ".devguard/logs/codex-notify.log";
+    readonly watchLog: ".devguard/logs/watch.log";
+    readonly hookStatus: ".devguard/reports/hook-status.md";
+    readonly lastRunReport: ".devguard/reports/last-run.md";
+    readonly historySummary: ".devguard/reports/history-summary.md";
+    readonly decisionCandidates: ".devguard/reports/decision-candidates.md";
+    readonly qualityReport: ".devguard/reports/quality-report.md";
+    readonly projectHandoff: ".devguard/reports/project-handoff.md";
+    readonly nextCodexPrompt: ".devguard/prompts/next-codex-prompt.md";
+    readonly nextClaudePrompt: ".devguard/prompts/next-claude-prompt.md";
+    readonly agentContext: ".devguard/context/agent-context.md";
+};
+export declare function legacyDevguardPath(path?: string): string;

package/dist/paths.js

@@ -0,0 +1,41 @@
+export const DEVGUARD_DIR = ".devguard";
+export const LEGACY_DEVGUARD_DIR = "devguard";
+export const devguardPaths = {
+    config: `${DEVGUARD_DIR}/config.json`,
+    task: `${DEVGUARD_DIR}/task.md`,
+    rules: `${DEVGUARD_DIR}/rules.md`,
+    mistakes: `${DEVGUARD_DIR}/mistakes.md`,
+    project: `${DEVGUARD_DIR}/project.md`,
+    architecture: `${DEVGUARD_DIR}/architecture.md`,
+    decisions: `${DEVGUARD_DIR}/decisions.md`,
+    tasks: `${DEVGUARD_DIR}/tasks.md`,
+    runtime: `${DEVGUARD_DIR}/runtime.json`,
+    state: `${DEVGUARD_DIR}/state.json`,
+    history: `${DEVGUARD_DIR}/history.jsonl`,
+    hooksDir: `${DEVGUARD_DIR}/hooks`,
+    logsDir: `${DEVGUARD_DIR}/logs`,
+    reportsDir: `${DEVGUARD_DIR}/reports`,
+    promptsDir: `${DEVGUARD_DIR}/prompts`,
+    contextDir: `${DEVGUARD_DIR}/context`,
+    claudeHook: `${DEVGUARD_DIR}/hooks/claude-stop.sh`,
+    codexHook: `${DEVGUARD_DIR}/hooks/codex-stop.sh`,
+    codexNotifyHook: `${DEVGUARD_DIR}/hooks/codex-notify.sh`,
+    codexEventListener: `${DEVGUARD_DIR}/hooks/codex-event-listener.ts`,
+    claudeLog: `${DEVGUARD_DIR}/logs/claude-hook.log`,
+    codexLog: `${DEVGUARD_DIR}/logs/codex-hook.log`,
+    codexNotifyLog: `${DEVGUARD_DIR}/logs/codex-notify.log`,
+    watchLog: `${DEVGUARD_DIR}/logs/watch.log`,
+    hookStatus: `${DEVGUARD_DIR}/reports/hook-status.md`,
+    lastRunReport: `${DEVGUARD_DIR}/reports/last-run.md`,
+    historySummary: `${DEVGUARD_DIR}/reports/history-summary.md`,
+    decisionCandidates: `${DEVGUARD_DIR}/reports/decision-candidates.md`,
+    qualityReport: `${DEVGUARD_DIR}/reports/quality-report.md`,
+    projectHandoff: `${DEVGUARD_DIR}/reports/project-handoff.md`,
+    nextCodexPrompt: `${DEVGUARD_DIR}/prompts/next-codex-prompt.md`,
+    nextClaudePrompt: `${DEVGUARD_DIR}/prompts/next-claude-prompt.md`,
+    agentContext: `${DEVGUARD_DIR}/context/agent-context.md`
+};
+export function legacyDevguardPath(path = "") {
+    return path ? `${LEGACY_DEVGUARD_DIR}/${path}` : LEGACY_DEVGUARD_DIR;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,GAAG,YAAY,cAAc;IACrC,IAAI,EAAE,GAAG,YAAY,UAAU;IAC/B,KAAK,EAAE,GAAG,YAAY,WAAW;IACjC,QAAQ,EAAE,GAAG,YAAY,cAAc;IACvC,OAAO,EAAE,GAAG,YAAY,aAAa;IACrC,YAAY,EAAE,GAAG,YAAY,kBAAkB;IAC/C,SAAS,EAAE,GAAG,YAAY,eAAe;IACzC,KAAK,EAAE,GAAG,YAAY,WAAW;IACjC,OAAO,EAAE,GAAG,YAAY,eAAe;IACvC,KAAK,EAAE,GAAG,YAAY,aAAa;IACnC,OAAO,EAAE,GAAG,YAAY,gBAAgB;IACxC,QAAQ,EAAE,GAAG,YAAY,QAAQ;IACjC,OAAO,EAAE,GAAG,YAAY,OAAO;IAC/B,UAAU,EAAE,GAAG,YAAY,UAAU;IACrC,UAAU,EAAE,GAAG,YAAY,UAAU;IACrC,UAAU,EAAE,GAAG,YAAY,UAAU;IACrC,UAAU,EAAE,GAAG,YAAY,uBAAuB;IAClD,SAAS,EAAE,GAAG,YAAY,sBAAsB;IAChD,eAAe,EAAE,GAAG,YAAY,wBAAwB;IACxD,kBAAkB,EAAE,GAAG,YAAY,gCAAgC;IACnE,SAAS,EAAE,GAAG,YAAY,uBAAuB;IACjD,QAAQ,EAAE,GAAG,YAAY,sBAAsB;IAC/C,cAAc,EAAE,GAAG,YAAY,wBAAwB;IACvD,QAAQ,EAAE,GAAG,YAAY,iBAAiB;IAC1C,UAAU,EAAE,GAAG,YAAY,yBAAyB;IACpD,aAAa,EAAE,GAAG,YAAY,sBAAsB;IACpD,cAAc,EAAE,GAAG,YAAY,6BAA6B;IAC5D,kBAAkB,EAAE,GAAG,YAAY,iCAAiC;IACpE,aAAa,EAAE,GAAG,YAAY,4BAA4B;IAC1D,cAAc,EAAE,GAAG,YAAY,6BAA6B;IAC5D,eAAe,EAAE,GAAG,YAAY,+BAA+B;IAC/D,gBAAgB,EAAE,GAAG,YAAY,gCAAgC;IACjE,YAAY,EAAE,GAAG,YAAY,2BAA2B;CAChD,CAAC;AAEX,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAG,EAAE;IAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,mBAAmB,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACvE,CAAC"}

package/dist/project-detection.d.ts

@@ -0,0 +1,10 @@
+export interface ProjectDetectionSummary {
+    packageName: string;
+    packageManager: string;
+    language: string;
+    runtime: string;
+    frameworks: string[];
+    markdownFiles: string[];
+    contextCandidates: string[];
+}
+export declare function detectProject(root: string, projectFiles: string[]): Promise<ProjectDetectionSummary>;

package/dist/project-detection.js

@@ -0,0 +1,144 @@
+import { readdir } from "node:fs/promises";
+import { fromRoot, readJsonFile } from "./fs.js";
+import { fileExists } from "./project-memory.js";
+const contextCandidateFiles = [
+    "AGENTS.md",
+    "CLAUDE.md",
+    "README.md",
+    ".devguard/task.md",
+    ".devguard/rules.md",
+    ".devguard/mistakes.md",
+    "docs/PROJECT_STATE.md",
+    "docs/CURRENT_TASK.md",
+    "docs/DECISIONS.md",
+    "docs/DO_NOT_REPEAT.md"
+];
+export async function detectProject(root, projectFiles) {
+    const packageJson = await readJsonFile(fromRoot(root, "package.json"), {});
+    const [packageManager, rootMarkdownFiles, contextCandidates] = await Promise.all([
+        detectPackageManager(root, packageJson),
+        detectRootMarkdownFiles(root, projectFiles),
+        detectContextCandidates(root)
+    ]);
+    return {
+        packageName: packageJson.name ?? "(unknown)",
+        packageManager,
+        language: inferLanguage(packageJson, projectFiles),
+        runtime: inferRuntime(packageJson, projectFiles),
+        frameworks: inferFrameworks(packageJson, projectFiles),
+        markdownFiles: rootMarkdownFiles,
+        contextCandidates
+    };
+}
+async function detectPackageManager(root, packageJson) {
+    if (packageJson.packageManager) {
+        return packageJson.packageManager;
+    }
+    if (await fileExists(root, "pnpm-lock.yaml")) {
+        return "pnpm";
+    }
+    if (await fileExists(root, "yarn.lock")) {
+        return "yarn";
+    }
+    if (await fileExists(root, "package-lock.json")) {
+        return "npm";
+    }
+    if (await fileExists(root, "bun.lockb")) {
+        return "bun";
+    }
+    return "(unknown)";
+}
+async function detectRootMarkdownFiles(root, projectFiles) {
+    const markdown = new Set(projectFiles.filter((file) => /\.md$/i.test(file)));
+    try {
+        const entries = await readdir(root, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && /\.md$/i.test(entry.name)) {
+                markdown.add(entry.name);
+            }
+        }
+    }
+    catch {
+        // Best-effort summary only.
+    }
+    return [...markdown].sort();
+}
+async function detectContextCandidates(root) {
+    const existing = await Promise.all(contextCandidateFiles.map(async (path) => ((await fileExists(root, path)) ? path : undefined)));
+    return existing.filter((path) => Boolean(path));
+}
+function inferFrameworks(packageJson, projectFiles) {
+    const dependencies = new Set([
+        ...Object.keys(packageJson.dependencies ?? {}),
+        ...Object.keys(packageJson.devDependencies ?? {})
+    ]);
+    const frameworks = new Set();
+    const dependencyHints = [
+        ["next", "nextjs"],
+        ["react", "react"],
+        ["vite", "vite"],
+        ["vue", "vue"],
+        ["nuxt", "nuxt"],
+        ["svelte", "svelte"],
+        ["astro", "astro"],
+        ["@remix-run/react", "remix"],
+        ["tailwindcss", "tailwind"],
+        ["@supabase/supabase-js", "supabase"],
+        ["express", "express"],
+        ["fastify", "fastify"],
+        ["@nestjs/core", "nest"],
+        ["turbo", "turborepo"],
+        ["typescript", "typescript"]
+    ];
+    for (const [dependency, label] of dependencyHints) {
+        if (dependencies.has(dependency)) {
+            frameworks.add(label);
+        }
+    }
+    if (projectFiles.some((file) => file.startsWith("app/"))) {
+        frameworks.add("app-router");
+    }
+    if (projectFiles.some((file) => file.startsWith("pages/"))) {
+        frameworks.add("pages-router");
+    }
+    if (projectFiles.some((file) => file === "turbo.json")) {
+        frameworks.add("turborepo");
+    }
+    if (projectFiles.some((file) => file === "pubspec.yaml" || file.startsWith("lib/") && file.endsWith(".dart"))) {
+        frameworks.add("flutter");
+    }
+    return [...frameworks].sort();
+}
+function inferLanguage(packageJson, projectFiles) {
+    const dependencies = new Set([...Object.keys(packageJson.dependencies ?? {}), ...Object.keys(packageJson.devDependencies ?? {})]);
+    if (dependencies.has("typescript") || projectFiles.some((file) => /\.(ts|tsx)$/.test(file))) {
+        return "typescript";
+    }
+    if (projectFiles.some((file) => /\.(js|jsx|mjs|cjs)$/.test(file))) {
+        return "javascript";
+    }
+    if (projectFiles.some((file) => /\.py$/.test(file) || file === "pyproject.toml" || file === "requirements.txt")) {
+        return "python";
+    }
+    if (projectFiles.some((file) => /\.dart$/.test(file) || file === "pubspec.yaml")) {
+        return "dart";
+    }
+    return "(unknown)";
+}
+function inferRuntime(packageJson, projectFiles) {
+    const dependencies = new Set([...Object.keys(packageJson.dependencies ?? {}), ...Object.keys(packageJson.devDependencies ?? {})]);
+    if (dependencies.has("next")) {
+        return "node/nextjs";
+    }
+    if (dependencies.has("express") || dependencies.has("fastify") || dependencies.has("@nestjs/core") || projectFiles.some((file) => file === "package.json")) {
+        return "node";
+    }
+    if (projectFiles.some((file) => /\.py$/.test(file) || file === "pyproject.toml" || file === "requirements.txt")) {
+        return "python";
+    }
+    if (projectFiles.some((file) => file === "pubspec.yaml")) {
+        return "flutter";
+    }
+    return "(unknown)";
+}
+//# sourceMappingURL=project-detection.js.map

package/dist/project-detection.js.map

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

package/dist/project-identity.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectIdentity } from "@dev-guard/core";
+export declare function buildProjectIdentity(root: string, projectFiles?: string[]): Promise<ProjectIdentity>;
+export declare function writeProjectIdentity(root: string, identity: ProjectIdentity): Promise<void>;
+export declare function readStoredProjectIdentity(root: string): Promise<ProjectIdentity | undefined>;
+export declare function loadCurrentProjectIdentity(root: string, projectFiles?: string[]): Promise<ProjectIdentity>;
+export declare function sameProjectIdentity(current: ProjectIdentity, stored: ProjectIdentity | undefined): boolean;
+export declare function formatProjectIdentityWarning(source: string, current: ProjectIdentity, stored: ProjectIdentity | undefined): string;