@ramplab/generator 0.1.0

package/dist/generateLab.js

@@ -0,0 +1,291 @@
+import { statSync } from 'node:fs';
+import { createAgentSdkRunner } from './agentSdkRunner.js';
+import { assembleLab } from './assembleStage.js';
+import { DEEP_WIDGET_RANGE, runAuthorStage } from './authorStage.js';
+import { selectTraceFlagship } from './flagship.js';
+import { runMapStage } from './mapStage.js';
+import { resolveStageModels, } from './pipeline.js';
+import { runPlanStage, } from './planStage.js';
+import { measureRepo, plannedModulesFor } from './repoSize.js';
+import { resolveAnchors, } from './resolveAnchors.js';
+import { runVerifyStage } from './verifyStage.js';
+export async function generateLab(repoDir, config = {}) {
+    assertDirectory(repoDir);
+    const models = resolveStageModels(config.models);
+    const runner = config.runner ?? createAgentSdkRunner();
+    const policy = config.resolutionPolicy ?? 'drop';
+    // The tracer predates the two-pass runtime and emits no events; only the
+    // full pipeline is "pass 2".
+    const emit = config.full === true ? config.onProgress : undefined;
+    const mapReused = config.mapResult !== undefined;
+    let mapResult;
+    if (config.mapResult !== undefined) {
+        mapResult = config.mapResult;
+    }
+    else {
+        emit?.({ type: 'stage-started', pass: 'pass2', stage: 'map' });
+        mapResult = await runMapStage(runner, repoDir, {
+            model: models.map,
+            ...(config.labId !== undefined ? { labId: config.labId } : {}),
+            ...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),
+        });
+        emit?.({ type: 'stage-completed', pass: 'pass2', stage: 'map' });
+    }
+    if (config.full !== true) {
+        const { spec, report } = resolveAnchors(mapResult.spec, repoDir, { policy });
+        return {
+            spec,
+            resolution: report,
+            models,
+            costUsd: mapResult.costUsd,
+            attempts: mapResult.attempts,
+        };
+    }
+    // First renderable snapshot: the overview module alone, anchor-resolved.
+    emit?.({
+        type: 'spec-updated',
+        pass: 'pass2',
+        spec: resolveAnchors(mapResult.spec, repoDir, { policy }).spec,
+    });
+    // The same mechanical trace selection pass 1 makes (see flagship.ts): the
+    // plan's module 1 is pinned to it, so pass 2's re-authoring of the trace
+    // stays canonical. Undefined when the map proposed no usable candidates
+    // (including old-shape reused map results) — the planner then picks its
+    // own front-door action.
+    const traceFlagship = selectTraceFlagship(mapResult.traceCandidates, config.intake);
+    // Right-size the plan to the repository unless the caller pinned a cap:
+    // a budget reads as a quota to the planner, so the cap must carry the
+    // size signal itself (5 to 8 chapters once the overview joins).
+    const budget = config.budget?.maxModules !== undefined
+        ? config.budget
+        : { ...config.budget, maxModules: plannedModulesFor(measureRepo(repoDir)) };
+    emit?.({ type: 'stage-started', pass: 'pass2', stage: 'plan' });
+    const planResult = await runPlanStage(runner, repoDir, {
+        model: models.plan,
+        mapSpec: mapResult.spec,
+        ...(traceFlagship !== undefined ? { traceModule: traceFlagship.plannedModule } : {}),
+        budget,
+        ...(config.intake !== undefined ? { intake: config.intake } : {}),
+        ...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),
+    });
+    emit?.({ type: 'stage-completed', pass: 'pass2', stage: 'plan' });
+    emit?.({ type: 'stage-started', pass: 'pass2', stage: 'author' });
+    // Live preview between the pass-boundary snapshots: after each authored
+    // module, assemble what exists so far and emit it. Authoring is the longest
+    // stretch of a pressing (15 of localsend's 31 minutes) and used to render
+    // nothing at all. Best-effort by design: a partial set that cannot
+    // assemble validly skips its snapshot, never the pressing.
+    const authoredSoFar = [];
+    const planOrder = new Map(planResult.plan.modules.map((m, i) => [m.id, i]));
+    // Bigger repos earn deeper chapters, not only more of them.
+    const widgetRange = budget.maxModules !== undefined && budget.maxModules >= 7 ? DEEP_WIDGET_RANGE : undefined;
+    const authorResult = await runAuthorStage(runner, repoDir, {
+        model: models.author,
+        plan: planResult.plan,
+        ...(widgetRange !== undefined ? { widgetRange } : {}),
+        ...(config.concurrency !== undefined ? { concurrency: config.concurrency } : {}),
+        ...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),
+        ...(emit !== undefined
+            ? {
+                onModuleAuthored: (authored) => {
+                    emit({
+                        type: 'module-authored',
+                        pass: 'pass2',
+                        moduleId: authored.module.id,
+                        attempts: authored.attempts,
+                    });
+                    authoredSoFar.push(authored);
+                    try {
+                        const partial = assembleLab(mapResult.spec, [...authoredSoFar]
+                            .sort((a, b) => (planOrder.get(a.module.id) ?? Number.MAX_SAFE_INTEGER) -
+                            (planOrder.get(b.module.id) ?? Number.MAX_SAFE_INTEGER))
+                            .map((m) => m.module), repoDir, { policy, leadModuleId: planResult.plan.modules[0]?.id });
+                        emit({ type: 'spec-updated', pass: 'pass2', spec: partial.spec });
+                    }
+                    catch {
+                        // an unassemblable partial set waits for the next module
+                    }
+                },
+            }
+            : {}),
+    });
+    emit?.({ type: 'stage-completed', pass: 'pass2', stage: 'author' });
+    // The zoom-out chapter, re-authored (founder, 2026-07-26). The map stage
+    // assembles `repo-overview` mechanically — a system map plus callouts —
+    // before the flagship trace even exists, so it is the one chapter with no
+    // learner ledger, no capability callout and no quiz. Sitting at position 2,
+    // immediately after the trace, that broke the chain: the pedagogy judge
+    // docked BOTH of the criteria that have never scored 5, naming this module
+    // each time ("a generic, non-referential architecture overview that
+    // restates concepts at the same abstract altitude"; "Module 2 has no such
+    // statement, breaking the pattern"). Re-authoring it through the same stage
+    // as every other chapter gives it the ledger, the contracts, and the close.
+    const overviewSpec = await reauthorOverview(runner, repoDir, {
+        mapSpec: mapResult.spec,
+        plan: planResult.plan,
+        model: models.author,
+        ...(widgetRange !== undefined ? { widgetRange } : {}),
+        ...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),
+        ...(emit !== undefined
+            ? {
+                onAuthored: (authored) => emit({
+                    type: 'module-authored',
+                    pass: 'pass2',
+                    moduleId: authored.module.id,
+                    attempts: authored.attempts,
+                }),
+            }
+            : {}),
+    });
+    emit?.({ type: 'stage-started', pass: 'pass2', stage: 'assemble' });
+    // The plan's head is the opening trace by the plan-stage contract, so it
+    // leads the assembled lab; the overview follows as the zoom-out.
+    const { spec, report } = assembleLab(overviewSpec.spec, authorResult.modules.map((m) => m.module), repoDir, { policy, leadModuleId: planResult.plan.modules[0]?.id });
+    emit?.({ type: 'stage-completed', pass: 'pass2', stage: 'assemble' });
+    emit?.({ type: 'spec-updated', pass: 'pass2', spec });
+    // Adversarial verification: every claim that survived anchor resolution is
+    // checked against its anchored code; unverified claims are dropped. Units
+    // the `flag` policy deliberately kept for human review are skipped.
+    emit?.({ type: 'stage-started', pass: 'pass2', stage: 'verify' });
+    const verifyResult = await runVerifyStage(runner, repoDir, {
+        model: models.verify,
+        spec,
+        flaggedUnits: report.units
+            .filter((unit) => unit.outcome === 'flagged')
+            .map((unit) => ({ moduleId: unit.moduleId, widgetId: unit.widgetId })),
+        ...(config.concurrency !== undefined ? { concurrency: config.concurrency } : {}),
+        ...(config.maxRetries !== undefined ? { maxRetries: config.maxRetries } : {}),
+    });
+    emit?.({ type: 'stage-completed', pass: 'pass2', stage: 'verify' });
+    emit?.({ type: 'spec-updated', pass: 'pass2', spec: verifyResult.spec });
+    return {
+        spec: verifyResult.spec,
+        resolution: report,
+        models,
+        costUsd: sumCosts(
+        // A reused map's cost was paid (and reported) by the pass that ran it.
+        mapReused ? undefined : mapResult.costUsd, planResult.costUsd, authorResult.costUsd, overviewSpec.costUsd, verifyResult.costUsd),
+        attempts: mapResult.attempts,
+        plan: planResult.plan,
+        authorAttempts: Object.fromEntries([
+            ...authorResult.modules.map((m) => [m.module.id, m.attempts]),
+            ...(overviewSpec.attempts !== undefined
+                ? [[OVERVIEW_MODULE_ID, overviewSpec.attempts]]
+                : []),
+        ]),
+        verification: verifyResult.report,
+        verifyAttempts: verifyResult.attempts,
+    };
+}
+/** The map stage's zoom-out chapter — a stable id learner progress keys off. */
+export const OVERVIEW_MODULE_ID = 'repo-overview';
+/**
+ * Build the planned-module brief for the zoom-out chapter: what the reader
+ * already walked (the flagship trace's `teaches`), and what this chapter owes
+ * them. Exported for tests — the brief IS the fix, so it is worth pinning.
+ */
+export function plannedOverviewModule(mapSpec, plan) {
+    const overview = mapSpec.base.modules.find((m) => m.id === OVERVIEW_MODULE_ID);
+    const trace = plan.modules[0];
+    if (overview === undefined || trace === undefined)
+        return undefined;
+    // Teach from what the map already found worth mapping: the files its system
+    // map anchors. No second exploration budget needed to know where to look.
+    const keyFiles = new Set();
+    for (const widget of overview.widgets) {
+        if (widget.type !== 'system-map')
+            continue;
+        for (const node of widget.nodes) {
+            for (const anchor of node.anchors ?? [])
+                keyFiles.add(anchor.file);
+        }
+    }
+    return {
+        id: OVERVIEW_MODULE_ID,
+        title: overview.title,
+        focus: 'The zoom-out. The reader has just walked ONE path end to end; this chapter shows ' +
+            'them the whole tree that path moved through — the subsystems, what each one owns, ' +
+            'and how they connect. Open by placing the trace they just followed ON that map, by ' +
+            'name, so the wider picture arrives as an expansion of something concrete they ' +
+            'already hold rather than a fresh set of abstractions. Carry a system-map of the ' +
+            'whole codebase. Every subsystem you name is somewhere a later chapter will go, so ' +
+            'say what it is FOR, not merely what it is called.',
+        keyFiles: [...keyFiles],
+        assumes: trace.teaches,
+        teaches: [
+            'the whole-system map: the major subsystems and what each owns',
+            'where the path they already traced sits inside that map',
+            'which subsystem to look in first for a given kind of change',
+        ],
+    };
+}
+/**
+ * Re-author the overview chapter through the ordinary author stage so it is
+ * held to the same contracts as every other chapter.
+ *
+ * Best-effort by design: a pressing must not die because the zoom-out failed
+ * to validate. On any failure the map stage's original overview is kept — the
+ * lab is then exactly what it would have been before this step existed.
+ */
+async function reauthorOverview(runner, repoDir, options) {
+    const { mapSpec, plan } = options;
+    const planned = plannedOverviewModule(mapSpec, plan);
+    const traceTitle = plan.modules[0]?.title;
+    if (planned === undefined || traceTitle === undefined) {
+        return { spec: mapSpec, costUsd: undefined, attempts: undefined };
+    }
+    try {
+        const result = await runAuthorStage(runner, repoDir, {
+            model: options.model,
+            plan: { modules: [planned] },
+            concurrency: 1,
+            // The reader meets the trace first, so the overview is never the
+            // opening chapter — without this it would be briefed as the flagship.
+            precedingTitles: [traceTitle],
+            ...(options.widgetRange !== undefined ? { widgetRange: options.widgetRange } : {}),
+            ...(options.maxRetries !== undefined ? { maxRetries: options.maxRetries } : {}),
+            ...(options.onAuthored !== undefined ? { onModuleAuthored: options.onAuthored } : {}),
+        });
+        const authored = result.modules[0];
+        if (authored === undefined) {
+            return { spec: mapSpec, costUsd: result.costUsd, attempts: undefined };
+        }
+        return {
+            spec: {
+                ...mapSpec,
+                base: {
+                    ...mapSpec.base,
+                    modules: mapSpec.base.modules.map((m) => m.id === OVERVIEW_MODULE_ID ? authored.module : m),
+                },
+            },
+            costUsd: result.costUsd,
+            attempts: authored.attempts,
+        };
+    }
+    catch {
+        // Keep the map's own overview; the lab is still whole.
+        return { spec: mapSpec, costUsd: undefined, attempts: undefined };
+    }
+}
+export function sumCosts(...costs) {
+    let total;
+    for (const cost of costs) {
+        if (cost !== undefined) {
+            total = (total ?? 0) + cost;
+        }
+    }
+    return total;
+}
+export function assertDirectory(repoDir) {
+    let isDirectory = false;
+    try {
+        isDirectory = statSync(repoDir).isDirectory();
+    }
+    catch {
+        // fall through to the error below
+    }
+    if (!isDirectory) {
+        throw new Error(`generateLab: repoDir "${repoDir}" is not an existing directory.`);
+    }
+}
+//# sourceMappingURL=generateLab.js.map

