localptp 0.1.0

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;CAC/B,CAAC,CAAC"}

package/dist/types/model.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Model client types — the single swappable provider seam (HLD-SRD §3.8, §9).
+ */
+export type AgentRole = "planner" | "retriever" | "coder" | "reviewer" | "test-fixer" | "summarizer";
+export interface ModelRequest {
+    role: AgentRole;
+    systemPrompt: string;
+    userPrompt: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface ModelResponse {
+    content: string;
+    raw?: unknown;
+}
+export interface HealthResult {
+    reachable: boolean;
+    models?: string[];
+    error?: string;
+}
+export interface ModelClient {
+    complete(request: ModelRequest): Promise<ModelResponse>;
+    health(): Promise<HealthResult>;
+}
+/**
+ * The distinct §12 failure kinds. Callers (e.g. `doctor`) branch on `kind`
+ * instead of string-matching messages.
+ */
+export type ModelClientErrorKind = "refused" | "timeout" | "model-not-loaded" | "empty" | "malformed";
+export declare class ModelClientError extends Error {
+    readonly kind: ModelClientErrorKind;
+    readonly baseUrl: string;
+    readonly cause?: unknown;
+    constructor(kind: ModelClientErrorKind, message: string, baseUrl: string, cause?: unknown);
+}

package/dist/types/model.js

@@ -0,0 +1,16 @@
+/**
+ * Model client types — the single swappable provider seam (HLD-SRD §3.8, §9).
+ */
+export class ModelClientError extends Error {
+    kind;
+    baseUrl;
+    cause;
+    constructor(kind, message, baseUrl, cause) {
+        super(message);
+        this.name = "ModelClientError";
+        this.kind = kind;
+        this.baseUrl = baseUrl;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/types/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/types/model.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6CH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,OAAO,CAAS;IACP,KAAK,CAAW;IAElC,YACE,IAA0B,EAC1B,OAAe,EACf,OAAe,EACf,KAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/types/patch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Patch + safety types (HLD-SRD §3.10, §11, §13; design.md "Data contracts").
+ *
+ * `PatchPlan` is the parsed, classified view of a single unified diff: the set
+ * of touched repo-relative paths split by operation (add / modify / delete),
+ * a binary flag, and the raw diff text retained for `git apply`. The Safety
+ * Manager turns a `PatchPlan` + config into a `SafetyVerdict` — a PURE decision
+ * (`allow` | `refuse`) plus any extra confirmations the command must prompt for.
+ */
+/** A parsed, classified unified diff. */
+export interface PatchPlan {
+    /** Every repo-relative POSIX path the diff touches (adds ∪ modifies ∪ deletes). */
+    touchedFiles: string[];
+    /** Paths the diff creates (no prior file). */
+    adds: string[];
+    /** Paths the diff edits in place. */
+    modifies: string[];
+    /** Paths the diff removes. */
+    deletes: string[];
+    /** True when any file section is a binary patch (`GIT binary patch`). */
+    isBinary: boolean;
+    /** The raw unified diff text (what `git apply` consumes). */
+    diff: string;
+}
+export type SafetyDecision = "allow" | "refuse";
+/** The extra interactive confirmations a patch requires before applying. */
+export type SafetyConfirm = "risky-path" | "delete";
+/**
+ * The pure outcome of `safetyManager.evaluate`. `refuse` stops the step with
+ * the matching §11/§13 reason; `allow` may still carry `needsConfirm` prompts
+ * the command turns into explicit confirmations.
+ */
+export interface SafetyVerdict {
+    decision: SafetyDecision;
+    needsConfirm: SafetyConfirm[];
+    /** Human-readable messages keyed to §11/§13 (one per triggered rule). */
+    reasons: string[];
+}

package/dist/types/patch.js

@@ -0,0 +1,11 @@
+/**
+ * Patch + safety types (HLD-SRD §3.10, §11, §13; design.md "Data contracts").
+ *
+ * `PatchPlan` is the parsed, classified view of a single unified diff: the set
+ * of touched repo-relative paths split by operation (add / modify / delete),
+ * a binary flag, and the raw diff text retained for `git apply`. The Safety
+ * Manager turns a `PatchPlan` + config into a `SafetyVerdict` — a PURE decision
+ * (`allow` | `refuse`) plus any extra confirmations the command must prompt for.
+ */
+export {};
+//# sourceMappingURL=patch.js.map

package/dist/types/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/types/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/types/plan.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Planner output schema (HLD-SRD §3.9).
+ *
+ * The model is asked to return `{ summary, subtasks[…], risks, questions }`.
+ * The schema is strict on shape (a subtask MUST carry a `title`; at least one
+ * subtask is required) but tolerant on optional fields (defaults fill omitted
+ * `description`/`likelyFiles`/`acceptanceCriteria`/`risks`/`questions`). The
+ * subtask `id` and `risk` are validated loosely here and normalized after
+ * parse (id → `step-N`, risk → `low|medium|high`).
+ */
+import { z } from "zod";
+export declare const plannerSubtaskSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    risk: z.ZodOptional<z.ZodString>;
+    likelyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    acceptanceCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    likelyFiles: string[];
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    id?: string | undefined;
+    risk?: string | undefined;
+}, {
+    title: string;
+    likelyFiles?: string[] | undefined;
+    id?: string | undefined;
+    description?: string | undefined;
+    risk?: string | undefined;
+    acceptanceCriteria?: string[] | undefined;
+}>;
+export declare const plannerSchema: z.ZodObject<{
+    summary: z.ZodString;
+    subtasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodString>;
+        risk: z.ZodOptional<z.ZodString>;
+        likelyFiles: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        acceptanceCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        likelyFiles: string[];
+        title: string;
+        description: string;
+        acceptanceCriteria: string[];
+        id?: string | undefined;
+        risk?: string | undefined;
+    }, {
+        title: string;
+        likelyFiles?: string[] | undefined;
+        id?: string | undefined;
+        description?: string | undefined;
+        risk?: string | undefined;
+        acceptanceCriteria?: string[] | undefined;
+    }>, "many">;
+    risks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    questions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    subtasks: {
+        likelyFiles: string[];
+        title: string;
+        description: string;
+        acceptanceCriteria: string[];
+        id?: string | undefined;
+        risk?: string | undefined;
+    }[];
+    risks: string[];
+    questions: string[];
+}, {
+    summary: string;
+    subtasks: {
+        title: string;
+        likelyFiles?: string[] | undefined;
+        id?: string | undefined;
+        description?: string | undefined;
+        risk?: string | undefined;
+        acceptanceCriteria?: string[] | undefined;
+    }[];
+    risks?: string[] | undefined;
+    questions?: string[] | undefined;
+}>;
+export type PlannerPlan = z.infer<typeof plannerSchema>;
+export type PlannerSubtask = z.infer<typeof plannerSubtaskSchema>;

package/dist/types/plan.js

@@ -0,0 +1,27 @@
+/**
+ * Planner output schema (HLD-SRD §3.9).
+ *
+ * The model is asked to return `{ summary, subtasks[…], risks, questions }`.
+ * The schema is strict on shape (a subtask MUST carry a `title`; at least one
+ * subtask is required) but tolerant on optional fields (defaults fill omitted
+ * `description`/`likelyFiles`/`acceptanceCriteria`/`risks`/`questions`). The
+ * subtask `id` and `risk` are validated loosely here and normalized after
+ * parse (id → `step-N`, risk → `low|medium|high`).
+ */
+import { z } from "zod";
+export const plannerSubtaskSchema = z.object({
+    id: z.string().optional(),
+    title: z.string(),
+    description: z.string().default(""),
+    // Normalized post-parse to low|medium|high (default medium).
+    risk: z.string().optional(),
+    likelyFiles: z.array(z.string()).default([]),
+    acceptanceCriteria: z.array(z.string()).default([]),
+});
+export const plannerSchema = z.object({
+    summary: z.string(),
+    subtasks: z.array(plannerSubtaskSchema).min(1),
+    risks: z.array(z.string()).default([]),
+    questions: z.array(z.string()).default([]),
+});
+//# sourceMappingURL=plan.js.map

package/dist/types/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,6DAA6D;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3C,CAAC,CAAC"}

package/dist/types/review.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Review report type + schema (HLD-SRD §3.12; 0001_06).
+ *
+ * The advisory `review` command asks the model for a structured report and
+ * tolerantly extracts it. The schema mirrors the §3.12 shape; every array
+ * defaults to `[]` and the two strings default to `""` so a partial or
+ * key-light model response still validates into a complete, printable report.
+ * Array members that are not strings are dropped (tolerant of local-model noise).
+ */
+import { z } from "zod";
+export declare const reviewReportSchema: z.ZodObject<{
+    summary: z.ZodDefault<z.ZodString>;
+    blocking: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, string[], unknown[]>>;
+    nonBlocking: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, string[], unknown[]>>;
+    missingTests: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, string[], unknown[]>>;
+    scopeCreep: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, string[], unknown[]>>;
+    recommendation: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    blocking: string[];
+    nonBlocking: string[];
+    missingTests: string[];
+    scopeCreep: string[];
+    recommendation: string;
+}, {
+    summary?: string | undefined;
+    blocking?: unknown[] | undefined;
+    nonBlocking?: unknown[] | undefined;
+    missingTests?: unknown[] | undefined;
+    scopeCreep?: unknown[] | undefined;
+    recommendation?: string | undefined;
+}>;
+export type ReviewReport = z.infer<typeof reviewReportSchema>;

package/dist/types/review.js

@@ -0,0 +1,24 @@
+/**
+ * Review report type + schema (HLD-SRD §3.12; 0001_06).
+ *
+ * The advisory `review` command asks the model for a structured report and
+ * tolerantly extracts it. The schema mirrors the §3.12 shape; every array
+ * defaults to `[]` and the two strings default to `""` so a partial or
+ * key-light model response still validates into a complete, printable report.
+ * Array members that are not strings are dropped (tolerant of local-model noise).
+ */
+import { z } from "zod";
+/** A string-array field that tolerantly drops non-string members and defaults []. */
+const stringArray = z
+    .array(z.unknown())
+    .transform((arr) => arr.filter((x) => typeof x === "string"))
+    .default([]);
+export const reviewReportSchema = z.object({
+    summary: z.string().default(""),
+    blocking: stringArray,
+    nonBlocking: stringArray,
+    missingTests: stringArray,
+    scopeCreep: stringArray,
+    recommendation: z.string().default(""),
+});
+//# sourceMappingURL=review.js.map

package/dist/types/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/types/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qFAAqF;AACrF,MAAM,WAAW,GAAG,CAAC;KAClB,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KAClB,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;KACzE,OAAO,CAAC,EAAE,CAAC,CAAC;AAEf,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,WAAW;IACzB,UAAU,EAAE,WAAW;IACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACvC,CAAC,CAAC"}

package/dist/types/run.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Run-loop types (HLD-SRD §3.13, §11.2; 0001_06).
+ *
+ * `StopReason` is the closed set of named reasons the run loop can stop for —
+ * one per §11.2 condition plus the hard iteration-cap guard. `StepOutcome` is
+ * the structured result of one `runStep` invocation that the pure `decideStop`
+ * function reasons over; `LoopState` is the loop's accumulated bookkeeping.
+ */
+import type { TestResult } from "./test.js";
+/**
+ * The closed set of reasons the `run` loop stops. Each maps to an HLD-SRD §11.2
+ * condition; `iteration-cap-exceeded` is the loop's own hard infinite-loop guard.
+ */
+export type StopReason = "risky-change" | "repeated-failure" | "acceptance-met" | "unparseable-output" | "needs-context" | "budget-exceeded" | "unsafe-tree" | "model-unavailable" | "approval-denied" | "patch-invalid" | "broad-rewrite-requested" | "iteration-cap-exceeded";
+/**
+ * The structured result of one `runStep` invocation. `subtaskId` is null when
+ * there was no pending subtask (task complete). `applied` is true once a patch
+ * (coder or fix) reached the working tree. `stopReason` is set when the step
+ * itself hit a stop condition (safety refusal, approval denied, unparseable,
+ * etc.) that `decideStop` bubbles up. `fixAttempts` counts test-fix iterations.
+ */
+export interface StepOutcome {
+    subtaskId: string | null;
+    applied: boolean;
+    stopReason?: StopReason;
+    testResults: TestResult[];
+    fixAttempts: number;
+}
+/** Accumulated run-loop bookkeeping across iterations. */
+export interface LoopState {
+    iterations: number;
+    consecutiveFailures: number;
+    filesChanged: number;
+}

package/dist/types/run.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run.js.map

package/dist/types/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/types/run.ts"],"names":[],"mappings":""}

package/dist/types/session.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Session type (HLD-SRD §3.6).
+ *
+ * A `Session` is the parsed view of a `/ai/sessions/*.md` file. It references
+ * its task (`taskPath`) and tracks the working state the user resumes from.
+ * `raw` is retained so the Session Manager can rewrite individual sections
+ * without losing other content.
+ */
+import type { TaskStatus } from "./task.js";
+export interface Session {
+    /** Absolute path of the session file on disk. */
+    path: string;
+    /** Path of the task this session is working on. */
+    taskPath: string;
+    status: TaskStatus;
+    objective: string;
+    currentState: string;
+    nextStep: string;
+    /** The original markdown, retained verbatim. */
+    raw: string;
+}

package/dist/types/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":""}

package/dist/types/summary.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Summarizer output schema (HLD-SRD §3.9, 0001_07).
+ *
+ * The model is asked to return:
+ *   { sessionUpdate{currentState, filesChanged[], decisions[], risks[]},
+ *     memoryUpdates[{changeType, content}],
+ *     nextStep }
+ *
+ * All fields use defaults so a partial response still yields a usable object.
+ */
+import { z } from "zod";
+export declare const summarizerSchema: z.ZodObject<{
+    sessionUpdate: z.ZodDefault<z.ZodObject<{
+        currentState: z.ZodDefault<z.ZodString>;
+        filesChanged: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        risks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        currentState: string;
+        risks: string[];
+        filesChanged: string[];
+        decisions: string[];
+    }, {
+        currentState?: string | undefined;
+        risks?: string[] | undefined;
+        filesChanged?: string[] | undefined;
+        decisions?: string[] | undefined;
+    }>>;
+    memoryUpdates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        changeType: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        changeType: string;
+    }, {
+        content: string;
+        changeType: string;
+    }>, "many">>;
+    nextStep: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    nextStep: string;
+    sessionUpdate: {
+        currentState: string;
+        risks: string[];
+        filesChanged: string[];
+        decisions: string[];
+    };
+    memoryUpdates: {
+        content: string;
+        changeType: string;
+    }[];
+}, {
+    nextStep?: string | undefined;
+    sessionUpdate?: {
+        currentState?: string | undefined;
+        risks?: string[] | undefined;
+        filesChanged?: string[] | undefined;
+        decisions?: string[] | undefined;
+    } | undefined;
+    memoryUpdates?: {
+        content: string;
+        changeType: string;
+    }[] | undefined;
+}>;
+export type SummarizerOutput = z.infer<typeof summarizerSchema>;

