localptp 0.1.0

package/dist/templates/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/templates/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY;IACpD,OAAO;QACL,IAAI;QACJ,MAAM,CAAC,SAAiB;YACtB,OAAO,KAAK,KAAK,qBAAqB,SAAS,OAAO,IAAI,IAAI,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,GAAG,CACD,kBAAkB,EAClB,eAAe,EACf,gHAAgH,CACjH;IACD,GAAG,CACD,aAAa,EACb,UAAU,EACV,oIAAoI,CACrI;IACD,GAAG,CACD,iBAAiB,EACjB,cAAc,EACd,yDAAyD,CAC1D;IACD,GAAG,CACD,eAAe,EACf,YAAY,EACZ,mGAAmG,CACpG;IACD,GAAG,CACD,eAAe,EACf,YAAY,EACZ,iDAAiD,CAClD;IACD,GAAG,CACD,YAAY,EACZ,SAAS,EACT,0EAA0E,CAC3E;IACD,GAAG,CACD,0BAA0B,EAC1B,uBAAuB,EACvB,yEAAyE,CAC1E;IACD,GAAG,CACD,iBAAiB,EACjB,cAAc,EACd,qJAAqJ,CACtJ;IACD,GAAG,CACD,cAAc,EACd,WAAW,EACX,4EAA4E,CAC7E;IACD,GAAG,CACD,iBAAiB,EACjB,cAAc,EACd,8CAA8C,CAC/C;IACD,GAAG,CACD,cAAc,EACd,WAAW,EACX,+FAA+F,CAChG;IACD,GAAG,CACD,yBAAyB,EACzB,sBAAsB,EACtB,8HAA8H,CAC/H;IACD,GAAG,CACD,kBAAkB,EAClB,eAAe,EACf,iKAAiK,CAClK;IACD,GAAG,CACD,kBAAkB,EAClB,eAAe,EACf,yJAAyJ,CAC1J;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAa,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/config.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Config schema — single source of truth for shape AND defaults (HLD-SRD §3.2, §9).
+ *
+ * Every field carries a `.default(...)` so an absent/empty config still parses
+ * to the full HLD-SRD §3.2 object. `AppConfig` is inferred from the schema.
+ */
+import { z } from "zod";
+export declare const modelConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodLiteral<"lmstudio">>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    apiKey: z.ZodDefault<z.ZodString>;
+    temperature: z.ZodDefault<z.ZodNumber>;
+    maxContextTokens: z.ZodDefault<z.ZodNumber>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    provider: "lmstudio";
+    baseUrl: string;
+    model: string;
+    apiKey: string;
+    temperature: number;
+    maxContextTokens: number;
+    timeoutMs: number;
+}, {
+    provider?: "lmstudio" | undefined;
+    baseUrl?: string | undefined;
+    model?: string | undefined;
+    apiKey?: string | undefined;
+    temperature?: number | undefined;
+    maxContextTokens?: number | undefined;
+    timeoutMs?: number | undefined;
+}>;
+export declare const contextConfigSchema: z.ZodObject<{
+    maxContextChars: z.ZodDefault<z.ZodNumber>;
+    maxFilesPerStep: z.ZodDefault<z.ZodNumber>;
+    maxEditFilesPerStep: z.ZodDefault<z.ZodNumber>;
+    maxFileChars: z.ZodDefault<z.ZodNumber>;
+    includeTests: z.ZodDefault<z.ZodBoolean>;
+    includeImportNeighbors: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    maxContextChars: number;
+    maxFilesPerStep: number;
+    maxEditFilesPerStep: number;
+    maxFileChars: number;
+    includeTests: boolean;
+    includeImportNeighbors: boolean;
+}, {
+    maxContextChars?: number | undefined;
+    maxFilesPerStep?: number | undefined;
+    maxEditFilesPerStep?: number | undefined;
+    maxFileChars?: number | undefined;
+    includeTests?: boolean | undefined;
+    includeImportNeighbors?: boolean | undefined;
+}>;
+export declare const safetyConfigSchema: z.ZodObject<{
+    requireApproval: z.ZodDefault<z.ZodBoolean>;
+    maxFailedFixAttempts: z.ZodDefault<z.ZodNumber>;
+    maxChangedFilesPerStep: z.ZodDefault<z.ZodNumber>;
+    riskyPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    requireApproval: boolean;
+    maxFailedFixAttempts: number;
+    maxChangedFilesPerStep: number;
+    riskyPaths: string[];
+}, {
+    requireApproval?: boolean | undefined;
+    maxFailedFixAttempts?: number | undefined;
+    maxChangedFilesPerStep?: number | undefined;
+    riskyPaths?: string[] | undefined;
+}>;
+export declare const commandConfigSchema: z.ZodObject<{
+    typecheck: z.ZodDefault<z.ZodString>;
+    lint: z.ZodDefault<z.ZodString>;
+    test: z.ZodDefault<z.ZodString>;
+    build: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    typecheck: string;
+    lint: string;
+    test: string;
+    build: string;
+}, {
+    typecheck?: string | undefined;
+    lint?: string | undefined;
+    test?: string | undefined;
+    build?: string | undefined;
+}>;
+export declare const appConfigSchema: z.ZodObject<{
+    model: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodLiteral<"lmstudio">>;
+        baseUrl: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        apiKey: z.ZodDefault<z.ZodString>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+        maxContextTokens: z.ZodDefault<z.ZodNumber>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "lmstudio";
+        baseUrl: string;
+        model: string;
+        apiKey: string;
+        temperature: number;
+        maxContextTokens: number;
+        timeoutMs: number;
+    }, {
+        provider?: "lmstudio" | undefined;
+        baseUrl?: string | undefined;
+        model?: string | undefined;
+        apiKey?: string | undefined;
+        temperature?: number | undefined;
+        maxContextTokens?: number | undefined;
+        timeoutMs?: number | undefined;
+    }>>;
+    context: z.ZodDefault<z.ZodObject<{
+        maxContextChars: z.ZodDefault<z.ZodNumber>;
+        maxFilesPerStep: z.ZodDefault<z.ZodNumber>;
+        maxEditFilesPerStep: z.ZodDefault<z.ZodNumber>;
+        maxFileChars: z.ZodDefault<z.ZodNumber>;
+        includeTests: z.ZodDefault<z.ZodBoolean>;
+        includeImportNeighbors: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        maxContextChars: number;
+        maxFilesPerStep: number;
+        maxEditFilesPerStep: number;
+        maxFileChars: number;
+        includeTests: boolean;
+        includeImportNeighbors: boolean;
+    }, {
+        maxContextChars?: number | undefined;
+        maxFilesPerStep?: number | undefined;
+        maxEditFilesPerStep?: number | undefined;
+        maxFileChars?: number | undefined;
+        includeTests?: boolean | undefined;
+        includeImportNeighbors?: boolean | undefined;
+    }>>;
+    safety: z.ZodDefault<z.ZodObject<{
+        requireApproval: z.ZodDefault<z.ZodBoolean>;
+        maxFailedFixAttempts: z.ZodDefault<z.ZodNumber>;
+        maxChangedFilesPerStep: z.ZodDefault<z.ZodNumber>;
+        riskyPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requireApproval: boolean;
+        maxFailedFixAttempts: number;
+        maxChangedFilesPerStep: number;
+        riskyPaths: string[];
+    }, {
+        requireApproval?: boolean | undefined;
+        maxFailedFixAttempts?: number | undefined;
+        maxChangedFilesPerStep?: number | undefined;
+        riskyPaths?: string[] | undefined;
+    }>>;
+    commands: z.ZodDefault<z.ZodObject<{
+        typecheck: z.ZodDefault<z.ZodString>;
+        lint: z.ZodDefault<z.ZodString>;
+        test: z.ZodDefault<z.ZodString>;
+        build: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        typecheck: string;
+        lint: string;
+        test: string;
+        build: string;
+    }, {
+        typecheck?: string | undefined;
+        lint?: string | undefined;
+        test?: string | undefined;
+        build?: string | undefined;
+    }>>;
+    ignore: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    model: {
+        provider: "lmstudio";
+        baseUrl: string;
+        model: string;
+        apiKey: string;
+        temperature: number;
+        maxContextTokens: number;
+        timeoutMs: number;
+    };
+    context: {
+        maxContextChars: number;
+        maxFilesPerStep: number;
+        maxEditFilesPerStep: number;
+        maxFileChars: number;
+        includeTests: boolean;
+        includeImportNeighbors: boolean;
+    };
+    safety: {
+        requireApproval: boolean;
+        maxFailedFixAttempts: number;
+        maxChangedFilesPerStep: number;
+        riskyPaths: string[];
+    };
+    commands: {
+        typecheck: string;
+        lint: string;
+        test: string;
+        build: string;
+    };
+    ignore: string[];
+}, {
+    model?: {
+        provider?: "lmstudio" | undefined;
+        baseUrl?: string | undefined;
+        model?: string | undefined;
+        apiKey?: string | undefined;
+        temperature?: number | undefined;
+        maxContextTokens?: number | undefined;
+        timeoutMs?: number | undefined;
+    } | undefined;
+    context?: {
+        maxContextChars?: number | undefined;
+        maxFilesPerStep?: number | undefined;
+        maxEditFilesPerStep?: number | undefined;
+        maxFileChars?: number | undefined;
+        includeTests?: boolean | undefined;
+        includeImportNeighbors?: boolean | undefined;
+    } | undefined;
+    safety?: {
+        requireApproval?: boolean | undefined;
+        maxFailedFixAttempts?: number | undefined;
+        maxChangedFilesPerStep?: number | undefined;
+        riskyPaths?: string[] | undefined;
+    } | undefined;
+    commands?: {
+        typecheck?: string | undefined;
+        lint?: string | undefined;
+        test?: string | undefined;
+        build?: string | undefined;
+    } | undefined;
+    ignore?: string[] | undefined;
+}>;
+export type AppConfig = z.infer<typeof appConfigSchema>;
+export type ModelConfig = z.infer<typeof modelConfigSchema>;
+export type ContextConfig = z.infer<typeof contextConfigSchema>;
+export type SafetyConfig = z.infer<typeof safetyConfigSchema>;
+export type CommandConfig = z.infer<typeof commandConfigSchema>;