package/dist/generateLab.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { generateLab, type GenerateLabConfig, type GenerateLabResult, } from './generateLab.js';
+export { generateLabPass1, type GenerateLabPass1Config, type GenerateLabPass1Result, type Pass1Timing, type StageTiming, } from './pass1.js';
+export { FlagshipSelectionError, selectFlagshipModule, selectTraceFlagship, type FlagshipBasis, type FlagshipSelection, } from './flagship.js';
+export { hasIntakeAnswers, renderIntakeSection, type LeadIntake } from './intake.js';
+export type { GenerationPass, GenerationProgressEvent, ProgressCallback, } from './progress.js';
+export { DEFAULT_STAGE_MODEL, GENERATION_STAGES, MAP_STAGE_MODEL, mapWithConcurrency, resolveStageModels, type GenerationStageName, type ModelRunner, type StageModelConfig, type StageRequest, type StageResponse, } from './pipeline.js';
+export { MapStageError, extractJson, parseTraceCandidates, runMapStage, traceCandidateSchema, type MapStageOptions, type MapStageResult, type TraceCandidate, } from './mapStage.js';
+export { DEFAULT_MAX_MODULES, LANDING_MODULE_ID, PlanStageError, curriculumPlanSchema, parsePlan, plannedModuleSchema, runPlanStage, type CurriculumBudget, type CurriculumPlan, type PlanStageOptions, type PlanStageResult, type PlannedModule, } from './planStage.js';
+export { AuthorStageError, DEFAULT_AUTHOR_CONCURRENCY, runAuthorStage, type AuthorModuleFailure, type AuthorStageOptions, type AuthorStageResult, type AuthoredModule, } from './authorStage.js';
+export { assembleLab, type AssembleOptions, type AssembleResult, } from './assembleStage.js';
+export { DEFAULT_VERIFY_CONCURRENCY, VerifyStageError, collectModuleClaims, runVerifyStage, type ClaimVerdict, type ClaimVerdictValue, type VerificationClaim, type VerificationDroppedQuestion, type VerificationDroppedWidget, type VerificationDrops, type VerificationReport, type VerificationSummary, type VerifyBatchFailure, type VerifyStageOptions, type VerifyStageResult, } from './verifyStage.js';
+export { createAgentSdkRunner, createStallWatchdog, describeAuth, DEFAULT_STALL_TIMEOUT_MS, type AgentSdkRunnerOptions, type AuthDescription, type AuthMode, type StallWatchdog, } from './agentSdkRunner.js';
+export { createAnchorFileCache, readAnchorRegion, resolveAnchors, type AnchorFileCache, type AnchorRegion, type AnchorResolution, type AnchorStatus, type LoadedFile, type ResolutionPolicy, type ResolutionReport, type ResolutionSummary, type ResolveAnchorsOptions, type ResolveAnchorsResult, type UnitOutcome, type UnitResolution, } from './resolveAnchors.js';
+export { isRepoDirty, readRepoCommit, readRepoRemote } from './repoCommit.js';
+/**
+ * Cloning a repository, shared by the worker (which clones untrusted URLs on
+ * our own infrastructure) and the CLI (which clones onto the reader's machine
+ * at their request). One validated implementation rather than two, because URL
+ * validation is the last thing to have two versions of.
+ */
+export { cloneRepo, validateRepoUrl, type CloneOptions, type CloneResult, type ExecFn, type ExecResult, type UrlCheck, } from './cloneRepo.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9E;;;;;GAKG;AACH,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+export { generateLab, } from './generateLab.js';
+export { generateLabPass1, } from './pass1.js';
+export { FlagshipSelectionError, selectFlagshipModule, selectTraceFlagship, } from './flagship.js';
+export { hasIntakeAnswers, renderIntakeSection } from './intake.js';
+export { DEFAULT_STAGE_MODEL, GENERATION_STAGES, MAP_STAGE_MODEL, mapWithConcurrency, resolveStageModels, } from './pipeline.js';
+export { MapStageError, extractJson, parseTraceCandidates, runMapStage, traceCandidateSchema, } from './mapStage.js';
+export { DEFAULT_MAX_MODULES, LANDING_MODULE_ID, PlanStageError, curriculumPlanSchema, parsePlan, plannedModuleSchema, runPlanStage, } from './planStage.js';
+export { AuthorStageError, DEFAULT_AUTHOR_CONCURRENCY, runAuthorStage, } from './authorStage.js';
+export { assembleLab, } from './assembleStage.js';
+export { DEFAULT_VERIFY_CONCURRENCY, VerifyStageError, collectModuleClaims, runVerifyStage, } from './verifyStage.js';
+export { createAgentSdkRunner, createStallWatchdog, describeAuth, DEFAULT_STALL_TIMEOUT_MS, } from './agentSdkRunner.js';
+export { createAnchorFileCache, readAnchorRegion, resolveAnchors, } from './resolveAnchors.js';
+export { isRepoDirty, readRepoCommit, readRepoRemote } from './repoCommit.js';
+/**
+ * Cloning a repository, shared by the worker (which clones untrusted URLs on
+ * our own infrastructure) and the CLI (which clones onto the reader's machine
+ * at their request). One validated implementation rather than two, because URL
+ * validation is the last thing to have two versions of.
+ */
+export { cloneRepo, validateRepoUrl, } from './cloneRepo.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,GAKjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAMrF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GAMnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,oBAAoB,GAIrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,mBAAmB,EACnB,YAAY,GAMb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,GAKf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,WAAW,GAGZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GAYf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,GAKzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GAaf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9E;;;;;GAKG;AACH,OAAO,EACL,SAAS,EACT,eAAe,GAMhB,MAAM,gBAAgB,CAAC"}

