aidflow 1.0.0

package/dist/tools/session/handler.js

@@ -0,0 +1,185 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { isInitialized, getConfig, getWorkspaceRoot } from "../../context/workspace.js";
+import { createSession, listSessions, getMeta, archiveSession, findActiveSession, getPlanProgress, sessionExists, } from "../../context/session.js";
+import { createWorktree, getChangedFiles, getGitDiffStat } from "../../worktree/manager.js";
+export async function handleSession(input) {
+    if (!isInitialized()) {
+        return "devpilot is not initialized. Run `init` first.";
+    }
+    switch (input.action) {
+        case "create":
+            return handleCreate(input);
+        case "list":
+            return handleList();
+        case "status":
+            return handleStatus(input);
+        case "complete":
+            return handleComplete(input);
+    }
+}
+function handleCreate(input) {
+    if (!input.name) {
+        return "Session name is required for create action.";
+    }
+    if (sessionExists(input.name)) {
+        return `Session "${input.name}" already exists. Choose a different name or complete the existing one.`;
+    }
+    const config = getConfig();
+    const useWorktree = input.worktree ?? config.worktree.auto;
+    let worktreeInfo;
+    let worktreeWarning;
+    if (useWorktree) {
+        try {
+            worktreeInfo = createWorktree(input.name);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            worktreeWarning = `Worktree creation failed: ${msg}`;
+        }
+    }
+    const meta = createSession(input.name, worktreeInfo);
+    const lines = [
+        `Session "${meta.name}" created.`,
+        `Path: .devpilot/sessions/${meta.name}/`,
+    ];
+    if (worktreeWarning) {
+        lines.push(`Warning: ${worktreeWarning} (proceeding without worktree)`);
+    }
+    else if (worktreeInfo) {
+        lines.push(`Worktree: ${worktreeInfo.path} (branch: ${worktreeInfo.branch})`);
+    }
+    const hasSpec = existsSync(join(getWorkspaceRoot(), "SPEC.md"));
+    lines.push("");
+    if (hasSpec) {
+        lines.push("Read SPEC.md first for project conventions and engineering foundations.");
+    }
+    else {
+        lines.push("**No SPEC.md found.** Use AskUserQuestion to ask the user:", "\"SPEC.md (project engineering foundations) does not exist yet. Run /spec first, or proceed without it?\"");
+    }
+    lines.push("Use `plan create` if you need upfront planning.", "Run `session complete` when done.");
+    return lines.join("\n");
+}
+function handleList() {
+    const sessions = listSessions();
+    if (sessions.length === 0) {
+        return "No active sessions. Create one with `session create`.";
+    }
+    const activeSessions = sessions.filter((s) => s.status === "active");
+    const lines = [`Sessions (${sessions.length} total, ${activeSessions.length} active):\n`];
+    for (const session of sessions) {
+        const plan = getPlanProgress(session.name);
+        const wt = session.worktree?.enabled ? " (worktree)" : "";
+        const status = session.status === "active" ? "[active]" : "[completed]";
+        lines.push(`- **${session.name}** ${status}${wt}`);
+        lines.push(`  Created: ${session.created_at}`);
+        if (plan.exists) {
+            lines.push(`  Plan: ${plan.completed}/${plan.total} items`);
+        }
+        lines.push("");
+    }
+    if (activeSessions.length > 0) {
+        lines.push("To resume an active session, run `session status` to see full details and continue working.");
+    }
+    return lines.join("\n");
+}
+function handleStatus(input) {
+    let name = input.name;
+    if (!name) {
+        const active = findActiveSession();
+        if (!active) {
+            const sessions = listSessions();
+            if (sessions.length === 0) {
+                return "No active sessions.";
+            }
+            return `Multiple active sessions found. Specify a name:\n${sessions.map((s) => `- ${s.name}`).join("\n")}`;
+        }
+        name = active.name;
+    }
+    const meta = getMeta(name);
+    const plan = getPlanProgress(name);
+    const changedFiles = getChangedFiles(name);
+    const diffStat = getGitDiffStat(name);
+    const lines = [
+        `Session: **${meta.name}**`,
+        `Status: ${meta.status}`,
+        `Created: ${meta.created_at}`,
+    ];
+    if (meta.worktree?.enabled) {
+        lines.push(`Worktree: ${meta.worktree.path} (${meta.worktree.branch})`);
+    }
+    if (plan.exists) {
+        lines.push(`\nPlan: ${plan.completed}/${plan.total} items completed`);
+        lines.push(`Plan file: .devpilot/sessions/${name}/plan.md (read for full context)`);
+        const remaining = plan.items.filter((item) => !item.completed);
+        if (remaining.length > 0) {
+            lines.push("Remaining:");
+            remaining.slice(0, 5).forEach((item) => lines.push(`  - ${item.text}`));
+            if (remaining.length > 5) {
+                lines.push(`  ... and ${remaining.length - 5} more`);
+            }
+        }
+    }
+    else {
+        lines.push("\nNo plan found. Use `plan create` if needed, or continue working directly.");
+    }
+    if (changedFiles.length > 0) {
+        lines.push(`\nChanged files (${changedFiles.length}):`);
+        changedFiles.slice(0, 10).forEach((f) => lines.push(`  - ${f}`));
+        if (changedFiles.length > 10) {
+            lines.push(`  ... and ${changedFiles.length - 10} more`);
+        }
+        if (diffStat) {
+            lines.push(`\n${diffStat}`);
+        }
+    }
+    // Suggestion
+    lines.push("");
+    if (!plan.exists) {
+        // plan 미존재 메시지는 위에서 이미 출력됨
+    }
+    else if (plan.completed < plan.total) {
+        const nextItem = plan.items.find((item) => !item.completed);
+        if (nextItem) {
+            lines.push(`Next suggested item: "${nextItem.text}"`);
+        }
+    }
+    else {
+        lines.push("All plan items completed. Run `session complete` to archive.");
+    }
+    return lines.join("\n");
+}
+function handleComplete(input) {
+    let name = input.name;
+    if (!name) {
+        const active = findActiveSession();
+        if (!active) {
+            return "Specify a session name to complete.";
+        }
+        name = active.name;
+    }
+    const meta = getMeta(name);
+    const plan = getPlanProgress(name);
+    if (plan.exists && plan.completed < plan.total && !input.force) {
+        return [
+            `Session "${name}" has incomplete plan items (${plan.completed}/${plan.total}).`,
+            "Use `force: true` to archive anyway.",
+            "",
+            "Remaining items:",
+            ...plan.items.filter((item) => !item.completed).map((item) => `  - ${item.text}`),
+        ].join("\n");
+    }
+    const changedFiles = getChangedFiles(name);
+    const archivePath = archiveSession(name, changedFiles);
+    const lines = [
+        `Session "${name}" archived.`,
+        `Location: ${archivePath.split("/").slice(-2).join("/")}`,
+        `Changed files: ${changedFiles.length}`,
+    ];
+    if (meta.worktree?.enabled) {
+        lines.push("", "Worktree cleanup needed. Ask the user with AskUserQuestion:", `- Merge branch "${meta.worktree.branch}" into main?`, "- Remove the worktree?");
+    }
+    lines.push("", "Post-completion actions:", "1. Run /report to generate a completion report.", "2. Ask the user with AskUserQuestion: \"Did this session introduce new patterns, conventions, or architectural changes that should be reflected in SPEC.md?\"", "   If yes, run /spec to update.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=handler.js.map

package/dist/tools/session/handler.js.map

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

package/dist/tools/session/index.d.ts

@@ -0,0 +1,4 @@
+export { SessionInputSchema } from "./schema.js";
+export { handleSession } from "./handler.js";
+export { description } from "./description.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tools/session/index.js

@@ -0,0 +1,4 @@
+export { SessionInputSchema } from "./schema.js";
+export { handleSession } from "./handler.js";
+export { description } from "./description.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tools/session/schema.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const SessionInputSchema: z.ZodObject<{
+    action: z.ZodEnum<["create", "list", "status", "complete"]>;
+    name: z.ZodOptional<z.ZodString>;
+    worktree: z.ZodOptional<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    force: boolean;
+    action: "status" | "create" | "list" | "complete";
+    name?: string | undefined;
+    worktree?: boolean | undefined;
+}, {
+    action: "status" | "create" | "list" | "complete";
+    force?: boolean | undefined;
+    name?: string | undefined;
+    worktree?: boolean | undefined;
+}>;
+export type SessionInput = z.infer<typeof SessionInputSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/session/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/session/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAiB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/tools/session/schema.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export const SessionInputSchema = z.object({
+    action: z
+        .enum(["create", "list", "status", "complete"])
+        .describe("Session action"),
+    name: z
+        .string()
+        .optional()
+        .describe("Session name (for create, status, complete)"),
+    worktree: z
+        .boolean()
+        .optional()
+        .describe("Create git worktree for this session (create only). Defaults to config.worktree.auto"),
+    force: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Force archive incomplete session (complete only)"),
+});
+//# sourceMappingURL=schema.js.map

package/dist/tools/session/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/tools/session/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;SAC9C,QAAQ,CAAC,gBAAgB,CAAC;IAC7B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,QAAQ,EAAE,CAAC;SACR,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sFAAsF,CAAC;IACnG,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC,CAAC"}

package/dist/worktree/manager.d.ts

@@ -0,0 +1,9 @@
+export interface WorktreeInfo {
+    path: string;
+    branch: string;
+}
+export declare function createWorktree(sessionName: string): WorktreeInfo;
+export declare function removeWorktree(sessionName: string): void;
+export declare function getChangedFiles(sessionName: string): string[];
+export declare function getGitDiffStat(sessionName?: string): string;
+//# sourceMappingURL=manager.d.ts.map

package/dist/worktree/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/worktree/manager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CA2BhE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAcxD;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAe7D;AAED,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAoB3D"}

package/dist/worktree/manager.js

@@ -0,0 +1,92 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getConfig, getWorkspaceRoot, resolve } from "../context/workspace.js";
+function isGitRepo() {
+    try {
+        execSync("git rev-parse --is-inside-work-tree", {
+            cwd: getWorkspaceRoot(),
+            stdio: "pipe",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function createWorktree(sessionName) {
+    if (!isGitRepo()) {
+        throw new Error("Not a git repository. Worktree requires git.");
+    }
+    const config = getConfig();
+    const worktreesDir = resolve(config.worktree.path);
+    const worktreePath = join(worktreesDir, sessionName);
+    const branch = `${config.worktree.branch_prefix}${sessionName}`;
+    if (existsSync(worktreePath)) {
+        throw new Error(`Worktree already exists at ${worktreePath}`);
+    }
+    mkdirSync(worktreesDir, { recursive: true });
+    try {
+        execSync(`git worktree add -b "${branch}" "${worktreePath}"`, {
+            cwd: getWorkspaceRoot(),
+            stdio: "pipe",
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`Failed to create worktree: ${msg}`);
+    }
+    return { path: worktreePath, branch };
+}
+export function removeWorktree(sessionName) {
+    const config = getConfig();
+    const worktreePath = join(resolve(config.worktree.path), sessionName);
+    if (!existsSync(worktreePath))
+        return;
+    try {
+        execSync(`git worktree remove "${worktreePath}" --force`, {
+            cwd: getWorkspaceRoot(),
+            stdio: "pipe",
+        });
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+}
+export function getChangedFiles(sessionName) {
+    const config = getConfig();
+    const worktreePath = join(resolve(config.worktree.path), sessionName);
+    const cwd = existsSync(worktreePath) ? worktreePath : getWorkspaceRoot();
+    try {
+        const output = execSync("git diff --name-only HEAD", {
+            cwd,
+            stdio: "pipe",
+            encoding: "utf-8",
+        });
+        return output.trim().split("\n").filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+export function getGitDiffStat(sessionName) {
+    const config = getConfig();
+    let cwd = getWorkspaceRoot();
+    if (sessionName) {
+        const worktreePath = join(resolve(config.worktree.path), sessionName);
+        if (existsSync(worktreePath)) {
+            cwd = worktreePath;
+        }
+    }
+    try {
+        return execSync("git diff --stat HEAD", {
+            cwd,
+            stdio: "pipe",
+            encoding: "utf-8",
+        }).trim();
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/worktree/manager.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "aidflow",
+  "version": "1.0.0",
+  "description": "Session-based development workflow MCP for Claude Code",
+  "type": "module",
+  "bin": {
+    "aidflow": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ghyeong/devpilot"
+  },
+  "author": "ghyeong",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "development",
+    "workflow",
+    "git-worktree",
+    "session"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/README.md

@@ -0,0 +1,146 @@
+# devpilot
+
+Session-based development workflow manager for Claude Code.
+
+## Directory Structure
+
+```
+.devpilot/
+  config.yaml     # Configuration
+  sessions/       # Active sessions
+    {name}/
+      meta.json   # Session metadata
+      plan.md     # Work plan (optional)
+  history/        # Archived sessions
+    YYMMDD_{name}/
+      meta.json
+      plan.md
+  guides/         # Project-specific guides
+    *.md
+  worktrees/      # Git worktrees (gitignored)
+```
+
+---
+
+## config.yaml
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| `version` | number | `1` | Config version |
+| `worktree.auto` | boolean | `false` | Auto-create worktree on session create |
+| `worktree.path` | string | `".devpilot/worktrees"` | Worktree storage path |
+| `worktree.branch_prefix` | string | `""` | Branch name prefix (e.g., `"feature/"`, `"fix/"`) |
+| `session.history_path` | string | `".devpilot/history"` | Archive destination |
+| `session.date_format` | string | `"YYMMDD"` | Date format for archive names (`YYMMDD` or `YYYYMMDD`) |
+| `guides.path` | string | `".devpilot/guides"` | Guide documents path |
+
+---
+
+## meta.json
+
+Session metadata. Automatically managed by devpilot.
+
+```json
+{
+  "name": "fix-auth-bug",
+  "created_at": "2026-03-04T10:00:00.000Z",
+  "status": "active",
+  "worktree": {
+    "enabled": true,
+    "path": ".devpilot/worktrees/fix-auth-bug",
+    "branch": "fix-auth-bug"
+  }
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | string | Session name |
+| `created_at` | string (ISO 8601) | Creation timestamp |
+| `status` | `"active"` \| `"completed"` | Session state |
+| `completed_at` | string (ISO 8601) | Completion timestamp (set on `session complete`) |
+| `worktree.enabled` | boolean | Whether worktree is attached |
+| `worktree.path` | string | Worktree directory path |
+| `worktree.branch` | string | Git branch name |
+| `changed_files` | string[] | Files changed during session (set on `session complete`) |
+
+---
+
+## plan.md
+
+Optional work plan. Created via `plan create`. Structure:
+
+```markdown
+# {Title}
+
+## Background
+{Context and motivation}
+
+## Objective
+{Clear, measurable goal}
+
+## Requirements
+
+### Functional Requirements
+- FR-1: {requirement}
+
+### Non-Functional Requirements
+- NFR-1: {requirement}
+
+## Out of Scope
+- {Excluded items}
+
+## Technical Approach
+{Architecture, patterns, key decisions}
+
+### Affected Files
+- `path/to/file.ts` - {changes}
+
+## Implementation Items
+- [ ] Item 1
+- [ ] Item 2
+
+## Acceptance Criteria
+- [ ] AC-1: {condition}
+
+## Notes
+{Constraints, assumptions, references}
+```
+
+Progress is tracked via checkboxes. `session status` reports completion rate.
+
+---
+
+## Guides
+
+Markdown files in `.devpilot/guides/`. Used for project-specific knowledge injection.
+
+- First line = title, second line = description
+- Use `guide list` to see available guides
+- Use `guide read` to load a specific guide
+
+---
+
+## Skills
+
+Claude Code skills installed to `.claude/commands/`:
+
+| Skill | Description |
+|-------|-------------|
+| `/spec` | Create or update project SPEC.md |
+| `/report` | Generate session completion report |
+
+---
+
+## Workflow
+
+```
+session create -> (plan create) -> work -> session complete -> /report
+```
+
+1. **session create**: Start a new session (optionally with worktree)
+2. **plan create** (optional): Structured planning for medium/large tasks
+3. **Work**: Implement using Claude Code's native tools
+4. **session status**: Check progress anytime
+5. **session complete**: Archive session to history
+6. **/report**: Generate completion report

package/templates/config.yaml

@@ -0,0 +1,20 @@
+# devpilot configuration
+version: 1
+
+worktree:
+  # Auto-create worktree for every new session
+  auto: false
+  # Worktree storage path
+  path: ".devpilot/worktrees"
+  # Branch name prefix for worktrees (e.g., "feature/", "fix/", or empty)
+  branch_prefix: ""
+
+session:
+  # Archived session storage path
+  history_path: ".devpilot/history"
+  # Date format for archive names (YYMMDD or YYYYMMDD)
+  date_format: "YYMMDD"
+
+guides:
+  # Guide documents path
+  path: ".devpilot/guides"

package/templates/guides/getting-started.md

@@ -0,0 +1,21 @@
+# Getting Started
+Quick guide to using devpilot in this project.
+
+## Session Workflow
+
+1. **Start**: `session create "task-name"` to begin a new task
+2. **Plan** (optional): `plan create` for medium/large tasks
+3. **Work**: Implement using Claude Code's native tools
+4. **Check**: `session status` to see progress
+5. **Done**: `session complete` to archive
+
+## Worktrees
+
+For isolated parallel work, create sessions with worktrees:
+- Set `worktree: true` in `session create`
+- Or set `worktree.auto: true` in config.yaml for all sessions
+
+## Guides
+
+Add project-specific guides to `.devpilot/guides/` as markdown files.
+Use `guide list` to see available guides.

package/templates/skills/report.md

@@ -0,0 +1,52 @@
+---
+name: report
+description: Generate a session completion report. Call after session complete.
+allowed-tools: Read, Write, Bash, Glob, Grep
+---
+
+Generate a completion report for the most recently archived session.
+
+## Steps
+
+1. Find the latest directory in `.devpilot/history/` (sorted by name, newest first)
+2. Read `meta.json` from that directory to get session metadata
+3. Read `plan.md` from that directory (if exists)
+4. Gather git commits for the session period:
+   - Use `created_at` and `completed_at` from meta.json as the time range
+   - Run: `git log --oneline --after="{created_at}" --before="{completed_at}"`
+   - If no completed_at, use current time as the end
+5. Read the changed files listed in meta.json and briefly review each
+6. Write `report.md` in the history directory
+
+## report.md Format
+
+```markdown
+# {Session Name} - Report
+
+## Summary
+{1-2 line summary of what was accomplished}
+
+## Plan Completion
+{Plan items and their completion status, if plan existed}
+
+## Changed Files
+| File | Change Type | Description |
+|------|-------------|-------------|
+| path/to/file | modified/new/deleted | Brief description |
+
+## Key Decisions
+{Important technical decisions made during the work}
+
+## Issues & Observations
+{Any issues found, edge cases discovered, or observations for future reference}
+
+## Duration
+- Started: {created_at}
+- Completed: {completed_at}
+- Commits: {number of commits in range}
+```
+
+## Notes
+- If the history directory is empty, inform the user to run `session complete` first
+- Focus on factual reporting, not speculation
+- Keep descriptions concise but informative