package/dist/types/config.js

@@ -0,0 +1,66 @@
+/**
+ * Config schema — single source of truth for shape AND defaults (HLD-SRD §3.2, §9).
+ *
+ * Every field carries a `.default(...)` so an absent/empty config still parses
+ * to the full HLD-SRD §3.2 object. `AppConfig` is inferred from the schema.
+ */
+import { z } from "zod";
+export const modelConfigSchema = z.object({
+    provider: z.literal("lmstudio").default("lmstudio"),
+    baseUrl: z.string().default("http://localhost:1234/v1"),
+    model: z.string().default("qwen/qwen3.6-27b"),
+    apiKey: z.string().default("lm-studio"),
+    temperature: z.number().default(0.2),
+    maxContextTokens: z.number().int().default(32768),
+    // Request timeout (ms) used by the ModelClient. Not in §3.2 but needed by the
+    // client/doctor; defaults conservatively.
+    timeoutMs: z.number().int().default(60000),
+});
+export const contextConfigSchema = z.object({
+    maxContextChars: z.number().int().default(120000),
+    maxFilesPerStep: z.number().int().default(12),
+    maxEditFilesPerStep: z.number().int().default(5),
+    maxFileChars: z.number().int().default(50000),
+    includeTests: z.boolean().default(true),
+    includeImportNeighbors: z.boolean().default(true),
+});
+export const safetyConfigSchema = z.object({
+    requireApproval: z.boolean().default(true),
+    maxFailedFixAttempts: z.number().int().default(2),
+    maxChangedFilesPerStep: z.number().int().default(5),
+    riskyPaths: z
+        .array(z.string())
+        .default([
+        "**/auth/**",
+        "**/billing/**",
+        "**/payments/**",
+        "**/migrations/**",
+        ".env*",
+    ]),
+});
+export const commandConfigSchema = z.object({
+    typecheck: z.string().default("npm run typecheck"),
+    lint: z.string().default("npm run lint"),
+    test: z.string().default("npm test"),
+    build: z.string().default("npm run build"),
+});
+export const appConfigSchema = z.object({
+    model: modelConfigSchema.default({}),
+    context: contextConfigSchema.default({}),
+    safety: safetyConfigSchema.default({}),
+    commands: commandConfigSchema.default({}),
+    ignore: z
+        .array(z.string())
+        .default([
+        "node_modules",
+        ".git",
+        ".next",
+        "dist",
+        "build",
+        "coverage",
+        "package-lock.json",
+        "pnpm-lock.yaml",
+        "yarn.lock",
+    ]),
+});
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

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