package/dist/intake.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Lead intake (PLAN.md §4, curation loop step 1): the optional 2-minute
+ * questionnaire an onboarding lead fills in before generation. Three
+ * questions, three string lists — deliberately free-form, because the lead
+ * types answers, not configuration.
+ *
+ * The intake steers generation in two places:
+ * - the **curriculum-plan prompt** (module selection and ordering), and
+ * - the **pass-1 flagship pick** (an intake hint that matches a system-map
+ *   node overrides the pure-centrality choice — see `flagship.ts`).
+ *
+ * It is prompt/heuristic *input* only: nothing from the intake is copied
+ * into the lab spec, so `@ramplab/spec` is untouched.
+ */
+export interface LeadIntake {
+    /** "What must a week-one hire master?" */
+    weekOneMastery?: string[];
+    /** "What is under active development?" */
+    activeDevelopment?: string[];
+    /** "What trips people up?" */
+    gotchas?: string[];
+}
+/** True when at least one intake question has at least one answer. */
+export declare function hasIntakeAnswers(intake: LeadIntake | undefined): intake is LeadIntake;
+/**
+ * Render the intake as a prompt section for the curriculum planner (and the
+ * flagship author's brief). Returns `''` when there is nothing to say, so
+ * callers can interpolate unconditionally.
+ */
+export declare function renderIntakeSection(intake: LeadIntake | undefined): string;
+//# sourceMappingURL=intake.d.ts.map

