@isaacriehm/cairn-core 0.1.0

package/dist/init/mapper-prompts.js

@@ -0,0 +1,189 @@
+/**
+ * Mapper schema + system prompt + user-prompt builder.
+ *
+ * The chunked parallel mapper (`mapper-parallel.ts`) operates per-module on a
+ * subset of these inputs; the `cairn scope rebuild` CLI consumes the full
+ * surface to regenerate `scope_index.yaml` against an existing project. Both
+ * paths share the same JSON schema + system prompt to guarantee identical
+ * output shape.
+ */
+export const MAPPER_OUTPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        pilot_module: { type: "string" },
+        domain_summary: { type: "string" },
+        key_modules: {
+            type: "array",
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    name: { type: "string" },
+                    path: { type: "string" },
+                    purpose: { type: "string" },
+                },
+                required: ["name", "path", "purpose"],
+            },
+        },
+        route_handler_globs: { type: "array", items: { type: "string" } },
+        dto_globs: { type: "array", items: { type: "string" } },
+        generator_source_globs: { type: "array", items: { type: "string" } },
+        high_stakes_globs: { type: "array", items: { type: "string" } },
+        off_limits_globs: { type: "array", items: { type: "string" } },
+        proposed_sensors: {
+            type: "array",
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    id: { type: "string" },
+                    description: { type: "string" },
+                    applies_to_globs: {
+                        type: "array",
+                        items: { type: "string" },
+                    },
+                },
+                required: ["id", "description", "applies_to_globs"],
+            },
+        },
+        notes: { type: "string" },
+        scope_index: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                files: {
+                    type: "object",
+                    additionalProperties: {
+                        type: "object",
+                        additionalProperties: false,
+                        properties: {
+                            decisions: { type: "array", items: { type: "string" } },
+                            invariants: { type: "array", items: { type: "string" } },
+                            unscoped: { type: "boolean" },
+                        },
+                        required: ["decisions", "invariants"],
+                    },
+                },
+            },
+            required: ["files"],
+        },
+    },
+    required: [
+        "pilot_module",
+        "domain_summary",
+        "key_modules",
+        "route_handler_globs",
+        "dto_globs",
+        "generator_source_globs",
+        "high_stakes_globs",
+        "off_limits_globs",
+        "proposed_sensors",
+        "notes",
+    ],
+};
+export const MAPPER_SYSTEM_PROMPT = [
+    "You are the INIT MAPPER for a code-agent cairn adopting a new project.",
+    "",
+    "Your job: read a structural inventory of an unknown project (top-level dirs, package manifests, framework signals, file-extension breakdown, notable files and dirs) and produce a structured proposal that lets the cairn run useful sensors against the project's diffs.",
+    "",
+    "You DO NOT execute code. You DO NOT modify files. You produce one JSON object.",
+    "",
+    "Required outputs:",
+    "",
+    "- `pilot_module` — a glob like `core/src/integrations/**` for the initial scope where the cairn should focus, OR the literal `ALL` if the project is small enough to cairn end-to-end on day one. Bias toward a focused module — operators add scope as confidence grows.",
+    "- `domain_summary` — one paragraph (~80-200 words). What does this codebase appear to do? Inferred from package name, README contents (when in a manifest preview), top-level dirs, and manifest deps. State only what the inventory supports; if uncertain, say so.",
+    "- `key_modules` — 3-8 modules the cairn should know about. Each `{ name, path, purpose }`. `path` is a directory path that EXISTS in the inventory (no glob); `purpose` is one short sentence.",
+    "- `route_handler_globs` — file glob patterns matching HTTP / CLI / RPC / route handlers. Examples: `core/src/**/*.controller.ts` (NestJS), `app/controllers/**/*.rb` (Rails), `apps/api/routes/**/*.py` (FastAPI), `internal/handlers/**/*.go`. EMPTY array if no handlers detected.",
+    "- `dto_globs` — globs matching DTO / schema / form-input / request-validator definitions. Examples: `**/*.dto.ts`, `apps/api/schemas/**/*.py`, `core/src/**/zod.ts`, `app/forms/**/*.rb`.",
+    "- `generator_source_globs` — globs whose changes mean a generator must re-run. Examples: `core/openapi.json`, `core/src/db/schema.ts` (Drizzle), `**/*.proto`, `prisma/schema.prisma`, `db/structure.sql`. EMPTY if no generators apparent.",
+    "- `high_stakes_globs` — globs for high-risk surfaces (auth, billing, multi-tenant boundaries, payments, integrations storing tokens, telephony, anything where a regression leaks user data or charges money). Be conservative; over-flagging dilutes the gate. EMPTY if not clear.",
+    "- `off_limits_globs` — globs the cairn MUST NOT touch beyond the generic defaults already in place (`node_modules/**`, `dist/**`, `.git/**`, `.cairn/**`, `.archive/**`, generated artifact dirs are already excluded). Add things like vendored third-party code, copied snapshots, large binary fixtures, anything under a directory the operator should not let an agent rewrite. EMPTY if nothing extra.",
+    "- `proposed_sensors` — project-specific sensors beyond the generic cairn Layer A/B/C/D. Each `{ id, description, applies_to_globs }`. Examples: `event-emit-coverage` (every emit() has a label), `migration-naming-convention`, `auth-guard-on-controllers`, `dto-discriminator-coverage`. EMPTY if nothing project-specific is obvious.",
+    "- `notes` — anything notable that didn't fit a structured field — e.g., \"truncated at file cap; pilot scope conservative\", \"no test infra detected\", \"monorepo with pnpm-workspace; cairn should adopt one package at a time\".",
+    "- `scope_index` — forward map from repo-relative file paths to the decisions and invariants whose `scope_globs` apply, keyed by file. Shape: `{ files: { \"<repo-relative-path>\": { decisions: [\"DEC-NNNN\"], invariants: [\"V-NNNN\"], unscoped?: true } } }`. The user prompt provides a list of in-scope decisions + invariants when ground state already exists; classify which apply to each meaningful source file. Use `unscoped: true` for files that should never carry rules (lockfiles, generated, vendored, dotfile config) so the GC scope-coverage pass doesn't re-flag them. EMPTY `{ files: {} }` is acceptable on first-run adopters with no decisions yet.",
+    "",
+    "Rules:",
+    "- Globs MUST start from repo root, no leading slash.",
+    "- Use forward slashes only (`/`), never backslashes.",
+    "- Use `**` for any-depth wildcards, `*` for single-segment.",
+    "- Do not invent paths that aren't in the inventory.",
+    "- Prefer EMPTY arrays over guessed entries. The cairn propagates empty fields to operator review; guessed entries silently mislead and the operator may not catch them at adoption time.",
+    "- Avoid overly-broad globs like `**/*.ts` for `route_handler_globs` — narrow to the controller / route directory.",
+    "- For `pilot_module`: if the repo has a clear modular layout (packages/, apps/, services/, core/src/<feature>/), name one. If it's a flat single-app codebase, use the literal `ALL` and let the operator narrow later.",
+    "- `key_modules.path` MUST appear in the inventory's notable directories or the file-count breakdown.",
+    "- Return ONLY the JSON object. No prose, no preamble, no code fences.",
+].join("\n");
+export function buildMapperUserPrompt(args) {
+    const d = args.detection;
+    const s = args.summary;
+    const parts = [];
+    parts.push(`# Project inventory`);
+    parts.push("");
+    parts.push(`Project slug: ${d.project_slug}`);
+    parts.push(`Origin URL: ${d.origin_url ?? "(none — local-only repo)"}`);
+    parts.push(`Stack signatures (mechanical): ${d.stack_signatures.map((sig) => sig.kind).join(", ") || "(none)"}`);
+    if (d.start_command !== null) {
+        parts.push(`Start command (detected): ${[d.start_command.command, ...d.start_command.args].join(" ")}`);
+    }
+    if (d.proposed_sensors.length > 0) {
+        parts.push("Generic stack-detected sensors already proposed:");
+        for (const sensor of d.proposed_sensors) {
+            parts.push(`  - ${sensor.id} (${sensor.command} ${sensor.args.join(" ")}) — ${sensor.reason}`);
+        }
+    }
+    parts.push("");
+    parts.push(`## Repo summary`);
+    parts.push(`Total files (after caps): ${s.total_files}`);
+    parts.push(`Total dirs: ${s.total_dirs}`);
+    parts.push(`Listing source: ${s.used_git_ls_files ? "git ls-files (gitignore-aware)" : "filesystem walk"}`);
+    if (s.truncated_at_file_cap)
+        parts.push(`(truncated at file cap)`);
+    if (s.truncated_at_depth_cap)
+        parts.push(`(truncated at depth cap — pilot scope should be conservative)`);
+    parts.push("");
+    parts.push(`## Top-level entries`);
+    parts.push(s.top_level.length === 0 ? "(none)" : s.top_level.join(", "));
+    parts.push("");
+    parts.push(`## Files per top-level dir (top 30)`);
+    for (const [dir, count] of Object.entries(s.by_top_dir)) {
+        parts.push(`  - ${dir}/  (${count} files)`);
+    }
+    parts.push("");
+    parts.push(`## File extensions (top 25)`);
+    for (const [ext, count] of Object.entries(s.by_extension)) {
+        parts.push(`  - ${ext}  (${count})`);
+    }
+    parts.push("");
+    if (s.notable_files.length > 0) {
+        parts.push(`## Notable files`);
+        for (const f of s.notable_files)
+            parts.push(`  - ${f}`);
+        parts.push("");
+    }
+    if (s.notable_dir_paths.length > 0) {
+        parts.push(`## Notable directories (matching framework conventions)`);
+        for (const dir of s.notable_dir_paths.slice(0, 80))
+            parts.push(`  - ${dir}/`);
+        parts.push("");
+    }
+    if (s.framework_signals.length > 0) {
+        parts.push(`## Framework signals from manifests`);
+        for (const f of s.framework_signals)
+            parts.push(`  - ${f}`);
+        parts.push("");
+    }
+    if (s.package_manifests.length > 0) {
+        parts.push(`## Package manifest previews (first 80 lines each)`);
+        for (const m of s.package_manifests) {
+            parts.push(`### ${m.path}`);
+            parts.push("```");
+            parts.push(m.preview);
+            parts.push("```");
+            parts.push("");
+        }
+    }
+    parts.push(`Now produce the JSON object per the schema. No preamble.`);
+    return parts.join("\n");
+}
+//# sourceMappingURL=mapper-prompts.js.map

