localptp 0.1.0

package/dist/commands/summarize.js.map

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

package/dist/commands/task.d.ts

@@ -0,0 +1,13 @@
+export interface TaskOptions {
+    cwd: string;
+    text: string;
+    json?: boolean;
+}
+export interface TaskResult {
+    taskPath: string;
+    sessionPath: string;
+    title: string;
+    status: string;
+}
+export declare function runTask(opts: TaskOptions): Promise<TaskResult>;
+export declare function formatTaskResult(result: TaskResult): string;

package/dist/commands/task.js

@@ -0,0 +1,53 @@
+/**
+ * `localptp task "<text>"` (HLD-SRD §3.5, §3.6; CLI.md).
+ *
+ * Pure filesystem operation (no model call): create the §3.5 task file + §3.6
+ * session file, write the active pointer, and report the created paths +
+ * active status. Workflow:
+ *   1. Detect repo root.
+ *   2. createTask(tasksDir, text) → §3.5 file (collision-suffixed, no clobber).
+ *   3. createSession(sessionsDir, task) → §3.6 file referencing the task.
+ *   4. writeActive(orchestratorDir, { taskPath, sessionPath }).
+ *   5. Return the created paths.
+ */
+import { detectGitRoot } from "../utils/gitRoot.js";
+import { layout } from "../utils/paths.js";
+import { createTask } from "../core/taskManager.js";
+import { createSession } 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 runTask(opts) {
+    const text = opts.text.trim();
+    if (text.length === 0) {
+        throw new CommandError('Provide a task description, e.g. localptp task "Add severity levels to alerts".');
+    }
+    const git = await detectGitRoot(opts.cwd);
+    const l = layout(git.root ?? opts.cwd);
+    const task = await createTask(l.tasksDir, text);
+    const session = await createSession(l.sessionsDir, task);
+    await writeActive(l.orchestratorDir, {
+        taskPath: task.path,
+        sessionPath: session.path,
+    });
+    return {
+        taskPath: task.path,
+        sessionPath: session.path,
+        title: task.title,
+        status: task.status,
+    };
+}
+export function formatTaskResult(result) {
+    return [
+        `Created task    ${result.taskPath}`,
+        `Created session ${result.sessionPath}`,
+        `Status: ${result.status}`,
+    ].join("\n");
+}
+//# sourceMappingURL=task.js.map

package/dist/commands/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAevD,MAAM,YAAa,SAAQ,KAAK;IACrB,QAAQ,CAAS;IAC1B,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,YAAY,CACpB,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,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;IAEvC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,WAAW,CAAC,CAAC,CAAC,eAAe,EAAE;QACnC,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,WAAW,EAAE,OAAO,CAAC,IAAI;KAC1B,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,WAAW,EAAE,OAAO,CAAC,IAAI;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO;QACL,mBAAmB,MAAM,CAAC,QAAQ,EAAE;QACpC,mBAAmB,MAAM,CAAC,WAAW,EAAE;QACvC,WAAW,MAAM,CAAC,MAAM,EAAE;KAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/core/activePointer.d.ts

@@ -0,0 +1,28 @@
+export interface ActivePointer {
+    taskPath: string;
+    sessionPath: string;
+}
+/**
+ * Write the pointer atomically: write a uniquely-named temp file in the same
+ * directory, then rename over the target (rename is atomic on the same volume).
+ */
+export declare function writeActive(orchestratorDir: string, pointer: ActivePointer): Promise<void>;
+/** Read + parse the pointer, or undefined when absent/malformed. */
+export declare function readActive(orchestratorDir: string): Promise<ActivePointer | undefined>;
+export type ActiveResolution = {
+    kind: "none";
+} | {
+    kind: "missing-target";
+    pointer: ActivePointer;
+    missing: string[];
+} | {
+    kind: "ok";
+    pointer: ActivePointer;
+};
+/**
+ * Resolve the active pointer, verifying both referenced files exist on disk.
+ * - `none` — no pointer.
+ * - `missing-target` — pointer exists but a referenced file is gone.
+ * - `ok` — pointer and both files present.
+ */
+export declare function resolveActive(orchestratorDir: string): Promise<ActiveResolution>;

package/dist/core/activePointer.js