package/dist/types/summary.js

@@ -0,0 +1,26 @@
+/**
+ * Summarizer output schema (HLD-SRD §3.9, 0001_07).
+ *
+ * The model is asked to return:
+ *   { sessionUpdate{currentState, filesChanged[], decisions[], risks[]},
+ *     memoryUpdates[{changeType, content}],
+ *     nextStep }
+ *
+ * All fields use defaults so a partial response still yields a usable object.
+ */
+import { z } from "zod";
+export const summarizerSchema = z.object({
+    sessionUpdate: z
+        .object({
+        currentState: z.string().default(""),
+        filesChanged: z.array(z.string()).default([]),
+        decisions: z.array(z.string()).default([]),
+        risks: z.array(z.string()).default([]),
+    })
+        .default({}),
+    memoryUpdates: z
+        .array(z.object({ changeType: z.string(), content: z.string() }))
+        .default([]),
+    nextStep: z.string().default(""),
+});
+//# sourceMappingURL=summary.js.map

package/dist/types/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/types/summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KACvC,CAAC;SACD,OAAO,CAAC,EAAE,CAAC;IACd,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SAChE,OAAO,CAAC,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC,CAAC,CAAC"}

package/dist/types/task.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Task types (HLD-SRD §3.5).
+ *
+ * A `Task` is the parsed view of a `/ai/tasks/*.md` file: a title, lifecycle
+ * status, the free-form goal, and an ordered list of `step-N` subtasks. The
+ * `raw` markdown is retained so the Task Manager can rewrite only the
+ * `## Subtasks` block without losing other user content.
+ */
+export type TaskStatus = "active" | "done" | "blocked";
+export type SubtaskStatus = "pending" | "active" | "done" | "blocked";
+export type Risk = "low" | "medium" | "high";
+export interface Subtask {
+    /** Positional id, normalized to `step-N` (1-based) by the planner. */
+    id: string;
+    title: string;
+    description: string;
+    status: SubtaskStatus;
+    risk: Risk;
+    likelyFiles: string[];
+    acceptanceCriteria?: string[];
+}
+export interface Task {
+    /** Absolute path of the task file on disk. */
+    path: string;
+    title: string;
+    status: TaskStatus;
+    goal: string;
+    subtasks: Subtask[];
+    /** The original markdown, retained verbatim. */
+    raw: string;
+}

