localptp 0.1.0

package/dist/commands/context.js

@@ -0,0 +1,176 @@
+/**
+ * `localptp context` (HLD-SRD §3.7, §9, §15 Test 5; CLI.md).
+ *
+ * Read-only preview of the context package the Context Builder would assemble
+ * for a role. Makes NO model call. Workflow:
+ *   1. Detect repo root + load config.
+ *   2. Load .ai-orchestrator/index.json (actionable error if missing).
+ *   3. Load /ai memory.
+ *   4. Find + tolerantly parse the newest /ai/tasks/* and /ai/sessions/* (optional).
+ *   5. Read indexed file bodies into a fileContents map; a file that fails to
+ *      read (e.g. deleted since index) is omitted and a warning is collected.
+ *   6. buildContext(...) → ContextPackage.
+ *   7. Print the CLI.md summary, or the structured package with --json.
+ */
+import { promises as fs } from "node:fs";
+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 { parseActiveTask, parseActiveSession, } from "../types/context.js";
+import { repoIndexSchema } from "../types/index.js";
+const VALID_ROLES = [
+    "planner",
+    "retriever",
+    "coder",
+    "reviewer",
+    "test-fixer",
+    "summarizer",
+];
+class CommandError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = "CommandError";
+        this.exitCode = exitCode;
+    }
+}
+function resolveRole(role) {
+    if (role === undefined)
+        return "coder";
+    if (VALID_ROLES.includes(role))
+        return role;
+    throw new CommandError(`Unknown role: ${role}. Valid roles: ${VALID_ROLES.join(", ")}.`);
+}
+/** Return the newest (by mtime) `*.md` file body under `dir`, or undefined. */
+async function newestMarkdown(dir) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return undefined;
+    }
+    let newest;
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md"))
+            continue;
+        const full = path.join(dir, entry.name);
+        try {
+            const stat = await fs.stat(full);
+            const body = await fs.readFile(full, "utf8");
+            const mtimeMs = stat.mtimeMs;
+            if (newest === undefined ||
+                mtimeMs > newest.mtimeMs ||
+                // Deterministic tiebreak when mtimes are equal: latest name wins.
+                (mtimeMs === newest.mtimeMs && entry.name > newest.name)) {
+                newest = { body, mtimeMs, name: entry.name };
+            }
+        }
+        catch {
+            // Skip unreadable entries.
+        }
+    }
+    return newest?.body;
+}
+export async function runContext(opts) {
+    const { cwd } = opts;
+    const role = resolveRole(opts.role);
+    // 1. Root + config.
+    const git = await detectGitRoot(cwd);
+    const root = git.root ?? cwd;
+    const l = layout(root);
+    const config = await new ConfigManager(l.configFile).load();
+    // 2. Load index.
+    const indexPath = path.join(l.orchestratorDir, "index.json");
+    const rawIndex = await readIfExists(indexPath);
+    if (rawIndex === undefined) {
+        throw new CommandError("No repository index found. Run `localptp index` first.");
+    }
+    let index;
+    try {
+        const parsed = repoIndexSchema.safeParse(JSON.parse(rawIndex));
+        if (!parsed.success) {
+            throw new CommandError("The repository index is malformed. Re-run `localptp index`.");
+        }
+        index = parsed.data;
+    }
+    catch (err) {
+        if (err instanceof CommandError)
+            throw err;
+        throw new CommandError("The repository index could not be read as JSON. Re-run `localptp index`.");
+    }
+    // 3. Memory.
+    const memory = await loadMemoryFiles(root);
+    // 4. Optional active task / session. Prefer the explicit active pointer
+    //    (0001_04); fall back to the newest-file heuristic when the pointer is
+    //    absent or dangles.
+    let task;
+    let session;
+    const active = await resolveActive(l.orchestratorDir);
+    if (active.kind === "ok") {
+        const taskMd = await readIfExists(active.pointer.taskPath);
+        if (taskMd !== undefined)
+            task = parseActiveTask(taskMd);
+        const sessionMd = await readIfExists(active.pointer.sessionPath);
+        if (sessionMd !== undefined)
+            session = parseActiveSession(sessionMd);
+    }
+    if (task === undefined) {
+        const taskMd = await newestMarkdown(l.tasksDir);
+        if (taskMd !== undefined)
+            task = parseActiveTask(taskMd);
+    }
+    if (session === undefined) {
+        const sessionMd = await newestMarkdown(l.sessionsDir);
+        if (sessionMd !== undefined)
+            session = parseActiveSession(sessionMd);
+    }
+    // 5. Read indexed file bodies; omit unreadable/deleted files with a warning.
+    const fileContents = {};
+    const preWarnings = [];
+    for (const f of index.files) {
+        const rel = f.path.replace(/\\/g, "/");
+        const full = path.join(root, rel);
+        try {
+            fileContents[rel] = await fs.readFile(full, "utf8");
+        }
+        catch {
+            preWarnings.push(`Indexed file missing: ${rel}; re-run \`localptp index\`.`);
+        }
+    }
+    // 6. Build.
+    const pkg = buildContext({
+        role,
+        config,
+        index,
+        memory,
+        task,
+        session,
+        fileContents,
+    });
+    // Surface the content-loading warnings ahead of the builder's own.
+    pkg.warnings = [...preWarnings, ...pkg.warnings];
+    return { pkg, maxContextTokens: config.model.maxContextTokens };
+}
+function fmtList(items) {
+    return items.length > 0 ? items.join(", ") : "(none)";
+}
+export function formatContextResult(result) {
+    const { pkg, maxContextTokens } = result;
+    const lines = [
+        `Role: ${pkg.role}`,
+        `Memory:  ${fmtList(pkg.includedMemoryFiles)}`,
+        `Source:  ${fmtList(pkg.includedSourceFiles)}`,
+        `Tests:   ${fmtList(pkg.includedTestFiles)}`,
+        `Estimated tokens: ${pkg.estimatedTokens.toLocaleString("en-US")} / ${maxContextTokens.toLocaleString("en-US")}`,
+    ];
+    for (const w of pkg.warnings)
+        lines.push(`! ${w}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+import type { ModelClient } from "../types/model.js";
+import type { AppConfig } from "../types/config.js";
+export interface DoctorOptions {
+    cwd: string;
+    json?: boolean;
+    /** Injectable for tests; defaults to the real LM Studio client. */
+    clientFactory?: (config: AppConfig) => ModelClient;
+}
+export interface DoctorResult {
+    reachable: boolean;
+    model?: string;
+    latencyMs: number;
+    models: string[];
+}
+export declare function runDoctor(opts: DoctorOptions): Promise<DoctorResult>;
+export declare function formatDoctorResult(result: DoctorResult): string;

package/dist/commands/doctor.js

@@ -0,0 +1,54 @@
+/**
+ * `localptp doctor` (HLD-SRD §3.8, §12, §15 Test 3).
+ *
+ * Load+validate config → `health()` (GET /models) → `complete()` with a tiny
+ * prompt → assert non-empty → return reachable + latency. Transport/protocol
+ * failures surface as the typed `ModelClientError` so the caller can print the
+ * matching §12 message and exit non-zero.
+ */
+import { layout } from "../utils/paths.js";
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { ConfigManager } from "../core/configManager.js";
+import { LmStudioClient } from "../core/modelClient.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 runDoctor(opts) {
+    // Resolve the repo root (like `init`) so doctor reads the repo-root config
+    // regardless of the subdirectory it runs from; fall back to cwd outside Git.
+    const git = await detectGitRoot(opts.cwd);
+    const l = layout(git.root ?? opts.cwd);
+    const config = await new ConfigManager(l.configFile).load();
+    const client = (opts.clientFactory ?? defaultClientFactory)(config);
+    const health = await client.health();
+    const models = health.models ?? [];
+    const start = Date.now();
+    const response = await client.complete({
+        role: "summarizer",
+        systemPrompt: "You are a health check. Reply with a single short word.",
+        userPrompt: "ping",
+    });
+    const latencyMs = Date.now() - start;
+    // complete() already throws on empty/malformed; assert defensively.
+    if (response.content.length === 0) {
+        throw new Error("Model returned an empty/invalid response.");
+    }
+    return {
+        reachable: true,
+        model: models[0] ?? config.model.model,
+        latencyMs,
+        models,
+    };
+}
+export function formatDoctorResult(result) {
+    return (`✓ reachable\n` +
+        `model: ${result.model ?? "(unknown)"}\n` +
+        `model responded (${result.latencyMs}ms)`);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAkBxD,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,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,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,MAAM,CAAC,MAAM,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;QACrC,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,yDAAyD;QACvE,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAErC,oEAAoE;IACpE,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK;QACtC,SAAS;QACT,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,CACL,eAAe;QACf,UAAU,MAAM,CAAC,KAAK,IAAI,WAAW,IAAI;QACzC,oBAAoB,MAAM,CAAC,SAAS,KAAK,CAC1C,CAAC;AACJ,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,13 @@
+export interface IndexOptions {
+    cwd: string;
+    json?: boolean;
+    onWarning?: (msg: string) => void;
+}
+export interface IndexResult {
+    indexed: number;
+    ignored: number;
+    durationMs: number;
+    root: string;
+}
+export declare function runIndex(opts: IndexOptions): Promise<IndexResult>;
+export declare function formatIndexResult(result: IndexResult): string;

package/dist/commands/index.js

@@ -0,0 +1,70 @@
+/**
+ * `localptp index` (HLD-SRD §3.3, §5, §9).
+ *
+ * Offline filesystem scan: no model call, no stdin. Workflow:
+ *   1. Detect repo root (warn when non-git).
+ *   2. Load config.
+ *   3. buildIndex(root, config) → RepoIndex.
+ *   4. Write .ai-orchestrator/index.json (pretty JSON).
+ *   5. updateMarkerSection × 2 (ai/repo-map.md, ai/file-index.md).
+ *   6. Return structured summary.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { ensureDir } from "../utils/fs.js";
+import { layout } from "../utils/paths.js";
+import { ConfigManager } from "../core/configManager.js";
+import { buildIndex, renderRepoMap, renderFileIndex } from "../core/repoIndexer.js";
+import { updateMarkerSection } from "../core/memoryManager.js";
+export async function runIndex(opts) {
+    const { cwd, onWarning } = opts;
+    const warn = (msg) => {
+        if (onWarning) {
+            onWarning(msg);
+        }
+        else {
+            process.stderr.write(`warning: ${msg}\n`);
+        }
+    };
+    const t0 = Date.now();
+    // 1. Detect root
+    const git = await detectGitRoot(cwd);
+    if (!git.isRepo) {
+        warn("This directory is not a Git repository. localptp index will use config + baseline ignore only.");
+    }
+    const root = git.root ?? cwd;
+    const l = layout(root);
+    // 2. Load config
+    const config = await new ConfigManager(l.configFile).load();
+    // 3. Build index
+    const index = await buildIndex(root, config);
+    // Extract ignored count (stored as side-channel property)
+    const ignored = index._ignoredCount ?? 0;
+    // 4. Write index.json
+    const indexJsonPath = path.join(l.orchestratorDir, "index.json");
+    await ensureDir(l.orchestratorDir);
+    // Remove the internal _ignoredCount before serializing
+    const toWrite = { ...index };
+    delete toWrite._ignoredCount;
+    await fs.writeFile(indexJsonPath, JSON.stringify(toWrite, null, 2) + "\n", "utf8");
+    // 5. Update marker sections in memory files
+    const repoMapPath = path.join(l.aiDir, "repo-map.md");
+    const fileIndexPath = path.join(l.aiDir, "file-index.md");
+    const repoMapBody = renderRepoMap(index);
+    const fileIndexBody = renderFileIndex(index);
+    await updateMarkerSection(repoMapPath, "index", repoMapBody);
+    await updateMarkerSection(fileIndexPath, "index", fileIndexBody);
+    const durationMs = Date.now() - t0;
+    return {
+        indexed: index.files.length,
+        ignored,
+        durationMs,
+        root,
+    };
+}
+export function formatIndexResult(result) {
+    const s = (result.durationMs / 1000).toFixed(1);
+    return `Indexed ${result.indexed} files (ignored ${result.ignored}) · ${s}s`;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,15 @@
+import { type ScaffoldReport } from "../core/memoryManager.js";
+export interface InitOptions {
+    cwd: string;
+    json?: boolean;
+}
+export interface InitReport {
+    root: string;
+    isGitRepo: boolean;
+    memory: ScaffoldReport;
+    configCreated: boolean;
+    gitignoreAppended: boolean;
+    warnings: string[];
+}
+export declare function runInit(opts: InitOptions): Promise<InitReport>;
+export declare function formatInitReport(report: InitReport): string;

package/dist/commands/init.js

@@ -0,0 +1,46 @@
+/**
+ * `localptp init` (HLD-SRD §3.4, §15 Test 1).
+ *
+ * Detect repo root (warn, don't fail, if no `.git`) → ensure dirs → Memory
+ * scaffold (write-if-absent) → write default config if absent → append the
+ * marker-guarded `.gitignore` stanza → return a created/preserved report.
+ * NEVER touches files outside `/ai`, `.ai-orchestrator`, and `.gitignore`.
+ */
+import { layout } from "../utils/paths.js";
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { appendGitignoreStanza } from "../utils/fs.js";
+import { MemoryManager } from "../core/memoryManager.js";
+import { ConfigManager } from "../core/configManager.js";
+export async function runInit(opts) {
+    const warnings = [];
+    const git = await detectGitRoot(opts.cwd);
+    if (!git.isRepo) {
+        warnings.push("This directory is not a Git repository. localptp will still scaffold, " +
+            "but Git-dependent safety features require a repo.");
+    }
+    const root = git.root ?? opts.cwd;
+    const l = layout(root);
+    const memory = await new MemoryManager(l).scaffold();
+    const configCreated = await new ConfigManager(l.configFile).writeDefaultIfAbsent();
+    const gitignoreAppended = await appendGitignoreStanza(l.gitignoreFile);
+    return {
+        root,
+        isGitRepo: git.isRepo,
+        memory,
+        configCreated,
+        gitignoreAppended,
+        warnings,
+    };
+}
+export function formatInitReport(report) {
+    const lines = [];
+    for (const w of report.warnings) {
+        lines.push(`warning: ${w}`);
+    }
+    lines.push(`Scaffolded localptp memory at ${report.root}`);
+    lines.push(`  memory files: ${report.memory.created.length} created, ${report.memory.preserved.length} preserved`);
+    lines.push(`  config.yml: ${report.configCreated ? "created" : "preserved"}`);
+    lines.push(`  .gitignore stanza: ${report.gitignoreAppended ? "appended" : "already present"}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAuB,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAgBzD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CACX,wEAAwE;YACtE,mDAAmD,CACtD,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrD,MAAM,aAAa,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACnF,MAAM,iBAAiB,GAAG,MAAM,qBAAqB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAEvE,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,MAAM;QACN,aAAa;QACb,iBAAiB;QACjB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,iCAAiC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CACR,mBAAmB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,aAAa,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,YAAY,CACvG,CAAC;IACF,KAAK,CAAC,IAAI,CACR,iBAAiB,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAClE,CAAC;IACF,KAAK,CAAC,IAAI,CACR,wBAAwB,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,EAAE,CACpF,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,17 @@
+import { type NormalizedPlan } from "../core/plannerJson.js";
+import type { ModelClient } from "../types/model.js";
+import type { AppConfig } from "../types/config.js";
+export interface PlanOptions {
+    cwd: string;
+    json?: boolean;
+    /** Injectable for tests; defaults to the real LM Studio client. */
+    clientFactory?: (config: AppConfig) => ModelClient;
+}
+export interface PlanResult {
+    plan: NormalizedPlan;
+    json: boolean;
+    taskPath: string;
+    sessionPath: string;
+}
+export declare function runPlan(opts: PlanOptions): Promise<PlanResult>;
+export declare function formatPlanResult(result: PlanResult): string;

package/dist/commands/plan.js

@@ -0,0 +1,170 @@
+/**
+ * `localptp plan` (HLD-SRD §3.9, §11.2, §12; CLI.md).
+ *
+ * The first command that calls the model for real work. Flow (writes happen
+ * ONLY after a valid plan exists, so a model/parse failure saves nothing):
+ *   1. Detect root + load config.
+ *   2. resolveActive() — none → "create a task" error; missing-target → advise
+ *      task/resume; ok → load the active task + session.
+ *   3. Load index (tolerant: empty if absent) + memory + file bodies.
+ *   4. buildContext({ role: 'planner', task, session }).
+ *   5. ModelClient.complete(planner system + rendered user). A §12
+ *      ModelClientError propagates unchanged (the CLI prints its message).
+ *   6. extractAndValidatePlannerJson(content) — failure → §11.2 stop.
+ *   7. setSubtasks into the task (task-first, the source of truth), then update
+ *      the session Current State / Next Step / Risks / Decisions(questions).
+ *   8. Return the validated plan; `--json` makes the CLI emit only the plan.
+ */
+import { promises as fs } from "node:fs";
+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, setSubtasks, serializeTask } from "../core/taskManager.js";
+import { loadSession, updateSession } from "../core/sessionManager.js";
+import { getPrompt } from "../core/promptManager.js";
+import { extractAndValidatePlannerJson, UnparseablePlanError, } from "../core/plannerJson.js";
+import { LmStudioClient } from "../core/modelClient.js";
+import { parseActiveTask, parseActiveSession } from "../types/context.js";
+import { repoIndexSchema } from "../types/index.js";
+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: [],
+};
+/** Load the repo index if present + valid, else an empty index (planning is tolerant). */
+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;
+    }
+}
+async function loadFileContents(root, index) {
+    const out = {};
+    for (const f of index.files) {
+        const rel = f.path.replace(/\\/g, "/");
+        try {
+            out[rel] = await fs.readFile(path.join(root, rel), "utf8");
+        }
+        catch {
+            // Omit unreadable/deleted files; planning degrades gracefully.
+        }
+    }
+    return out;
+}
+export async function runPlan(opts) {
+    const git = await detectGitRoot(opts.cwd);
+    const root = git.root ?? opts.cwd;
+    const l = layout(root);
+    // 1. Resolve the active task/session.
+    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 { taskPath, sessionPath } = active.pointer;
+    // 2. Load config, task, session.
+    const config = await new ConfigManager(l.configFile).load();
+    const task = await parseTask(taskPath);
+    const session = await loadSession(sessionPath);
+    // 3. Build the planner context (tolerant of a missing index).
+    const index = await loadIndex(l.orchestratorDir);
+    const memory = await loadMemoryFiles(root);
+    const fileContents = await loadFileContents(root, index);
+    const pkg = buildContext({
+        role: "planner",
+        config,
+        index,
+        memory,
+        task: parseActiveTask(task.raw),
+        session: parseActiveSession(session.raw),
+        fileContents,
+    });
+    // 4. Call the model. A §12 ModelClientError propagates unchanged — no writes
+    //    have happened yet, so nothing is saved.
+    const client = (opts.clientFactory ?? defaultClientFactory)(config);
+    const planner = getPrompt("planner");
+    const response = await client.complete({
+        role: "planner",
+        systemPrompt: planner.system,
+        userPrompt: planner.renderUser(pkg.userPrompt),
+    });
+    // 5. Extract + validate. Failure → §11.2 stop, nothing saved.
+    let plan;
+    try {
+        plan = extractAndValidatePlannerJson(response.content);
+    }
+    catch (err) {
+        if (err instanceof UnparseablePlanError) {
+            throw new CommandError("The model output could not be parsed into a valid plan. Nothing was saved. " +
+                "Try `localptp plan` again or narrow the task.");
+        }
+        throw err;
+    }
+    // 6. Persist — task first (source of truth for subtasks), then the session.
+    const subtasks = plan.subtasks.map((s) => ({
+        id: s.id,
+        title: s.title,
+        description: s.description,
+        status: "pending",
+        risk: s.risk,
+        likelyFiles: s.likelyFiles,
+        acceptanceCriteria: s.acceptanceCriteria,
+    }));
+    const edited = setSubtasks(task, subtasks);
+    await fs.writeFile(edited.path, serializeTask(edited), "utf8");
+    const first = plan.subtasks[0];
+    const decisions = plan.questions.map((q) => `Open question: ${q}`);
+    await updateSession(session, {
+        currentState: plan.summary,
+        nextStep: `${first.id}: ${first.title}`,
+        risks: plan.risks,
+        decisions,
+    });
+    return { plan, json: opts.json ?? false, taskPath, sessionPath };
+}
+export function formatPlanResult(result) {
+    const { plan } = result;
+    const lines = [`Plan (${plan.subtasks.length} subtasks):`];
+    for (const s of plan.subtasks) {
+        const risk = s.risk === "high" ? "HIGH" : s.risk;
+        lines.push(`  ${s.id}  ${s.title}   risk: ${risk}`);
+    }
+    if (plan.questions.length > 0) {
+        lines.push("Questions:");
+        for (const q of plan.questions)
+            lines.push(`  - ${q}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/resume.d.ts

@@ -0,0 +1,17 @@
+import type { Session } from "../types/session.js";
+export interface ResumeOptions {
+    cwd: string;
+    /** 1-based index into the newest-first list (CLI arg). */
+    index?: number;
+    json?: boolean;
+    /** Whether stdin is interactive; defaults to process.stdin.isTTY. */
+    isTTY?: boolean;
+    /** Injectable interactive picker (returns a 1-based index) for TTY runs. */
+    prompt?: (sessions: Session[]) => Promise<number | undefined>;
+}
+export interface ResumeResult {
+    sessions: Session[];
+    selected?: Session;
+}
+export declare function runResume(opts: ResumeOptions): Promise<ResumeResult>;
+export declare function formatResumeResult(result: ResumeResult): string;