@@ -0,0 +1,84 @@
+/**
+ * Active pointer (`.ai-orchestrator/active.json`).
+ *
+ * Records the active `{ taskPath, sessionPath }` pair so downstream commands
+ * (`context`, `plan`, `step`, …) resolve the active work in O(1) without a
+ * newest-file heuristic. Written atomically (temp file + rename). A pointer to
+ * a deleted file is detected by `resolveActive` rather than crashing the caller.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { ensureDir, readIfExists } from "../utils/fs.js";
+const FILE_NAME = "active.json";
+function pointerPath(orchestratorDir) {
+    return path.join(orchestratorDir, FILE_NAME);
+}
+/**
+ * Write the pointer atomically: write a uniquely-named temp file in the same
+ * directory, then rename over the target (rename is atomic on the same volume).
+ */
+export async function writeActive(orchestratorDir, pointer) {
+    await ensureDir(orchestratorDir);
+    const target = pointerPath(orchestratorDir);
+    const tmp = path.join(orchestratorDir, `.${FILE_NAME}.${process.pid}.${Date.now()}.tmp`);
+    const content = JSON.stringify(pointer, null, 2) + "\n";
+    await fs.writeFile(tmp, content, "utf8");
+    try {
+        await fs.rename(tmp, target);
+    }
+    catch (err) {
+        // Best-effort cleanup if the rename failed.
+        await fs.rm(tmp, { force: true });
+        throw err;
+    }
+}
+/** Read + parse the pointer, or undefined when absent/malformed. */
+export async function readActive(orchestratorDir) {
+    const raw = await readIfExists(pointerPath(orchestratorDir));
+    if (raw === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        typeof parsed.taskPath !== "string" ||
+        typeof parsed.sessionPath !== "string") {
+        return undefined;
+    }
+    const { taskPath, sessionPath } = parsed;
+    return { taskPath, sessionPath };
+}
+async function exists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the active pointer, verifying both referenced files exist on disk.
+ * - `none` — no pointer.
+ * - `missing-target` — pointer exists but a referenced file is gone.
+ * - `ok` — pointer and both files present.
+ */
+export async function resolveActive(orchestratorDir) {
+    const pointer = await readActive(orchestratorDir);
+    if (pointer === undefined)
+        return { kind: "none" };
+    const missing = [];
+    if (!(await exists(pointer.taskPath)))
+        missing.push(pointer.taskPath);
+    if (!(await exists(pointer.sessionPath)))
+        missing.push(pointer.sessionPath);
+    if (missing.length > 0)
+        return { kind: "missing-target", pointer, missing };
+    return { kind: "ok", pointer };
+}
+//# sourceMappingURL=activePointer.js.map

package/dist/core/activePointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activePointer.js","sourceRoot":"","sources":["../../src/core/activePointer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOzD,MAAM,SAAS,GAAG,aAAa,CAAC;AAEhC,SAAS,WAAW,CAAC,eAAuB;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,eAAuB,EACvB,OAAsB;IAEtB,MAAM,SAAS,CAAC,eAAe,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,eAAe,EACf,IAAI,SAAS,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CACjD,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACxD,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4CAA4C;QAC5C,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,eAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC;IAC7D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAQ,MAAwB,CAAC,QAAQ,KAAK,QAAQ;QACtD,OAAQ,MAAwB,CAAC,WAAW,KAAK,QAAQ,EACzD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAuB,CAAC;IAC1D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC;AAOD,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,eAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC5E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/dist/core/approval.d.ts

@@ -0,0 +1,12 @@
+/** Resolves true to proceed, false to stop. The prompt is the question shown. */
+export type Approver = (prompt: string) => Promise<boolean>;
+/** Test/CI stub: always proceed. */
+export declare const autoApprove: Approver;
+/** Test/CI stub: always stop. */
+export declare const autoDeny: Approver;
+/**
+ * Real TTY prompt: ask `prompt` on stdin and resolve true for an affirmative
+ * answer (`y`/`yes`, case-insensitive). Any other answer — including EOF or a
+ * non-interactive stdin — resolves false (deny-by-default, the safe choice).
+ */
+export declare const ttyApprove: Approver;

package/dist/core/approval.js

@@ -0,0 +1,34 @@
+/**
+ * Approval seam (design.md assumption 2; CLI.md Safety).
+ *
+ * `Approver` is an injectable async predicate the `step` command awaits before
+ * applying a patch (and for each risky/delete confirmation). The seam keeps the
+ * whole flow deterministic and offline-testable: tests inject `autoApprove` /
+ * `autoDeny` or a custom stub; production uses `ttyApprove`, a readline yes/no
+ * prompt behind the same seam.
+ */
+import readline from "node:readline";
+/** Test/CI stub: always proceed. */
+export const autoApprove = async () => true;
+/** Test/CI stub: always stop. */
+export const autoDeny = async () => false;
+/**
+ * Real TTY prompt: ask `prompt` on stdin and resolve true for an affirmative
+ * answer (`y`/`yes`, case-insensitive). Any other answer — including EOF or a
+ * non-interactive stdin — resolves false (deny-by-default, the safe choice).
+ */
+export const ttyApprove = (prompt) => {
+    if (!process.stdin.isTTY)
+        return Promise.resolve(false);
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(`${prompt} [y/N] `, (answer) => {
+            rl.close();
+            resolve(/^\s*y(es)?\s*$/i.test(answer));
+        });
+    });
+};
+//# sourceMappingURL=approval.js.map