package/dist/init/mapper-prompts.js.map

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

package/dist/init/mapper.d.ts

@@ -0,0 +1,211 @@
+/**
+ * Init mapper orchestrator (Tier 2 / Sonnet, with cheap Haiku merge).
+ *
+ * Three-stage pipeline:
+ *
+ *   1. `module-slicer` partitions the repo into ModuleSlices (one per
+ *      detected module — submodules, workspace packages, top-level packages,
+ *      or fallback heuristic). Single-package repos collapse to one slice.
+ *   2. `mapper-parallel` dispatches one Sonnet call per slice in parallel
+ *      (Promise.allSettled, 4-at-a-time batches when >8). Each call sees
+ *      ~8k tokens of focused module input.
+ *   3. `mapper-merge` runs a cheap Haiku call to pick the pilot module and
+ *      synthesize the project domain summary; the rest of the merge is
+ *      mechanical (union of arrays, dedupe sensors by id).
+ *
+ * If every module call fails, the orchestrator throws — there's no
+ * fallback path. The operator re-runs `cairn init` with `--force` after
+ * fixing whatever broke (auth, network, etc.).
+ *
+ * Public surface (`MapperOutput`, `MapperResult`, validators, prompt + schema
+ * constants) is consumed by both this orchestrator and the standalone
+ * `cairn scope rebuild` command.
+ */
+import { buildMapperUserPrompt as PROMPTS_BUILD } from "./mapper-prompts.js";
+import { type ModuleProposal } from "./mapper-parallel.js";
+import { type ModuleSlice } from "./module-slicer.js";
+import type { DetectionResult } from "./types.js";
+import type { RepoSummary } from "./walker.js";
+export interface MapperKeyModule {
+    name: string;
+    path: string;
+    purpose: string;
+}
+export interface MapperProposedSensor {
+    id: string;
+    description: string;
+    applies_to_globs: string[];
+}
+export interface MapperScopeIndexEntry {
+    decisions: string[];
+    invariants: string[];
+    unscoped?: boolean;
+}
+export interface MapperScopeIndex {
+    files: Record<string, MapperScopeIndexEntry>;
+}
+export interface MapperOutput {
+    pilot_module: string;
+    domain_summary: string;
+    key_modules: MapperKeyModule[];
+    route_handler_globs: string[];
+    dto_globs: string[];
+    generator_source_globs: string[];
+    high_stakes_globs: string[];
+    off_limits_globs: string[];
+    proposed_sensors: MapperProposedSensor[];
+    notes: string;
+    scope_index: MapperScopeIndex;
+}
+export interface MapperResult {
+    output: MapperOutput;
+    duration_ms: number;
+    tier: "sonnet";
+    model: string;
+    /** Per-module proposals from the parallel pipeline. */
+    module_proposals?: ModuleProposal[];
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+}
+export declare const MAPPER_OUTPUT_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly pilot_module: {
+            readonly type: "string";
+        };
+        readonly domain_summary: {
+            readonly type: "string";
+        };
+        readonly key_modules: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly purpose: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["name", "path", "purpose"];
+            };
+        };
+        readonly route_handler_globs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly dto_globs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly generator_source_globs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly high_stakes_globs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly off_limits_globs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly proposed_sensors: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                    };
+                    readonly applies_to_globs: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly required: readonly ["id", "description", "applies_to_globs"];
+            };
+        };
+        readonly notes: {
+            readonly type: "string";
+        };
+        readonly scope_index: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly files: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly decisions: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly invariants: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly unscoped: {
+                                readonly type: "boolean";
+                            };
+                        };
+                        readonly required: readonly ["decisions", "invariants"];
+                    };
+                };
+            };
+            readonly required: readonly ["files"];
+        };
+    };
+    readonly required: readonly ["pilot_module", "domain_summary", "key_modules", "route_handler_globs", "dto_globs", "generator_source_globs", "high_stakes_globs", "off_limits_globs", "proposed_sensors", "notes"];
+};
+export declare const MAPPER_SYSTEM_PROMPT: string;
+export declare const buildMapperUserPrompt: typeof PROMPTS_BUILD;
+export declare function isMapperOutput(value: unknown): value is MapperOutput;
+export declare function validateMapperOutput(value: unknown): MapperOutput;
+export interface RunMapperArgs {
+    detection: DetectionResult;
+    /**
+     * Pre-built repo summary from the Phase-1 walker. Used by both the chunked
+     * path (its merge step references the workspace top-level package.json
+     * via repoRoot) and the legacy fallback (consumes summary directly).
+     */
+    summary: RepoSummary;
+    /** Repo root absolute path — slicer + ledger read from here. */
+    repoRoot: string;
+    /** Fires once after slicing, before any module call goes out. */
+    onSlicesDetected?: (slices: ModuleSlice[]) => void;
+    /** Optional progress callback fired as each module proposal completes. */
+    onModuleStart?: (slice: ModuleSlice) => void;
+    onModuleEnd?: (slice: ModuleSlice, proposal: ModuleProposal) => void;
+}
+export declare function runMapper(args: RunMapperArgs): Promise<MapperResult>;