package/dist/intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../src/intake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,IAAI,UAAU,CAOrF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAqB1E"}

package/dist/intake.js

@@ -0,0 +1,45 @@
+/**
+ * Lead intake (PLAN.md §4, curation loop step 1): the optional 2-minute
+ * questionnaire an onboarding lead fills in before generation. Three
+ * questions, three string lists — deliberately free-form, because the lead
+ * types answers, not configuration.
+ *
+ * The intake steers generation in two places:
+ * - the **curriculum-plan prompt** (module selection and ordering), and
+ * - the **pass-1 flagship pick** (an intake hint that matches a system-map
+ *   node overrides the pure-centrality choice — see `flagship.ts`).
+ *
+ * It is prompt/heuristic *input* only: nothing from the intake is copied
+ * into the lab spec, so `@ramplab/spec` is untouched.
+ */
+/** True when at least one intake question has at least one answer. */
+export function hasIntakeAnswers(intake) {
+    if (intake === undefined)
+        return false;
+    return ((intake.weekOneMastery?.length ?? 0) > 0 ||
+        (intake.activeDevelopment?.length ?? 0) > 0 ||
+        (intake.gotchas?.length ?? 0) > 0);
+}
+/**
+ * Render the intake as a prompt section for the curriculum planner (and the
+ * flagship author's brief). Returns `''` when there is nothing to say, so
+ * callers can interpolate unconditionally.
+ */
+export function renderIntakeSection(intake) {
+    if (!hasIntakeAnswers(intake))
+        return '';
+    const blocks = [
+        'The onboarding lead completed a 2-minute intake. Let these answers steer ' +
+            'which modules you choose, how you order them, and what you emphasize:',
+    ];
+    const question = (label, answers) => {
+        if (answers === undefined || answers.length === 0)
+            return;
+        blocks.push(`${label}\n${answers.map((a) => `- ${a}`).join('\n')}`);
+    };
+    question('What must a week-one hire master? (teach these first)', intake.weekOneMastery);
+    question('What is under active development? (favor the current code paths)', intake.activeDevelopment);
+    question('What trips people up? (call these out in the modules that touch them)', intake.gotchas);
+    return `\n${blocks.join('\n\n')}\n`;
+}
+//# sourceMappingURL=intake.js.map

package/dist/intake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.js","sourceRoot":"","sources":["../src/intake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC7D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,CACL,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACxC,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAC3C,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAClC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA8B;IAChE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,MAAM,GAAa;QACvB,2EAA2E;YACzE,uEAAuE;KAC1E,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,OAA6B,EAAQ,EAAE;QACtE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;IACF,QAAQ,CAAC,uDAAuD,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IACzF,QAAQ,CACN,kEAAkE,EAClE,MAAM,CAAC,iBAAiB,CACzB,CAAC;IACF,QAAQ,CACN,uEAAuE,EACvE,MAAM,CAAC,OAAO,CACf,CAAC;IACF,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACtC,CAAC"}

package/dist/live.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=live.d.ts.map

package/dist/live.d.ts.map

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