localptp 0.1.0

package/dist/commands/resume.js

@@ -0,0 +1,75 @@
+/**
+ * `localptp resume` (HLD-SRD §3.6; CLI.md).
+ *
+ * Pure filesystem operation (no model call). Lists sessions newest-first with
+ * status + Next-Step preview, selects one (a 1-based index arg, else a stdin
+ * number under TTY), loads it, writes the active pointer, and prints the Next
+ * Step. No sessions → friendly message, exit zero. An out-of-range index, or a
+ * non-TTY run with no index, is an actionable error (non-zero exit) that
+ * activates nothing.
+ */
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { layout } from "../utils/paths.js";
+import { listSessions } from "../core/sessionManager.js";
+import { writeActive } from "../core/activePointer.js";
+class CommandError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "CommandError";
+        this.exitCode = exitCode;
+    }
+}
+export async function runResume(opts) {
+    const git = await detectGitRoot(opts.cwd);
+    const root = git.root ?? opts.cwd;
+    const l = layout(root);
+    const sessions = await listSessions(l.sessionsDir);
+    if (sessions.length === 0) {
+        // Friendly, exit zero.
+        return { sessions };
+    }
+    // Resolve the selection (1-based).
+    let index = opts.index;
+    if (index === undefined) {
+        const isTTY = opts.isTTY ?? Boolean(process.stdin.isTTY);
+        if (isTTY && opts.prompt) {
+            index = await opts.prompt(sessions);
+        }
+        if (index === undefined) {
+            throw new CommandError(`Specify a session index 1–${sessions.length}, e.g. \`localptp resume 1\`.`);
+        }
+    }
+    if (!Number.isInteger(index) || index < 1 || index > sessions.length) {
+        throw new CommandError(`Invalid selection: ${index}. Choose an index 1–${sessions.length}.`);
+    }
+    const selected = sessions[index - 1];
+    await writeActive(l.orchestratorDir, {
+        taskPath: selected.taskPath,
+        sessionPath: selected.path,
+    });
+    return { sessions, selected };
+}
+function shortStamp(sessionPath) {
+    const base = sessionPath.replace(/\\/g, "/").split("/").pop() ?? "";
+    const m = /^(\d{4}-\d{2}-\d{2})_(\d{4})/.exec(base);
+    return m ? `${m[1]}_${m[2]}` : base;
+}
+function nextPreview(session) {
+    const ns = session.nextStep.split(/\r?\n/)[0]?.trim() ?? "";
+    return ns.length > 0 ? ns : "(none)";
+}
+export function formatResumeResult(result) {
+    if (result.sessions.length === 0) {
+        return 'No sessions yet. Create a task with `localptp task "…"`.';
+    }
+    const lines = [];
+    result.sessions.forEach((s, i) => {
+        lines.push(`  ${i + 1}) ${shortStamp(s.path)}  (${s.status}, next: ${nextPreview(s)})`);
+    });
+    if (result.selected) {
+        lines.push(`Loaded. Next step: ${nextPreview(result.selected)}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=resume.js.map

package/dist/commands/resume.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,17 @@
+import type { AppConfig } from "../types/config.js";
+import type { ModelClient } from "../types/model.js";
+import type { ReviewReport } from "../types/review.js";
+export interface ReviewOptions {
+    cwd: string;
+    json?: boolean;
+    /** Injectable for tests; defaults to the real LM Studio client. */
+    clientFactory?: (config: AppConfig) => ModelClient;
+}
+export interface ReviewResult {
+    hadChanges: boolean;
+    report?: ReviewReport;
+    raw?: string;
+    json: boolean;
+}
+export declare function runReview(opts: ReviewOptions): Promise<ReviewResult>;
+export declare function formatReviewResult(result: ReviewResult): string;

package/dist/commands/review.js

@@ -0,0 +1,67 @@
+/**
+ * `localptp review` (HLD-SRD §3.12; 0001_06).
+ *
+ * Advisory diff review: build a reviewer context over the current Git diff, ask
+ * the model to review it, tolerantly parse the structured report (summary /
+ * blocking / non-blocking / missing tests / scope creep / recommendation) and
+ * print it — falling back to the raw output on a parse failure. It MODIFIES NO
+ * CODE: it never edits, reverts, or applies anything.
+ *
+ * Exit behavior:
+ *   - empty diff → "No changes to review", exit 0;
+ *   - a §12 ModelClientError propagates (the CLI maps it to a non-zero exit with
+ *     the connectivity guidance).
+ */
+import { LmStudioClient } from "../core/modelClient.js";
+import { ConfigManager } from "../core/configManager.js";
+import { runReviewEngine } from "../core/reviewEngine.js";
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { layout } from "../utils/paths.js";
+function defaultClientFactory(config) {
+    return new LmStudioClient({
+        baseUrl: config.model.baseUrl,
+        model: config.model.model,
+        apiKey: config.model.apiKey,
+        temperature: config.model.temperature,
+        timeoutMs: config.model.timeoutMs,
+    });
+}
+export async function runReview(opts) {
+    const git = await detectGitRoot(opts.cwd);
+    const root = git.root ?? opts.cwd;
+    const l = layout(root);
+    const config = await new ConfigManager(l.configFile).load();
+    const client = (opts.clientFactory ?? defaultClientFactory)(config);
+    const result = await runReviewEngine({ cwd: opts.cwd, client });
+    return {
+        hadChanges: result.hadChanges,
+        ...(result.report !== undefined ? { report: result.report } : {}),
+        ...(result.raw !== undefined ? { raw: result.raw } : {}),
+        json: opts.json ?? false,
+    };
+}
+function bulletList(label, items) {
+    if (items.length === 0)
+        return `${label}: (none)`;
+    return `${label}:\n${items.map((i) => `  - ${i}`).join("\n")}`;
+}
+export function formatReviewResult(result) {
+    if (!result.hadChanges) {
+        return "No changes to review.";
+    }
+    if (result.report) {
+        const r = result.report;
+        return [
+            "=== Review ===",
+            `Summary: ${r.summary || "(none)"}`,
+            bulletList("Blocking", r.blocking),
+            bulletList("Non-blocking", r.nonBlocking),
+            bulletList("Missing tests", r.missingTests),
+            bulletList("Scope creep", r.scopeCreep),
+            `Recommendation: ${r.recommendation || "(none)"}`,
+        ].join("\n");
+    }
+    // Unparseable — print the raw review verbatim (never blocks).
+    return ["=== Review (unparsed) ===", result.raw ?? ""].join("\n");
+}
+//# sourceMappingURL=review.js.map

package/dist/commands/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAmB3C,SAAS,oBAAoB,CAAC,MAAiB;IAC7C,OAAO,IAAI,cAAc,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;QACzB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAC3B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;QACrC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAe;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,UAAU,CAAC;IAClD,OAAO,GAAG,KAAK,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,OAAO;YACL,gBAAgB;YAChB,YAAY,CAAC,CAAC,OAAO,IAAI,QAAQ,EAAE;YACnC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC;YAClC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,WAAW,CAAC;YACzC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC,YAAY,CAAC;YAC3C,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC,UAAU,CAAC;YACvC,mBAAmB,CAAC,CAAC,cAAc,IAAI,QAAQ,EAAE;SAClD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IACD,8DAA8D;IAC9D,OAAO,CAAC,2BAA2B,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,24 @@
+import { type Approver } from "../core/approval.js";
+import type { AppConfig } from "../types/config.js";
+import type { ModelClient } from "../types/model.js";
+import type { StopReason } from "../types/run.js";
+export interface RunOptions {
+    cwd: string;
+    json?: boolean;
+    /** Injectable for tests; defaults to the real LM Studio client. */
+    clientFactory?: (config: AppConfig) => ModelClient;
+    /** Injectable approval seam; defaults to a TTY yes/no prompt. */
+    approve?: Approver;
+    /** Injectable clock for deterministic patch artifact names. */
+    now?: Date;
+}
+export interface RunResult {
+    stopReason: StopReason;
+    /** Number of steps that applied a patch. */
+    applied: number;
+    /** Number of iterations the loop completed (continued past). */
+    iterations: number;
+    json: boolean;
+}
+export declare function run(opts: RunOptions): Promise<RunResult>;
+export declare function formatRunResult(result: RunResult): string;

package/dist/commands/run.js

@@ -0,0 +1,65 @@
+/**
+ * `localptp run` (HLD-SRD §3.13, §11.2; 0001_06).
+ *
+ * Automates the daily loop: it drives the shared `runStep` core over the active
+ * task's pending subtasks via the `runLoop` driver, pausing for approval at each
+ * diff (the core owns approval), printing a per-step progress line, and stopping
+ * on the first §11.2 stop condition with a clear reason. The step runner is the
+ * SAME core `step` uses, so one-shot and looped execution behave identically.
+ *
+ * `run` never re-implements the patch pipeline and never runs `summarize`; on
+ * acceptance it only RECOMMENDS summarizing (0001_07 owns the command).
+ */
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { layout } from "../utils/paths.js";
+import { ConfigManager } from "../core/configManager.js";
+import { resolveActive } from "../core/activePointer.js";
+import { parseTask } from "../core/taskManager.js";
+import { runStep, CommandError } from "../core/runStep.js";
+import { runLoop } from "../core/runLoop.js";
+import { ttyApprove } from "../core/approval.js";
+export async function run(opts) {
+    const approve = opts.approve ?? ttyApprove;
+    const git = await detectGitRoot(opts.cwd);
+    const root = git.root ?? opts.cwd;
+    const l = layout(root);
+    // Resolve the active task to count pending subtasks (sets the iteration cap).
+    const active = await resolveActive(l.orchestratorDir);
+    if (active.kind === "none") {
+        throw new CommandError('No active task. Create one first with `localptp task "…"`.');
+    }
+    if (active.kind === "missing-target") {
+        throw new CommandError(`The active pointer references a missing file: ${active.missing.join(", ")}. ` +
+            'Create a new task with `localptp task "…"` or pick another with `localptp resume`.');
+    }
+    const config = await new ConfigManager(l.configFile).load();
+    const task = await parseTask(active.pointer.taskPath);
+    const pendingCount = task.subtasks.filter((s) => s.status === "pending").length;
+    const result = await runLoop({
+        config,
+        pendingCount,
+        step: () => runStep({
+            cwd: opts.cwd,
+            ...(opts.clientFactory !== undefined ? { clientFactory: opts.clientFactory } : {}),
+            approve,
+            ...(opts.now !== undefined ? { now: opts.now } : {}),
+        }),
+    });
+    return {
+        stopReason: result.stopReason,
+        applied: result.applied,
+        iterations: result.state.iterations,
+        json: opts.json ?? false,
+    };
+}
+export function formatRunResult(result) {
+    const lines = [
+        `Run stopped: ${result.stopReason}.`,
+        `Applied ${result.applied} patch(es) over ${result.iterations} step(s).`,
+    ];
+    if (result.stopReason === "acceptance-met") {
+        lines.push("Recommend: `localptp summarize` (0001_07) to close the session.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/step.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `localptp step` (HLD-SRD §3.10, §3.11, §3.13, §10.2, §11, §12.3, §13).
+ *
+ * A thin wrapper over the shared `runStep` core (`src/core/runStep.ts`): it runs
+ * ONE pending subtask end-to-end through the core state machine, then adapts the
+ * core's `StepCoreResult` to the command-facing `StepResult` for the CLI. The
+ * highest-stakes code (the patch apply pipeline + the bounded test-fix loop)
+ * lives in the core so `step` (one-shot) and `run` (looped) share identical
+ * behavior.
+ */
+import { parseNeedsContext, CommandError, type NeedsContext } from "../core/runStep.js";
+import type { Approver } from "../core/approval.js";
+import type { AppConfig } from "../types/config.js";
+import type { ModelClient } from "../types/model.js";
+import type { TestResult } from "../types/test.js";
+export { CommandError, parseNeedsContext };
+export type { NeedsContext };
+export interface StepOptions {
+    cwd: string;
+    json?: boolean;
+    /** Injectable for tests; defaults to the real LM Studio client. */
+    clientFactory?: (config: AppConfig) => ModelClient;
+    /** Injectable approval seam; defaults to a TTY yes/no prompt. */
+    approve?: Approver;
+    /** Injectable clock for deterministic patch artifact names. */
+    now?: Date;
+}
+export interface StepResult {
+    /** True once the patch was applied to the working tree. */
+    applied: boolean;
+    /** True when there was no pending subtask (task done). */
+    done: boolean;
+    /** Set when the model returned a `needs_context` request instead of a diff. */
+    needsContext?: NeedsContext;
+    /** The subtask this step ran (when one was pending). */
+    subtaskId?: string;
+    /** The saved patch artifact path (when applied). */
+    patchPath?: string;
+    /** Captured test results (empty when no tests configured or nothing applied). */
+    testResults: TestResult[];
+    json: boolean;
+}
+export declare function runStep(opts: StepOptions): Promise<StepResult>;
+export declare function formatStepResult(result: StepResult): string;

package/dist/commands/step.js

@@ -0,0 +1,50 @@
+/**
+ * `localptp step` (HLD-SRD §3.10, §3.11, §3.13, §10.2, §11, §12.3, §13).
+ *
+ * A thin wrapper over the shared `runStep` core (`src/core/runStep.ts`): it runs
+ * ONE pending subtask end-to-end through the core state machine, then adapts the
+ * core's `StepCoreResult` to the command-facing `StepResult` for the CLI. The
+ * highest-stakes code (the patch apply pipeline + the bounded test-fix loop)
+ * lives in the core so `step` (one-shot) and `run` (looped) share identical
+ * behavior.
+ */
+import { runStep as runStepCore, parseNeedsContext, CommandError, } from "../core/runStep.js";
+import { formatTestResult } from "../core/testRunner.js";
+export { CommandError, parseNeedsContext };
+export async function runStep(opts) {
+    const deps = {
+        cwd: opts.cwd,
+        ...(opts.clientFactory !== undefined ? { clientFactory: opts.clientFactory } : {}),
+        ...(opts.approve !== undefined ? { approve: opts.approve } : {}),
+        ...(opts.now !== undefined ? { now: opts.now } : {}),
+    };
+    const outcome = await runStepCore(deps);
+    return {
+        applied: outcome.applied,
+        done: outcome.done,
+        ...(outcome.needsContext !== undefined ? { needsContext: outcome.needsContext } : {}),
+        ...(outcome.subtaskId !== null ? { subtaskId: outcome.subtaskId } : {}),
+        ...(outcome.patchPath !== undefined ? { patchPath: outcome.patchPath } : {}),
+        testResults: outcome.testResults,
+        json: opts.json ?? false,
+    };
+}
+export function formatStepResult(result) {
+    if (result.done) {
+        return "No pending subtasks — the task is complete.";
+    }
+    if (result.needsContext) {
+        return `Model needs more context: ${result.needsContext.reason}`;
+    }
+    if (!result.applied) {
+        return "Nothing applied.";
+    }
+    const lines = [`Applied ${result.subtaskId}.`];
+    if (result.patchPath)
+        lines.push(`Patch saved: ${result.patchPath}`);
+    for (const r of result.testResults) {
+        lines.push(formatTestResult(r));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=step.js.map

package/dist/commands/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../src/commands/step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,iBAAiB,EACjB,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA8B3C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,IAAI,GAAa;QACrB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,6CAA6C,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,OAAO,6BAA6B,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/summarize.d.ts

@@ -0,0 +1,17 @@
+import type { ModelClient } from "../types/model.js";
+import type { AppConfig } from "../types/config.js";
+import type { Session } from "../types/session.js";
+export interface SummarizeOptions {
+    cwd: string;
+    json?: boolean;
+    /** Injectable for tests; defaults to the real LM Studio client. */
+    clientFactory?: (config: AppConfig) => ModelClient;
+}
+export interface SummarizeResult {
+    session: Session;
+    updatedFiles: string[];
+    ignored: string[];
+    json: boolean;
+}
+export declare function runSummarize(opts: SummarizeOptions): Promise<SummarizeResult>;
+export declare function formatSummarizeResult(result: SummarizeResult): string;

package/dist/commands/summarize.js

@@ -0,0 +1,276 @@
+/**
+ * `localptp summarize` (HLD-SRD §3.4, §3.9, §12, §13; CLI.md; 0001_07).
+ *
+ * Closes the daily loop by folding finished work into durable `/ai` memory.
+ *
+ * Flow (side-effect ordering: session BEFORE memory, so a later memory-append
+ * failure leaves a re-runnable partial):
+ *   1. resolveActive() — none → error, non-zero exit.
+ *   2. Load config + task + session + memory + optional Git diff.
+ *   3. buildContext({ role: 'summarizer', task, session }).
+ *   4. ModelClient.complete(summarizer system + rendered user).
+ *        §12 ModelClientError → propagates unchanged; NOTHING written.
+ *   5. tolerantExtract(content, summarizerSchema).
+ *        fail → minimal session-only note + warning, non-zero exit; NO memory
+ *        writes.
+ *   6. updateSession(sessionUpdate, nextStep)  ← SESSION FIRST.
+ *   7. For each memoryUpdate: normalize(changeType) → POLICY target file →
+ *        appendMemoryEntry(). Out-of-table changeType → ignored + warning.
+ *   8. Return { session, updatedFiles, ignored, json }.
+ *
+ * Security: the model NEVER picks the target file. The code resolves it from
+ * the POLICY table using the declared changeType (§13).
+ */
+import path from "node:path";
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { layout } from "../utils/paths.js";
+import { readIfExists } from "../utils/fs.js";
+import { ConfigManager } from "../core/configManager.js";
+import { loadMemoryFiles } from "../core/memoryLoader.js";
+import { buildContext } from "../core/contextBuilder.js";
+import { resolveActive } from "../core/activePointer.js";
+import { parseTask } from "../core/taskManager.js";
+import { loadSession, updateSession } from "../core/sessionManager.js";
+import { getPrompt } from "../core/promptManager.js";
+import { LmStudioClient } from "../core/modelClient.js";
+import { POLICY, normalize, headingFor } from "../core/memoryPolicy.js";
+import { appendMemoryEntry } from "../core/memoryManager.js";
+import { summarizerSchema } from "../types/summary.js";
+import { parseActiveTask, parseActiveSession } from "../types/context.js";
+import { repoIndexSchema } from "../types/index.js";
+import { simpleGit } from "simple-git";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+class CommandError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "CommandError";
+        this.exitCode = exitCode;
+    }
+}
+function defaultClientFactory(config) {
+    return new LmStudioClient({
+        baseUrl: config.model.baseUrl,
+        model: config.model.model,
+        apiKey: config.model.apiKey,
+        temperature: config.model.temperature,
+        timeoutMs: config.model.timeoutMs,
+    });
+}
+const EMPTY_INDEX = {
+    generatedAt: "",
+    root: "",
+    files: [],
+};
+async function loadIndex(orchestratorDir) {
+    const raw = await readIfExists(path.join(orchestratorDir, "index.json"));
+    if (raw === undefined)
+        return EMPTY_INDEX;
+    try {
+        const parsed = repoIndexSchema.safeParse(JSON.parse(raw));
+        return parsed.success ? parsed.data : EMPTY_INDEX;
+    }
+    catch {
+        return EMPTY_INDEX;
+    }
+}
+/** Current working-tree diff: "" when not a git repo or no changes. */
+async function currentDiff(root) {
+    const git = simpleGit(root);
+    try {
+        if (!(await git.checkIsRepo()))
+            return "";
+        return await git.diff(["HEAD"]);
+    }
+    catch {
+        try {
+            return await git.diff();
+        }
+        catch {
+            return "";
+        }
+    }
+}
+/** First balanced `{...}` substring — string/escape aware. */
+function firstBalancedObject(raw) {
+    const start = raw.indexOf("{");
+    if (start === -1)
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < raw.length; i++) {
+        const ch = raw[i];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === "\\")
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"')
+            inString = true;
+        else if (ch === "{")
+            depth += 1;
+        else if (ch === "}") {
+            depth -= 1;
+            if (depth === 0)
+                return raw.slice(start, i + 1);
+        }
+    }
+    return undefined;
+}
+/**
+ * Tolerantly extract a SummarizerOutput from raw model output.
+ * Returns null when no parseable + valid structure is found.
+ */
+function tolerantExtractSummary(raw) {
+    // 1. Strict whole-output parse.
+    try {
+        const obj = JSON.parse(raw);
+        if (obj !== null && typeof obj === "object" && !Array.isArray(obj)) {
+            const r = summarizerSchema.safeParse(obj);
+            if (r.success)
+                return r.data;
+        }
+    }
+    catch {
+        // fall through
+    }
+    // 2. First balanced {...} block.
+    const block = firstBalancedObject(raw);
+    if (block === undefined)
+        return null;
+    try {
+        const obj = JSON.parse(block);
+        const r = summarizerSchema.safeParse(obj);
+        return r.success ? r.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function runSummarize(opts) {
+    const git = await detectGitRoot(opts.cwd);
+    const root = git.root ?? opts.cwd;
+    const l = layout(root);
+    // 1. Resolve the active session (required).
+    const active = await resolveActive(l.orchestratorDir);
+    if (active.kind === "none") {
+        throw new CommandError('No active session. Create or resume a task first with `localptp task "…"` or `localptp resume`.');
+    }
+    if (active.kind === "missing-target") {
+        throw new CommandError(`The active pointer references a missing file: ${active.missing.join(", ")}. ` +
+            "Create a new task with `localptp task \"…\"` or pick another with `localptp resume`.");
+    }
+    const { taskPath, sessionPath } = active.pointer;
+    // 2. Load config, task, session, memory, and the optional Git diff.
+    const config = await new ConfigManager(l.configFile).load();
+    const task = await parseTask(taskPath);
+    const session = await loadSession(sessionPath);
+    const index = await loadIndex(l.orchestratorDir);
+    const memory = await loadMemoryFiles(root);
+    const diff = await currentDiff(root);
+    // 3. Build the summarizer context.
+    // Include the diff as additional context in the user prompt.
+    const pkg = buildContext({
+        role: "summarizer",
+        config,
+        index,
+        memory,
+        task: parseActiveTask(task.raw),
+        session: parseActiveSession(session.raw),
+        fileContents: {},
+    });
+    // Augment the user prompt with the diff (optional).
+    const diffSection = diff.trim().length > 0
+        ? `\n\n## Git Diff\n\n\`\`\`diff\n${diff}\n\`\`\``
+        : "\n\n## Git Diff\n\n(No uncommitted changes detected — summarize task/session progress only.)";
+    const summarizer = getPrompt("summarizer");
+    const userPromptWithDiff = pkg.userPrompt + diffSection;
+    // 4. Call the model — §12 ModelClientError propagates; NOTHING written yet.
+    const client = (opts.clientFactory ?? defaultClientFactory)(config);
+    const response = await client.complete({
+        role: "summarizer",
+        systemPrompt: summarizer.system,
+        userPrompt: summarizer.renderUser(userPromptWithDiff),
+    });
+    // 5. Tolerantly parse the response.
+    const summary = tolerantExtractSummary(response.content);
+    if (summary === null) {
+        // Minimal session-only update + warning + non-zero exit; NO memory writes.
+        const failedSession = await updateSession(session, {
+            currentState: "summary attempted; model output unparseable",
+        });
+        process.stderr.write("warning: summarize: model output could not be parsed into a valid summary. " +
+            "Session updated with a minimal note; memory files were NOT written.\n");
+        const err = new CommandError("summarize: model output could not be parsed into a valid summary. " +
+            "Session updated with a minimal note; no memory files were written.");
+        // Attach the partial result for callers that catch and inspect.
+        err.session = failedSession;
+        err.updatedFiles = [];
+        err.ignored = [];
+        err.json = opts.json ?? false;
+        throw err;
+    }
+    // 6. SESSION FIRST — update the session before any memory writes.
+    const updatedSession = await updateSession(session, {
+        currentState: summary.sessionUpdate.currentState,
+        nextStep: summary.nextStep,
+        decisions: summary.sessionUpdate.decisions,
+        risks: summary.sessionUpdate.risks,
+    });
+    // 7. Apply memory updates via the POLICY table.
+    const updatedFiles = [];
+    const ignored = [];
+    for (const update of summary.memoryUpdates) {
+        const key = normalize(update.changeType);
+        if (key === undefined) {
+            process.stderr.write(`warning: summarize: ignored update for unknown change type '${update.changeType}'\n`);
+            ignored.push(update.changeType);
+            continue;
+        }
+        const targetFile = POLICY[key];
+        const heading = headingFor(key);
+        if (targetFile === undefined || heading === undefined) {
+            // Should not happen if POLICY and HEADINGS are in sync — defensive.
+            process.stderr.write(`warning: summarize: no policy entry for key '${key}' (change type '${update.changeType}')\n`);
+            ignored.push(update.changeType);
+            continue;
+        }
+        const fullPath = l.memoryFile(targetFile);
+        await appendMemoryEntry(fullPath, heading, update.content);
+        if (!updatedFiles.includes(targetFile)) {
+            updatedFiles.push(targetFile);
+        }
+    }
+    // 8. Return the result.
+    return {
+        session: updatedSession,
+        updatedFiles,
+        ignored,
+        json: opts.json ?? false,
+    };
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+export function formatSummarizeResult(result) {
+    const parts = [];
+    if (result.updatedFiles.length > 0) {
+        parts.push(`Updated: ${result.updatedFiles.join(", ")}`);
+    }
+    else {
+        parts.push("No memory files updated.");
+    }
+    parts.push(`Session: ${result.session.status}`);
+    if (result.ignored.length > 0) {
+        parts.push(`Ignored (unknown change types): ${result.ignored.join(", ")}`);
+    }
+    return parts.join("; ");
+}
+//# sourceMappingURL=summarize.js.map