package/dist/init/mapper.js

@@ -0,0 +1,151 @@
+/**
+ * Init mapper orchestrator (Tier 2 / Sonnet, with cheap Haiku merge).
+ *
+ * Three-stage pipeline:
+ *
+ *   1. `module-slicer` partitions the repo into ModuleSlices (one per
+ *      detected module — submodules, workspace packages, top-level packages,
+ *      or fallback heuristic). Single-package repos collapse to one slice.
+ *   2. `mapper-parallel` dispatches one Sonnet call per slice in parallel
+ *      (Promise.allSettled, 4-at-a-time batches when >8). Each call sees
+ *      ~8k tokens of focused module input.
+ *   3. `mapper-merge` runs a cheap Haiku call to pick the pilot module and
+ *      synthesize the project domain summary; the rest of the merge is
+ *      mechanical (union of arrays, dedupe sensors by id).
+ *
+ * If every module call fails, the orchestrator throws — there's no
+ * fallback path. The operator re-runs `cairn init` with `--force` after
+ * fixing whatever broke (auth, network, etc.).
+ *
+ * Public surface (`MapperOutput`, `MapperResult`, validators, prompt + schema
+ * constants) is consumed by both this orchestrator and the standalone
+ * `cairn scope rebuild` command.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { logger } from "../logger.js";
+import { buildDecisionsLedger, buildInvariantsLedger, } from "../ground/ledgers.js";
+import { MAPPER_OUTPUT_SCHEMA as PROMPTS_SCHEMA, MAPPER_SYSTEM_PROMPT as PROMPTS_SYSTEM, buildMapperUserPrompt as PROMPTS_BUILD, } from "./mapper-prompts.js";
+import { mapModulesParallel, } from "./mapper-parallel.js";
+import { mergeModuleProposals } from "./mapper-merge.js";
+import { sliceModules } from "./module-slicer.js";
+const log = logger("init.mapper");
+// ── Re-exports — `cairn scope rebuild` and other consumers import these. ──
+export const MAPPER_OUTPUT_SCHEMA = PROMPTS_SCHEMA;
+export const MAPPER_SYSTEM_PROMPT = PROMPTS_SYSTEM;
+export const buildMapperUserPrompt = PROMPTS_BUILD;
+export function isMapperOutput(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (!(typeof v["pilot_module"] === "string" &&
+        typeof v["domain_summary"] === "string" &&
+        Array.isArray(v["key_modules"]) &&
+        Array.isArray(v["route_handler_globs"]) &&
+        Array.isArray(v["dto_globs"]) &&
+        Array.isArray(v["generator_source_globs"]) &&
+        Array.isArray(v["high_stakes_globs"]) &&
+        Array.isArray(v["off_limits_globs"]) &&
+        Array.isArray(v["proposed_sensors"]) &&
+        typeof v["notes"] === "string")) {
+        return false;
+    }
+    const scopeIdxRaw = v["scope_index"];
+    if (scopeIdxRaw !== undefined) {
+        if (typeof scopeIdxRaw !== "object" || scopeIdxRaw === null)
+            return false;
+        const filesRaw = scopeIdxRaw["files"];
+        if (typeof filesRaw !== "object" || filesRaw === null)
+            return false;
+    }
+    return true;
+}
+export function validateMapperOutput(value) {
+    if (!isMapperOutput(value)) {
+        throw new Error(`mapper output failed shape validation: ${JSON.stringify(value).slice(0, 200)}`);
+    }
+    const v = value;
+    if (v["scope_index"] === undefined) {
+        v["scope_index"] = { files: {} };
+    }
+    return value;
+}
+export async function runMapper(args) {
+    const startedAt = Date.now();
+    // 1. Slice the repo into modules. The slicer always returns at least one
+    //    slice (single-package repos get one whole-repo slice).
+    const slices = sliceModules({ repoRoot: args.repoRoot });
+    const decisions = readLedgerSafely(args.repoRoot, "decisions");
+    const invariants = readLedgerSafely(args.repoRoot, "invariants");
+    if (args.onSlicesDetected !== undefined)
+        args.onSlicesDetected(slices);
+    log.info({
+        slices: slices.length,
+        slice_slugs: slices.map((s) => s.moduleSlug),
+        decisions: decisions.length,
+        invariants: invariants.length,
+    }, "chunked mapper dispatch");
+    // 2. Parallel module calls.
+    const proposals = await mapModulesParallel({
+        slices,
+        decisions,
+        invariants,
+        ...(args.onModuleStart !== undefined ? { onModuleStart: args.onModuleStart } : {}),
+        ...(args.onModuleEnd !== undefined ? { onModuleEnd: args.onModuleEnd } : {}),
+    });
+    // 3. If every module call failed there's no fallback — surface the
+    //    error so the operator can re-run after fixing the upstream cause.
+    const allFailed = proposals.length > 0 && proposals.every((p) => p.failed);
+    if (allFailed) {
+        throw new Error(`mapper failed: all ${proposals.length} module call(s) returned errors. ` +
+            `Re-run \`cairn init --force\` after fixing the upstream cause (auth, network, etc.).`);
+    }
+    // 4. Merge call (Haiku).
+    const workspacePackageJson = readIfExists(join(args.repoRoot, "package.json"));
+    const merged = await mergeModuleProposals({
+        proposals,
+        workspacePackageJson,
+        projectSlug: args.detection.project_slug,
+    });
+    log.info({
+        proposals: proposals.length,
+        successful: proposals.filter((p) => !p.failed).length,
+        pilot_module: merged.pilot_module,
+        total_sensors: merged.proposed_sensors.length,
+    }, "chunked mapper complete");
+    return {
+        output: merged,
+        tier: "sonnet",
+        model: "haiku+sonnet",
+        duration_ms: Date.now() - startedAt,
+        module_proposals: proposals,
+    };
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function readIfExists(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function readLedgerSafely(repoRoot, kind) {
+    // Ground state may not exist on first-run adopters. Empty list is fine —
+    // mapper just gets no in-scope ledger context to classify against.
+    try {
+        const groundDir = join(repoRoot, ".cairn", "ground");
+        if (!existsSync(groundDir))
+            return [];
+        return (kind === "decisions"
+            ? buildDecisionsLedger({ repoRoot })
+            : buildInvariantsLedger({ repoRoot }));
+    }
+    catch (err) {
+        log.warn({ err: String(err), kind }, "ledger read failed; using empty list");
+        return [];
+    }
+}
+//# sourceMappingURL=mapper.js.map

package/dist/init/mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../../src/init/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,oBAAoB,IAAI,cAAc,EACtC,oBAAoB,IAAI,cAAc,EACtC,qBAAqB,IAAI,aAAa,GACvC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AAIpE,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAqDlC,6EAA6E;AAE7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IACE,CAAC,CACC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ;QACrC,OAAO,CAAC,CAAC,gBAAgB,CAAC,KAAK,QAAQ;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACpC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAC/B,EACD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC1E,MAAM,QAAQ,GAAI,WAAuC,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,KAA2C,CAAC;IACtD,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,SAAS,EAAE,CAAC;QACnC,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAqBD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,yEAAyE;IACzE,4DAA4D;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,gBAAgB,CAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,gBAAgB,CAAuB,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvF,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;QAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEvE,GAAG,CAAC,IAAI,CACN;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QAC5C,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,UAAU,EAAE,UAAU,CAAC,MAAM;KAC9B,EACD,yBAAyB,CAC1B,CAAC;IAEF,4BAA4B;IAC5B,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC;QACzC,MAAM;QACN,SAAS;QACT,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAC;IAEH,mEAAmE;IACnE,uEAAuE;IACvE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3E,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,sBAAsB,SAAS,CAAC,MAAM,mCAAmC;YACvE,sFAAsF,CACzF,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,oBAAoB,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;QACxC,SAAS;QACT,oBAAoB;QACpB,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY;KACzC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CACN;QACE,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM;QACrD,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,aAAa,EAAE,MAAM,CAAC,gBAAgB,CAAC,MAAM;KAC9C,EACD,yBAAyB,CAC1B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACnC,gBAAgB,EAAE,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAI,QAAgB,EAAE,IAAgC;IAC7E,yEAAyE;IACzE,mEAAmE;IACnE,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,OAAO,CAAC,IAAI,KAAK,WAAW;YAC1B,CAAC,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC;YACpC,CAAC,CAAC,qBAAqB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAmB,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,sCAAsC,CAAC,CAAC;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/init/module-slicer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Module slicer — partitions a repo into per-module slices for the chunked
+ * parallel mapper. Each ModuleSlice is the focused input one Sonnet call sees.
+ *
+ * Per `docs/INIT_SPEC.md` §3 (chunked parallel path):
+ *   - Detect modules via .gitmodules, pnpm/yarn/lerna workspaces, top-level
+ *     package.json children, OR top-level dirs with >20 source files.
+ *   - Single-package repos collapse to one slice covering the whole repo.
+ *   - Each slice carries: directory tree (paths only), package.json (full),
+ *     up to 5 representative files (full content), local docs (capped).
+ *
+ * The mapper-parallel module dispatches one Sonnet call per slice, and the
+ * merge call assembles the per-module proposals into a single MapperOutput.
+ */
+export interface ModuleSlice {
+    /** Absolute path to the module root. */
+    modulePath: string;
+    /** Path relative to repoRoot. "." for the whole-repo single-package case. */
+    moduleRel: string;
+    /** Short slug used in progress display + per-module logs. */
+    moduleSlug: string;
+    /** Newline-separated relative paths, no file content. */
+    directoryTree: string;
+    /** Full package.json contents if present at module root, else null. */
+    packageJson: string | null;
+    /** Up to 5 files with full content (capped). */
+    representativeFiles: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Concatenated README/docs, capped. null when no docs found. */
+    localDocs: string | null;
+}
+export interface SliceModulesArgs {
+    repoRoot: string;
+    /** Optional: cap how many slices to return. Default unlimited. */
+    maxSlices?: number;
+}
+export declare function sliceModules(args: SliceModulesArgs): ModuleSlice[];