package/dist/core/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/core/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,QAAQ,MAAM,eAAe,CAAC;AAKrC,oCAAoC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAa,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;AAEtD,iCAAiC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAa,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAa,CAAC,MAAc,EAAE,EAAE;IACrD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,EAAE,CAAC,QAAQ,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACzC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/core/configManager.d.ts

@@ -0,0 +1,32 @@
+import { type AppConfig } from "../types/config.js";
+type Json = unknown;
+export declare function snakeToCamelKeys(value: Json): Json;
+export declare function camelToSnakeKeys(value: Json): Json;
+/**
+ * Coerce a string CLI value to boolean | number | string.
+ */
+export declare function coerceValue(value: string): boolean | number | string;
+export declare class ConfigManager {
+    private readonly configFile;
+    constructor(configFile: string);
+    /**
+     * Load and validate config, filling defaults. Throws a formatted error
+     * (field path + hint) on validation failure — never a raw stack.
+     */
+    load(): Promise<AppConfig>;
+    /**
+     * Validate and write a config object as snake_case YAML.
+     */
+    write(config: AppConfig): Promise<void>;
+    /**
+     * Write the default config only if no config file exists.
+     * Returns true if created, false if preserved.
+     */
+    writeDefaultIfAbsent(): Promise<boolean>;
+    /**
+     * Set one dotted (camelCase) key, coercing the value, re-validating, then
+     * writing. An invalid value is NOT written.
+     */
+    set(dottedKey: string, value: string): Promise<AppConfig>;
+}
+export {};

package/dist/core/configManager.js

@@ -0,0 +1,177 @@
+/**
+ * Config Manager (HLD-SRD §3.2, §9).
+ *
+ * - Defaults + validation live in the zod schema (single source of truth).
+ * - On load: read YAML (snake_case) → map to camelCase → zod-parse (fills defaults).
+ * - On write: map camelCase → snake_case → serialize with js-yaml.
+ * - `set(dottedKey, value)`: coerce, set on the merged object, re-validate, write.
+ * - Validation failures surface a `field.path: hint` message, never a raw stack.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+import { ZodError } from "zod";
+import { appConfigSchema } from "../types/config.js";
+import { readIfExists } from "../utils/fs.js";
+import { redactSecrets } from "../utils/logger.js";
+const FORBIDDEN_KEYS = new Set(["__proto__", "prototype", "constructor"]);
+function snakeToCamel(key) {
+    return key.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+function camelToSnake(key) {
+    return key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function mapKeysDeep(value, transform) {
+    if (Array.isArray(value)) {
+        return value.map((v) => mapKeysDeep(v, transform));
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            // Drop prototype-pollution keys from untrusted YAML before assignment so a
+            // malicious `__proto__`/`constructor`/`prototype` key cannot mutate a
+            // prototype during config load.
+            if (FORBIDDEN_KEYS.has(k))
+                continue;
+            const mapped = transform(k);
+            if (FORBIDDEN_KEYS.has(mapped))
+                continue;
+            Object.defineProperty(out, mapped, {
+                value: mapKeysDeep(v, transform),
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        return out;
+    }
+    return value;
+}
+export function snakeToCamelKeys(value) {
+    return mapKeysDeep(value, snakeToCamel);
+}
+export function camelToSnakeKeys(value) {
+    return mapKeysDeep(value, camelToSnake);
+}
+function formatZodError(err) {
+    const lines = err.issues.map((issue) => {
+        const where = issue.path.join(".") || "(root)";
+        return `  ${where}: ${issue.message}`;
+    });
+    return `Invalid configuration:\n${lines.join("\n")}`;
+}
+/**
+ * Coerce a string CLI value to boolean | number | string.
+ */
+export function coerceValue(value) {
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value.trim() !== "" && !Number.isNaN(Number(value))) {
+        return Number(value);
+    }
+    return value;
+}
+/**
+ * Set a dotted key on `obj`. Every segment must already exist on the object
+ * (no auto-vivification of unknown keys — that would let a typo silently write
+ * an orphan key the schema then strips). Rejects prototype-pollution segments.
+ * Throws if any segment is unknown.
+ */
+function setDottedPath(obj, dotted, value) {
+    const parts = dotted.split(".");
+    if (parts.some((p) => FORBIDDEN_KEYS.has(p) || p.length === 0)) {
+        throw new Error(`Invalid configuration key: ${dotted}`);
+    }
+    let cursor = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!isPlainObject(cursor[part])) {
+            throw new Error(`Unknown configuration key: ${dotted}`);
+        }
+        cursor = cursor[part];
+    }
+    const leaf = parts[parts.length - 1];
+    if (!Object.prototype.hasOwnProperty.call(cursor, leaf)) {
+        throw new Error(`Unknown configuration key: ${dotted}`);
+    }
+    cursor[leaf] = value;
+}
+export class ConfigManager {
+    configFile;
+    constructor(configFile) {
+        this.configFile = configFile;
+    }
+    /**
+     * Load and validate config, filling defaults. Throws a formatted error
+     * (field path + hint) on validation failure — never a raw stack.
+     */
+    async load() {
+        const raw = await readIfExists(this.configFile);
+        let parsed = {};
+        if (raw !== undefined && raw.trim().length > 0) {
+            try {
+                parsed = yaml.load(raw) ?? {};
+            }
+            catch (err) {
+                // js-yaml errors embed a snippet of the offending YAML, which can carry
+                // a secret (e.g. `api_key: ...`). Redact before surfacing to stderr.
+                throw new Error(redactSecrets(`Invalid YAML in ${this.configFile}: ${err.message}`));
+            }
+        }
+        const camel = snakeToCamelKeys(parsed);
+        const result = appConfigSchema.safeParse(camel);
+        if (!result.success) {
+            throw new Error(formatZodError(result.error));
+        }
+        return result.data;
+    }
+    /**
+     * Validate and write a config object as snake_case YAML.
+     */
+    async write(config) {
+        const validated = appConfigSchema.parse(config);
+        const snake = camelToSnakeKeys(validated);
+        const text = yaml.dump(snake, { lineWidth: -1 });
+        await fs.mkdir(path.dirname(this.configFile), { recursive: true });
+        await fs.writeFile(this.configFile, text, "utf8");
+    }
+    /**
+     * Write the default config only if no config file exists.
+     * Returns true if created, false if preserved.
+     */
+    async writeDefaultIfAbsent() {
+        const existing = await readIfExists(this.configFile);
+        if (existing !== undefined) {
+            return false;
+        }
+        const defaults = appConfigSchema.parse({});
+        await this.write(defaults);
+        return true;
+    }
+    /**
+     * Set one dotted (camelCase) key, coercing the value, re-validating, then
+     * writing. An invalid value is NOT written.
+     */
+    async set(dottedKey, value) {
+        const current = await this.load();
+        const coerced = coerceValue(value);
+        const draft = structuredClone(current);
+        setDottedPath(draft, dottedKey, coerced);
+        const result = appConfigSchema.safeParse(draft);
+        if (!result.success) {
+            // Filter to issues under the edited key for a focused message; fall back
+            // to the full error if the path does not line up.
+            const focused = new ZodError(result.error.issues.filter((i) => i.path.join(".") === dottedKey));
+            const err = focused.issues.length > 0 ? focused : result.error;
+            throw new Error(formatZodError(err));
+        }
+        await this.write(result.data);
+        return result.data;
+    }
+}
+//# sourceMappingURL=configManager.js.map