package/dist/types/context.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Context package + tolerant task/session types (HLD-SRD §9, §3.7).
+ *
+ * `ContextPackage` is the role-specific output of the Context Builder. The
+ * `ActiveTask` / `ActiveSession` shapes are intentionally tolerant and
+ * forward-compatible with the 0001_04 Task/Session Manager: every field is
+ * optional, parsing never throws, and unknown structure degrades gracefully.
+ */
+import { z } from "zod";
+import type { AgentRole } from "./model.js";
+export declare const contextPackageSchema: z.ZodObject<{
+    role: z.ZodEnum<["planner", "retriever", "coder", "reviewer", "test-fixer", "summarizer"]>;
+    systemPrompt: z.ZodString;
+    userPrompt: z.ZodString;
+    includedMemoryFiles: z.ZodArray<z.ZodString, "many">;
+    includedSourceFiles: z.ZodArray<z.ZodString, "many">;
+    includedTestFiles: z.ZodArray<z.ZodString, "many">;
+    estimatedTokens: z.ZodNumber;
+    warnings: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    warnings: string[];
+    role: "planner" | "retriever" | "coder" | "reviewer" | "test-fixer" | "summarizer";
+    systemPrompt: string;
+    userPrompt: string;
+    includedMemoryFiles: string[];
+    includedSourceFiles: string[];
+    includedTestFiles: string[];
+    estimatedTokens: number;
+}, {
+    warnings: string[];
+    role: "planner" | "retriever" | "coder" | "reviewer" | "test-fixer" | "summarizer";
+    systemPrompt: string;
+    userPrompt: string;
+    includedMemoryFiles: string[];
+    includedSourceFiles: string[];
+    includedTestFiles: string[];
+    estimatedTokens: number;
+}>;
+export interface ContextPackage {
+    role: AgentRole;
+    systemPrompt: string;
+    userPrompt: string;
+    includedMemoryFiles: string[];
+    includedSourceFiles: string[];
+    includedTestFiles: string[];
+    estimatedTokens: number;
+    warnings: string[];
+}
+export interface ActiveSubtask {
+    /** The subtask description line (without the checkbox prefix). */
+    text: string;
+    /** True when the markdown checkbox is checked (`- [x]`). */
+    done: boolean;
+    /** Files the subtask is likely to touch (from a `likelyFiles:` line). */
+    likelyFiles?: string[];
+}
+export interface ActiveTask {
+    goal?: string;
+    subtasks?: ActiveSubtask[];
+    /** The session/task `Next Step`, if present. */
+    nextStep?: string;
+    /** The original markdown, retained verbatim. */
+    raw: string;
+}
+export interface ActiveSession {
+    currentState?: string;
+    nextStep?: string;
+    raw: string;
+}
+/** Parse a 0001_04-shaped task markdown string. Never throws. */
+export declare function parseActiveTask(md: string): ActiveTask;
+/** Parse a session markdown string tolerantly. Never throws. */
+export declare function parseActiveSession(md: string): ActiveSession;
+/**
+ * Resolve the "current" subtask: the first unchecked subtask in document order,
+ * else the first subtask, else undefined when there are no subtasks.
+ */
+export declare function firstIncompleteSubtask(task: ActiveTask): ActiveSubtask | undefined;