package/dist/types/task.js

@@ -0,0 +1,10 @@
+/**
+ * Task types (HLD-SRD §3.5).
+ *
+ * A `Task` is the parsed view of a `/ai/tasks/*.md` file: a title, lifecycle
+ * status, the free-form goal, and an ordered list of `step-N` subtasks. The
+ * `raw` markdown is retained so the Task Manager can rewrite only the
+ * `## Subtasks` block without losing other user content.
+ */
+export {};
+//# sourceMappingURL=task.js.map

package/dist/types/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types/test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test Runner result type (HLD-SRD §3.11).
+ *
+ * The captured outcome of one configured test command. Report-only this slice:
+ * the runner never retries and a non-zero `exitCode` never rolls back the patch.
+ */
+export interface TestResult {
+    /** The command line as displayed (e.g. `npm test`). */
+    command: string;
+    /** Process exit code; 0 = pass. */
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    /** Wall-clock duration of the command, milliseconds. */
+    durationMs: number;
+}

package/dist/types/test.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.js.map

package/dist/types/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/types/test.ts"],"names":[],"mappings":""}

package/dist/utils/fs.d.ts

@@ -0,0 +1,13 @@
+export declare const GITIGNORE_MARKER = "# localcoder";
+export declare function ensureDir(dir: string): Promise<void>;
+/**
+ * Write `content` to `file` only if it does not already exist.
+ * Returns true if the file was created, false if it was preserved.
+ */
+export declare function writeIfAbsent(file: string, content: string): Promise<boolean>;
+export declare function readIfExists(file: string): Promise<string | undefined>;
+/**
+ * Append the localcoder `.gitignore` stanza unless its marker is already present.
+ * Returns true if the stanza was appended, false if it was already there.
+ */
+export declare function appendGitignoreStanza(gitignoreFile: string): Promise<boolean>;