package/dist/core/configManager.js.map

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

package/dist/core/contextBuilder.d.ts

@@ -0,0 +1,40 @@
+import { type ActiveTask, type ActiveSession, type ContextPackage } from "../types/context.js";
+import type { AgentRole } from "../types/model.js";
+import type { AppConfig } from "../types/config.js";
+import type { RepoFile, RepoIndex } from "../types/index.js";
+import type { MemoryFiles } from "./memoryLoader.js";
+export interface ContextInputs {
+    role: AgentRole;
+    config: AppConfig;
+    index: RepoIndex;
+    memory: MemoryFiles;
+    task?: ActiveTask;
+    session?: ActiveSession;
+    /** repo-relative POSIX path → body, preloaded by the caller. */
+    fileContents: Record<string, string>;
+}
+/**
+ * The import-neighbor source files of a set of seed files: every indexed file
+ * a seed's `imports[]` resolves to (by suffix match), excluding the seeds
+ * themselves. Deterministic: sorted by size asc then path asc.
+ */
+export declare function importNeighbors(seedFiles: string[], index: RepoIndex): string[];
+/**
+ * A no-model summary: an index header (path/language/exports/size) followed by
+ * the file's first 20 non-blank lines.
+ */
+export declare function summarizeFile(entry: RepoFile, body: string): string;
+/**
+ * A snippet: the first `floor(maxChars / 2)` characters plus a truncation
+ * marker. Bodies already at-or-under the snippet size are returned unchanged.
+ */
+export declare function snippetFile(body: string, maxChars: number): string;
+interface Selection {
+    editFiles: string[];
+    sourceFiles: string[];
+    testFiles: string[];
+    warnings: string[];
+}
+export declare function selectFiles(inputs: ContextInputs): Selection;
+export declare function buildContext(inputs: ContextInputs): ContextPackage;
+export {};