package/dist/types/context.js

@@ -0,0 +1,141 @@
+/**
+ * Context package + tolerant task/session types (HLD-SRD §9, §3.7).
+ *
+ * `ContextPackage` is the role-specific output of the Context Builder. The
+ * `ActiveTask` / `ActiveSession` shapes are intentionally tolerant and
+ * forward-compatible with the 0001_04 Task/Session Manager: every field is
+ * optional, parsing never throws, and unknown structure degrades gracefully.
+ */
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// ContextPackage (HLD-SRD §9)
+// ---------------------------------------------------------------------------
+const agentRoleSchema = z.enum([
+    "planner",
+    "retriever",
+    "coder",
+    "reviewer",
+    "test-fixer",
+    "summarizer",
+]);
+export const contextPackageSchema = z.object({
+    role: agentRoleSchema,
+    systemPrompt: z.string(),
+    userPrompt: z.string(),
+    includedMemoryFiles: z.array(z.string()),
+    includedSourceFiles: z.array(z.string()),
+    includedTestFiles: z.array(z.string()),
+    estimatedTokens: z.number().int(),
+    warnings: z.array(z.string()),
+});
+/**
+ * Extract the body of a markdown section by heading title (case-insensitive),
+ * stopping at the next heading of the same-or-higher level. Returns the trimmed
+ * body, or undefined when the heading is absent or its body is empty.
+ */
+function sectionBody(md, title) {
+    const lines = md.split(/\r?\n/);
+    const titleLc = title.toLowerCase();
+    let start = -1;
+    let level = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+(.*?)\s*$/.exec(lines[i]);
+        if (m && m[2].toLowerCase() === titleLc) {
+            start = i + 1;
+            level = m[1].length;
+            break;
+        }
+    }
+    if (start === -1)
+        return undefined;
+    const collected = [];
+    for (let i = start; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+/.exec(lines[i]);
+        if (m && m[1].length <= level)
+            break;
+        collected.push(lines[i]);
+    }
+    const body = collected.join("\n").trim();
+    return body.length > 0 ? body : undefined;
+}
+function parseLikelyFiles(raw) {
+    return raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+/**
+ * Parse the `## Subtasks` section into checkbox list items. Each `- [ ]` /
+ * `- [x]` line starts a subtask; a following indented `likelyFiles:` line (or a
+ * `likelyFiles:` token on the same line) attaches its files. Tolerant: no
+ * checkboxes → no subtasks.
+ */
+function parseSubtasks(md) {
+    const body = sectionBody(md, "Subtasks");
+    if (body === undefined)
+        return undefined;
+    const lines = body.split(/\r?\n/);
+    const subtasks = [];
+    let current;
+    const checkboxRe = /^\s*[-*]\s+\[( |x|X)\]\s*(.*)$/;
+    const likelyRe = /likelyFiles\s*:\s*(.*)$/i;
+    for (const line of lines) {
+        const cb = checkboxRe.exec(line);
+        if (cb) {
+            const done = cb[1].toLowerCase() === "x";
+            let text = cb[2].trim();
+            const inlineLikely = likelyRe.exec(text);
+            const subtask = { text, done };
+            if (inlineLikely) {
+                // `- [ ] foo  likelyFiles: a.ts` — strip the trailing token from text.
+                text = text.slice(0, inlineLikely.index).trim();
+                subtask.text = text;
+                subtask.likelyFiles = parseLikelyFiles(inlineLikely[1]);
+            }
+            subtasks.push(subtask);
+            current = subtask;
+            continue;
+        }
+        const likely = likelyRe.exec(line);
+        if (likely && current && current.likelyFiles === undefined) {
+            current.likelyFiles = parseLikelyFiles(likely[1]);
+        }
+    }
+    return subtasks.length > 0 ? subtasks : undefined;
+}
+/** Parse a 0001_04-shaped task markdown string. Never throws. */
+export function parseActiveTask(md) {
+    const task = { raw: md };
+    const goal = sectionBody(md, "Goal");
+    if (goal !== undefined)
+        task.goal = goal;
+    const subtasks = parseSubtasks(md);
+    if (subtasks !== undefined)
+        task.subtasks = subtasks;
+    const nextStep = sectionBody(md, "Next Step");
+    if (nextStep !== undefined)
+        task.nextStep = nextStep;
+    return task;
+}
+/** Parse a session markdown string tolerantly. Never throws. */
+export function parseActiveSession(md) {
+    const session = { raw: md };
+    const currentState = sectionBody(md, "Current State");
+    if (currentState !== undefined)
+        session.currentState = currentState;
+    const nextStep = sectionBody(md, "Next Step");
+    if (nextStep !== undefined)
+        session.nextStep = nextStep;
+    return session;
+}
+/**
+ * Resolve the "current" subtask: the first unchecked subtask in document order,
+ * else the first subtask, else undefined when there are no subtasks.
+ */
+export function firstIncompleteSubtask(task) {
+    const subs = task.subtasks;
+    if (!subs || subs.length === 0)
+        return undefined;
+    return subs.find((s) => !s.done) ?? subs[0];
+}
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Repository index types and schema (HLD-SRD §3.3, §9).
+ *
+ * RepoFile — per-file metadata entry.
+ * RepoIndex — the full index document written to .ai-orchestrator/index.json.
+ */
+import { z } from "zod";
+export interface RepoFile {
+    path: string;
+    extension: string;
+    size: number;
+    language: string;
+    summary?: string;
+    imports: string[];
+    exports: string[];
+    isTest: boolean;
+    isConfig: boolean;
+}
+export interface RepoIndex {
+    generatedAt: string;
+    root: string;
+    files: RepoFile[];
+}
+export declare const repoFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    extension: z.ZodString;
+    size: z.ZodNumber;
+    language: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    imports: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    exports: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    isTest: z.ZodBoolean;
+    isConfig: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    extension: string;
+    size: number;
+    language: string;
+    imports: string[];
+    exports: string[];
+    isTest: boolean;
+    isConfig: boolean;
+    summary?: string | undefined;
+}, {
+    path: string;
+    extension: string;
+    size: number;
+    language: string;
+    isTest: boolean;
+    isConfig: boolean;
+    summary?: string | undefined;
+    imports?: string[] | undefined;
+    exports?: string[] | undefined;
+}>;
+export declare const repoIndexSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    root: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        extension: z.ZodString;
+        size: z.ZodNumber;
+        language: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        imports: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        exports: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        isTest: z.ZodBoolean;
+        isConfig: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        extension: string;
+        size: number;
+        language: string;
+        imports: string[];
+        exports: string[];
+        isTest: boolean;
+        isConfig: boolean;
+        summary?: string | undefined;
+    }, {
+        path: string;
+        extension: string;
+        size: number;
+        language: string;
+        isTest: boolean;
+        isConfig: boolean;
+        summary?: string | undefined;
+        imports?: string[] | undefined;
+        exports?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    root: string;
+    generatedAt: string;
+    files: {
+        path: string;
+        extension: string;
+        size: number;
+        language: string;
+        imports: string[];
+        exports: string[];
+        isTest: boolean;
+        isConfig: boolean;
+        summary?: string | undefined;
+    }[];
+}, {
+    root: string;
+    generatedAt: string;
+    files: {
+        path: string;
+        extension: string;
+        size: number;
+        language: string;
+        isTest: boolean;
+        isConfig: boolean;
+        summary?: string | undefined;
+        imports?: string[] | undefined;
+        exports?: string[] | undefined;
+    }[];
+}>;

package/dist/types/index.js

@@ -0,0 +1,24 @@
+/**
+ * Repository index types and schema (HLD-SRD §3.3, §9).
+ *
+ * RepoFile — per-file metadata entry.
+ * RepoIndex — the full index document written to .ai-orchestrator/index.json.
+ */
+import { z } from "zod";
+export const repoFileSchema = z.object({
+    path: z.string(),
+    extension: z.string(),
+    size: z.number(),
+    language: z.string(),
+    summary: z.string().optional(),
+    imports: z.array(z.string()).default([]),
+    exports: z.array(z.string()).default([]),
+    isTest: z.boolean(),
+    isConfig: z.boolean(),
+});
+export const repoIndexSchema = z.object({
+    generatedAt: z.string(),
+    root: z.string(),
+    files: z.array(repoFileSchema),
+});
+//# sourceMappingURL=index.js.map