package/dist/utils/fs.js

@@ -0,0 +1,65 @@
+/**
+ * Filesystem helpers: idempotent dir creation, write-if-absent (no clobber),
+ * read-if-exists, and a marker-guarded `.gitignore` stanza appender.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export const GITIGNORE_MARKER = "# localcoder";
+const GITIGNORE_STANZA = `${GITIGNORE_MARKER}
+.ai-orchestrator/logs/
+.ai-orchestrator/context-packages/
+`;
+export async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * Write `content` to `file` only if it does not already exist.
+ * Returns true if the file was created, false if it was preserved.
+ */
+export async function writeIfAbsent(file, content) {
+    await ensureDir(path.dirname(file));
+    try {
+        // wx fails if the path exists — atomic no-clobber.
+        await fs.writeFile(file, content, { encoding: "utf8", flag: "wx" });
+        return true;
+    }
+    catch (err) {
+        if (err.code === "EEXIST") {
+            return false;
+        }
+        throw err;
+    }
+}
+export async function readIfExists(file) {
+    try {
+        return await fs.readFile(file, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return undefined;
+        }
+        throw err;
+    }
+}
+/**
+ * Append the localcoder `.gitignore` stanza unless its marker is already present.
+ * Returns true if the stanza was appended, false if it was already there.
+ */
+export async function appendGitignoreStanza(gitignoreFile) {
+    const existing = await readIfExists(gitignoreFile);
+    if (existing !== undefined && existing.includes(GITIGNORE_MARKER)) {
+        return false;
+    }
+    let next;
+    if (existing === undefined || existing.length === 0) {
+        next = GITIGNORE_STANZA;
+    }
+    else {
+        const sep = existing.endsWith("\n") ? "\n" : "\n\n";
+        next = existing + sep + GITIGNORE_STANZA;
+    }
+    await ensureDir(path.dirname(gitignoreFile));
+    await fs.writeFile(gitignoreFile, next, "utf8");
+    return true;
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C,MAAM,gBAAgB,GAAG,GAAG,gBAAgB;;;CAG3C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAAe;IAEf,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,mDAAmD;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAAqB;IAErB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAY,CAAC;IACjB,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,gBAAgB,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACpD,IAAI,GAAG,QAAQ,GAAG,GAAG,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IACD,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/gitRoot.d.ts

@@ -0,0 +1,5 @@
+export interface GitRootResult {
+    isRepo: boolean;
+    root?: string;
+}
+export declare function detectGitRoot(cwd: string): Promise<GitRootResult>;

package/dist/utils/gitRoot.js

@@ -0,0 +1,21 @@
+/**
+ * Repo-root detection (HLD-SRD §3.1). Warn — never fail — when the directory is
+ * not a Git repo; later Git-dependent safety features require `.git`, this slice
+ * does not.
+ */
+import { simpleGit } from "simple-git";
+export async function detectGitRoot(cwd) {
+    const git = simpleGit(cwd);
+    try {
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo) {
+            return { isRepo: false };
+        }
+        const root = (await git.revparse(["--show-toplevel"])).trim();
+        return { isRepo: true, root };
+    }
+    catch {
+        return { isRepo: false };
+    }
+}
+//# sourceMappingURL=gitRoot.js.map