linersh 0.5.7 → 1.0.1

package/dist/agents/evaluation-assembly.js

@@ -0,0 +1,270 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import * as YAML from "yaml";
+import { countCandidateUrlsFromLonglist, normalizeCandidateUrl, readCandidateLonglist, } from "./candidate-longlist.js";
+import { validateEvaluation } from "./artifact-validation.js";
+const DECISIONS = new Set(["kept", "trim", "trimmed", "dropped"]);
+const JTBD_FITS = new Set(["direct", "bridge", "background"]);
+const FETCH_STATUSES = new Set(["readable", "partial", "metadata_only", "unavailable"]);
+const USABLE_FETCH_STATUSES = new Set(["readable", "partial"]);
+const CONTENT_QUALITIES = new Set(["high", "medium", "low"]);
+const USABLE_CONTENT_QUALITIES = new Set(["high", "medium"]);
+export function ensureEvaluationArtifact(project) {
+    const finalPath = join(project, "working/03-evaluation.yaml");
+    const expectedCandidateCount = countCandidateUrlsFromLonglist(join(project, "working/02-candidate-longlist.md"));
+    const existing = validateEvaluation(finalPath, { expectedCandidateCount });
+    if (existing.ok)
+        return { ok: true, assembled: false };
+    const assembled = assembleEvaluationFromFragments(project);
+    if (!assembled.ok) {
+        return {
+            ok: false,
+            message: `${existing.message}; fragment assembly failed: ${assembled.message}`,
+        };
+    }
+    const validation = validateEvaluation(finalPath, { expectedCandidateCount });
+    if (!validation.ok) {
+        return {
+            ok: false,
+            message: `assembled working/03-evaluation.yaml is invalid: ${validation.message}`,
+        };
+    }
+    return {
+        ok: true,
+        assembled: true,
+        message: `Assembled working/03-evaluation.yaml with ${assembled.count} Evaluation decisions from fragments.`,
+    };
+}
+export function assembleEvaluationFromFragments(project) {
+    const longlistPath = join(project, "working/02-candidate-longlist.md");
+    const candidates = readCandidateLonglist(longlistPath);
+    if (candidates.length === 0) {
+        return { ok: false, message: "working/02-candidate-longlist.md has no URL candidates" };
+    }
+    const fragments = readEvaluationFragments(join(project, "working/evaluation-decisions"));
+    if (fragments.length === 0) {
+        return { ok: false, message: "working/evaluation-decisions has no YAML decision fragments" };
+    }
+    const byUrl = new Map();
+    for (const fragment of fragments) {
+        const url = stringField(fragment, "url");
+        if (!url)
+            return { ok: false, message: "a decision fragment is missing url" };
+        const decision = normalizeDecision(stringField(fragment, "decision"));
+        if (!DECISIONS.has(decision)) {
+            return { ok: false, message: `decision fragment for ${url} has invalid decision: ${decision || "(empty)"}` };
+        }
+        byUrl.set(normalizeCandidateUrl(url), { ...fragment, decision });
+    }
+    const missing = candidates.filter((candidate) => !byUrl.has(candidate.url));
+    if (missing.length > 0) {
+        return {
+            ok: false,
+            message: `missing decision fragments for ${missing.length} candidates, first: ${missing[0]?.url}`,
+        };
+    }
+    const assembled = candidates.map((candidate) => normalizeDecisionRecord(candidate, byUrl.get(candidate.url)));
+    const outputPath = join(project, "working/03-evaluation.yaml");
+    mkdirSync(join(project, "working"), { recursive: true });
+    writeFileSync(outputPath, YAML.stringify({ candidates: assembled }), "utf8");
+    return { ok: true, path: outputPath, count: assembled.length };
+}
+export function validateEvaluationFragment(path, candidates) {
+    const parsed = readEvaluationFragmentFile(path);
+    if (!parsed.ok)
+        return parsed;
+    const expectedUrls = new Set(candidates.map((candidate) => candidate.url));
+    const candidateByUrl = new Map(candidates.map((candidate) => [candidate.url, candidate]));
+    const seen = new Set();
+    for (const [i, fragment] of parsed.records.entries()) {
+        const rawUrl = stringField(fragment, "url");
+        if (!rawUrl)
+            return { ok: false, message: `fragment candidates[${i}].url is required` };
+        const url = normalizeCandidateUrl(rawUrl);
+        if (!expectedUrls.has(url)) {
+            return { ok: false, message: `fragment includes unexpected URL: ${url}` };
+        }
+        if (seen.has(url)) {
+            return { ok: false, message: `fragment includes duplicate URL: ${url}` };
+        }
+        seen.add(url);
+        const decision = normalizeDecision(stringField(fragment, "decision"));
+        if (!DECISIONS.has(decision)) {
+            return {
+                ok: false,
+                message: `fragment candidate ${url} has invalid decision: ${decision || "(empty)"}`,
+            };
+        }
+        if (decision === "kept" || decision === "trim") {
+            const rating = numericField(fragment, "rating");
+            if (rating == null || rating < 1 || rating > 5) {
+                return { ok: false, message: `fragment candidate ${url} rating must be 1-5 for ${decision}` };
+            }
+            const jtbdFit = stringField(fragment, "jtbd_fit");
+            if (!JTBD_FITS.has(jtbdFit)) {
+                return { ok: false, message: `fragment candidate ${url} jtbd_fit is invalid: ${jtbdFit || "(empty)"}` };
+            }
+            if (!stringField(fragment, "section") && !candidateByUrl.get(url)?.section) {
+                return { ok: false, message: `fragment candidate ${url} section is required for ${decision}` };
+            }
+            if (!stringField(fragment, "note")) {
+                return { ok: false, message: `fragment candidate ${url} note is required for ${decision}` };
+            }
+            const evidence = validateFragmentEvidence(fragment, url, decision);
+            if (!evidence.ok)
+                return evidence;
+        }
+    }
+    const missing = candidates.filter((candidate) => !seen.has(candidate.url));
+    if (missing.length > 0) {
+        return {
+            ok: false,
+            message: `fragment is missing ${missing.length} candidate(s), first: ${missing[0]?.url}`,
+        };
+    }
+    return { ok: true, count: seen.size };
+}
+function readEvaluationFragments(dir) {
+    if (!existsSync(dir))
+        return [];
+    const records = [];
+    for (const name of readdirSync(dir).filter((file) => /\.ya?ml$/i.test(file)).sort()) {
+        const path = join(dir, name);
+        const parsed = readEvaluationFragmentFile(path);
+        if (parsed.ok)
+            records.push(...parsed.records);
+    }
+    return records;
+}
+function readEvaluationFragmentFile(path) {
+    if (!existsSync(path))
+        return { ok: false, message: `${path} is missing` };
+    let parsed;
+    try {
+        parsed = YAML.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: `fragment YAML could not be parsed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    if (Array.isArray(parsed)) {
+        return { ok: true, records: parsed.filter(isRecord) };
+    }
+    if (!isRecord(parsed))
+        return { ok: false, message: "fragment is not a YAML mapping or list" };
+    const candidates = parsed["candidates"];
+    if (Array.isArray(candidates)) {
+        return { ok: true, records: candidates.filter(isRecord) };
+    }
+    if (stringField(parsed, "url")) {
+        return { ok: true, records: [parsed] };
+    }
+    return { ok: false, message: "fragment has no candidates list" };
+}
+function normalizeDecisionRecord(candidate, fragment) {
+    const decision = normalizeDecision(stringField(fragment, "decision"));
+    const out = {
+        url: candidate.url,
+        title: stringField(fragment, "title") || candidate.title,
+        decision,
+        section: stringField(fragment, "section") || candidate.section,
+    };
+    const rationale = stringField(fragment, "rationale");
+    if (rationale)
+        out["rationale"] = rationale;
+    if (decision === "kept" || decision === "trim") {
+        const rating = numericField(fragment, "rating");
+        if (rating != null)
+            out["rating"] = rating;
+        const jtbdFit = stringField(fragment, "jtbd_fit");
+        if (jtbdFit)
+            out["jtbd_fit"] = jtbdFit;
+        const note = stringField(fragment, "note");
+        if (note)
+            out["note"] = note;
+        const fetchStatus = stringField(fragment, "fetch_status");
+        if (fetchStatus)
+            out["fetch_status"] = fetchStatus;
+        const contentQuality = stringField(fragment, "content_quality");
+        if (contentQuality)
+            out["content_quality"] = contentQuality;
+        const evidence = stringListField(fragment, "evidence");
+        if (evidence.length > 0)
+            out["evidence"] = evidence;
+    }
+    return Object.fromEntries(Object.entries(out).filter(([, value]) => value != null && value !== ""));
+}
+function validateFragmentEvidence(fragment, url, decision) {
+    const fetchStatus = stringField(fragment, "fetch_status");
+    if (!FETCH_STATUSES.has(fetchStatus)) {
+        return { ok: false, message: `fragment candidate ${url} fetch_status is required for ${decision}` };
+    }
+    if (!USABLE_FETCH_STATUSES.has(fetchStatus)) {
+        return {
+            ok: false,
+            message: `fragment candidate ${url} fetch_status cannot be ${fetchStatus} for ${decision}`,
+        };
+    }
+    const contentQuality = stringField(fragment, "content_quality");
+    if (!CONTENT_QUALITIES.has(contentQuality)) {
+        return { ok: false, message: `fragment candidate ${url} content_quality is required for ${decision}` };
+    }
+    if (!USABLE_CONTENT_QUALITIES.has(contentQuality)) {
+        return {
+            ok: false,
+            message: `fragment candidate ${url} content_quality cannot be low for ${decision}`,
+        };
+    }
+    const evidence = stringListField(fragment, "evidence");
+    if (evidence.length < 2) {
+        return {
+            ok: false,
+            message: `fragment candidate ${url} evidence needs at least two content-specific bullets for ${decision}`,
+        };
+    }
+    return { ok: true, count: 1 };
+}
+function normalizeDecision(decision) {
+    return decision === "trimmed" ? "trim" : decision;
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function stringField(record, key) {
+    const value = record[key];
+    return typeof value === "string" ? value.trim() : "";
+}
+function numericField(record, key) {
+    const value = record[key];
+    if (typeof value === "number")
+        return value;
+    if (typeof value !== "string")
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function stringListField(record, key) {
+    const value = record[key];
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map(yamlListItemToString)
+        .filter((item) => item !== "");
+}
+function yamlListItemToString(item) {
+    if (typeof item === "string")
+        return item.trim();
+    if (!isRecord(item))
+        return "";
+    const entries = Object.entries(item);
+    if (entries.length !== 1)
+        return "";
+    const [key, value] = entries[0];
+    if (typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
+        return "";
+    }
+    return `${key}: ${String(value)}`.trim();
+}
+//# sourceMappingURL=evaluation-assembly.js.map

package/dist/agents/evaluation-assembly.js.map

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

package/dist/agents/headless-runner.js

@@ -0,0 +1,227 @@
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { basename, dirname, resolve } from "node:path";
+import { detectAgents, resolveSkillPathWithDiagnostics } from "./detect.js";
+import { runPhaseWithAgent } from "./runner.js";
+import { readConfig, resolveConfiguredAgent } from "../config.js";
+import { projectFolder, readTape } from "../yaml-io.js";
+const AGENT_PHASES = new Set([
+    "framing",
+    "candidates",
+    "evaluation",
+    "quality",
+    "synthesis",
+    "assembly",
+]);
+let stdoutBroken = false;
+process.stdout.on("error", (error) => {
+    if (isBrokenPipeError(error)) {
+        stdoutBroken = true;
+        return;
+    }
+    throw error;
+});
+export function parseHeadlessArgs(argv) {
+    const values = new Map();
+    let resume = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i] ?? "";
+        if (arg === "--help" || arg === "-h") {
+            return { ok: false, code: 0, message: usage() };
+        }
+        if (arg === "--resume") {
+            resume = true;
+            continue;
+        }
+        const [name, inlineValue] = splitArg(arg);
+        if (!name) {
+            return { ok: false, code: 2, message: `Unknown argument: ${arg}` };
+        }
+        const value = inlineValue ?? argv[++i];
+        if (value == null || value.startsWith("--")) {
+            return { ok: false, code: 2, message: `Missing value for --${name}` };
+        }
+        values.set(name, value);
+    }
+    const project = values.get("project")?.trim();
+    if (!project) {
+        return { ok: false, code: 2, message: "Missing required --project" };
+    }
+    const rawPhase = values.get("phase")?.trim();
+    if (!rawPhase || !AGENT_PHASES.has(rawPhase)) {
+        return {
+            ok: false,
+            code: 2,
+            message: `--phase must be one of: ${Array.from(AGENT_PHASES).join(", ")}`,
+        };
+    }
+    const rawAgent = values.get("agent")?.trim() ?? "auto";
+    if (rawAgent !== "auto" && rawAgent !== "claude" && rawAgent !== "codex") {
+        return { ok: false, code: 2, message: "--agent must be auto, claude, or codex" };
+    }
+    const skillPath = values.get("skill-path")?.trim();
+    return {
+        ok: true,
+        args: {
+            project,
+            phaseId: rawPhase,
+            agent: rawAgent,
+            skillPath: skillPath || undefined,
+            resume,
+        },
+    };
+}
+export function selectHeadlessAgent(choice, installed, config = readConfig()) {
+    if (choice !== "auto") {
+        const agent = installed.find((candidate) => candidate.id === choice);
+        if (agent)
+            return { ok: true, agent };
+        return {
+            ok: false,
+            code: 2,
+            message: `${choice} agent was requested, but it was not found on PATH.`,
+        };
+    }
+    const configured = resolveConfiguredAgent(installed, config);
+    if (configured)
+        return { ok: true, agent: configured };
+    if (installed.length === 0) {
+        return {
+            ok: false,
+            code: 2,
+            message: "No supported agent found on PATH. Install Claude Code or Codex.",
+        };
+    }
+    return {
+        ok: false,
+        code: 2,
+        message: `Multiple agents found (${installed.map((a) => a.id).join(", ")}). ` +
+            `Pass --agent or set LINER_AGENT.`,
+    };
+}
+export async function main(argv = process.argv.slice(2)) {
+    const parsed = parseHeadlessArgs(argv);
+    if (!parsed.ok) {
+        if (parsed.code === 0) {
+            process.stdout.write(parsed.message + "\n");
+        }
+        else {
+            emit({ kind: "runner_error", message: parsed.message });
+        }
+        return parsed.code;
+    }
+    try {
+        const args = parsed.args;
+        const skillPath = resolveHeadlessSkillPath(args.skillPath);
+        if (!skillPath) {
+            emit({
+                kind: "runner_error",
+                message: "Could not find the curating-mixtapes skill bundle. Pass --skill-path.",
+            });
+            return 2;
+        }
+        const selection = selectHeadlessAgent(args.agent, detectAgents());
+        if (!selection.ok) {
+            emit({ kind: "runner_error", message: selection.message });
+            return selection.code;
+        }
+        const folder = projectFolder(args.project);
+        const { tape } = readTape(folder.tapePath);
+        const handle = runPhaseWithAgent({
+            agent: selection.agent,
+            phaseId: args.phaseId,
+            project: folder.path,
+            skillPath,
+            tape,
+            resume: args.resume,
+            onEvent: emit,
+        });
+        emit({
+            kind: "runner_start",
+            phaseId: args.phaseId,
+            project: folder.path,
+            agent: selection.agent.id,
+            skillPath,
+            resume: args.resume,
+        });
+        const cancel = () => handle.cancel();
+        process.once("SIGINT", cancel);
+        process.once("SIGTERM", cancel);
+        const result = await handle.done;
+        process.off("SIGINT", cancel);
+        process.off("SIGTERM", cancel);
+        emit({
+            kind: "runner_done",
+            code: result.code,
+            stderr: result.stderr || undefined,
+        });
+        return result.code ?? 1;
+    }
+    catch (error) {
+        emit({
+            kind: "runner_error",
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return 1;
+    }
+}
+export function resolveHeadlessSkillPath(explicit) {
+    if (!explicit)
+        return resolveSkillPathWithDiagnostics().path;
+    const expanded = explicit === "~"
+        ? homedir()
+        : explicit.startsWith("~/")
+            ? resolve(homedir(), explicit.slice(2))
+            : explicit;
+    const directory = basename(expanded) === "SKILL.md" ? dirname(expanded) : expanded;
+    return resolve(directory);
+}
+function splitArg(arg) {
+    if (!arg.startsWith("--"))
+        return [null, undefined];
+    const body = arg.slice(2);
+    const eq = body.indexOf("=");
+    if (eq === -1)
+        return [body, undefined];
+    return [body.slice(0, eq), body.slice(eq + 1)];
+}
+function emit(event) {
+    if (stdoutBroken)
+        return;
+    if (!writeHeadlessEvent(event))
+        stdoutBroken = true;
+}
+export function writeHeadlessEvent(event, write = (line) => process.stdout.write(line)) {
+    try {
+        write(JSON.stringify(event) + "\n");
+        return true;
+    }
+    catch (error) {
+        if (isBrokenPipeError(error))
+            return false;
+        throw error;
+    }
+}
+export function isBrokenPipeError(error) {
+    return Boolean(error &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "EPIPE");
+}
+function usage() {
+    return [
+        "Usage: node dist/agents/headless-runner.js --project <path> --phase <phase> [options]",
+        "",
+        "Options:",
+        "  --agent auto|claude|codex  Agent to run. Defaults to auto.",
+        "  --skill-path <path>        Directory containing SKILL.md.",
+        "  --resume                   Continue the last agent session for this project.",
+        "  -h, --help                 Show this help.",
+    ].join("\n");
+}
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+    void main().then((code) => {
+        process.exitCode = code;
+    });
+}
+//# sourceMappingURL=headless-runner.js.map

package/dist/agents/headless-runner.js.map

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

package/dist/agents/jtbd-clarify.js

@@ -1,38 +1,33 @@
-// JTBD elicitation — generate 3-4 clarifying questions targeted at the
-// user's just-typed JTBD, so the downstream curation has a sharper input.
+// Capability elicitation — generate 3-4 clarifying questions targeted at what
+// the user wants this Liner to help a future AI agent do.
 //
 // Runs as a side task at wizard time, not as a methodology phase. The agent
 // answers in JSON; we accumulate streamed text and parse once the run
-// completes. If anything goes wrong (no agent installed, agent crashed,
-// response can't be parsed) the wizard falls back to the hardcoded questions
-// below — they're the same canonical set the recommendation system uses when
-// the agent path is unavailable. Better to ask predictable questions than
-// to skip the step entirely.
+// completes. If the agent fails, the caller should surface the failure and let
+// the user retry; Liner should not hide the problem behind canned questions.
 import { runAgentTask } from "./runner.js";
 /**
- * Canonical fallback questions when the agent path is unavailable or fails.
- * Designed to cover the four axes the recommendation in the plan called out:
- *   1. Scope splits (the "and"/"or" boundary problem)
- *   2. Output kinds expected
- *   3. Quality anchors the curator can name
- *   4. Audience / autonomy mode
- */
-export const HARDCODED_QUESTIONS = [
-    "If your JTBD names multiple domains (e.g. X and Y), are they equally weighted, or is one primary?",
-    "What specific kinds of output should this mixtape help produce — flag descriptions, errors, help text, longer docs, all of the above?",
-    "Name 1–2 tools, projects, or authors whose work in this domain you admire. These become quality anchors for source discovery.",
-    "Is this corpus for an AI assisting you interactively, or for an AI working autonomously?",
-];
-/**
- * Generate clarifying questions for a raw JTBD. Returns the agent's
- * questions on success, or the hardcoded baseline if anything prevents a
- * clean agent answer. Never throws — failure modes degrade to fallback.
+ * Generate clarifying questions for a raw capability goal. Returns the agent's
+ * questions on success. Throws after retry when no agent is available, the
+ * agent crashes or times out, or the answer cannot be parsed.
  */
 export async function elicitClarifyingQuestions(args) {
     if (!args.agent || !args.skillPath) {
-        return [...HARDCODED_QUESTIONS];
+        throw new Error("Clarifying questions require an available Claude Code or Codex agent and skill bundle");
+    }
+    const prompt = buildClarifyingQuestionsPrompt(args.jtbd);
+    const failures = [];
+    for (let attempt = 1; attempt <= 2; attempt++) {
+        try {
+            return await runClarifyAttempt(args, prompt);
+        }
+        catch (error) {
+            failures.push(error instanceof Error ? error.message : String(error));
+        }
     }
-    const prompt = buildPrompt(args.jtbd);
+    throw new Error(`Could not generate clarification questions after retry: ${failures.join("; retry: ")}`);
+}
+async function runClarifyAttempt(args, prompt) {
     // Accumulate every text + tool-result event into one buffer; the response
     // will be in there somewhere. The agent's `summary.finalText` lands at the
     // end and is usually the cleanest source of the JSON.
@@ -61,40 +56,46 @@ export async function elicitClarifyingQuestions(args) {
     }, timeoutMs);
     try {
         const { code } = await handle.done;
-        clearTimeout(timeout);
-        if (timedOut || code !== 0) {
-            return [...HARDCODED_QUESTIONS];
+        if (timedOut) {
+            throw new Error(`${args.agent.name} did not return clarification questions before timeout`);
+        }
+        if (code !== 0) {
+            throw new Error(`${args.agent.name} exited with code ${code}`);
         }
         const body = finalText || textChunks.join("\n");
         const questions = parseQuestions(body);
         if (questions.length === 0) {
-            return [...HARDCODED_QUESTIONS];
+            throw new Error(`${args.agent.name} did not return a JSON array of questions`);
         }
         // Clamp to a sane range: at least 2, at most 6. The wizard step renders
         // them one at a time, so very long question lists fatigue the user.
         return questions.slice(0, 6);
     }
-    catch {
+    finally {
         clearTimeout(timeout);
-        return [...HARDCODED_QUESTIONS];
     }
 }
-function buildPrompt(jtbd) {
-    return `You are helping a curator sharpen a just-typed JTBD for an AI-curated mixtape.
+export function buildClarifyingQuestionsPrompt(jtbd) {
+    return `You are helping a curator sharpen a plain-language capability goal for a Liner project.
 
-# The JTBD
+# The capability goal
 ${jtbd}
 
 # Your task
 
-Generate 3-4 targeted questions whose answers will make the downstream curation produce a sharper corpus. Cover the following four axes — one question per axis, in order:
+Generate 3-4 targeted questions whose answers will help Liner build a hyper-specific, source-grounded resource for a future AI agent. The user should not have to name research lanes, source categories, or formal JTBD syntax. Ask only what is needed to infer those.
+
+Ask questions that are specific to this capability. Do not use a generic checklist. Prefer questions that clarify:
+
+- what future AI sessions should produce, decide, critique, translate, or prevent
+- the narrow niche or situation where the resource should be excellent
+- domain constraints, risk boundaries, regulated contexts, or things the agent must avoid
+- quality anchors only when the user already hinted at examples, people, products, or styles they care about
+- whether the future agent should ask follow-up questions at runtime or act autonomously from the request and corpus
 
-1. **Scope splits** the user named ("and"/"or" boundaries). If the JTBD names two domains, ask whether they're equally weighted.
-2. **Output kinds** — what specific things will this mixtape help produce (e.g. flag descriptions, errors, designs, prose, etc.)? Force a concrete answer.
-3. **Quality anchors** — name 1-2 tools/projects/authors whose work in this domain the curator admires. These anchor source discovery.
-4. **Audience / autonomy** — is the corpus for an AI assisting interactively, or for an AI working autonomously?
+If the goal involves images, moodboards, references, examples, inspiration, style, art direction, visual language, or translating one medium/domain into another output, include at least one question that clarifies the runtime inputs and output contract. Ask what kinds of references the future agent may receive and what the caller needs back (for example: observations, interpretation, carry-forward rules, implementation vocabulary, avoid-list, or clarification questions). This is not asking the user to name research sources; it is clarifying the job the corpus must support.
 
-If the JTBD doesn't have a scope split (axis 1), ask a different sharpening question instead — something about the JTBD's most ambiguous word or phrase.
+If the goal names multiple domains, ask how they relate in the capability. Do not ask the user "what sources should we gather" or "what should Liner extract"; Liner infers that from the capability.
 
 # Output format (strict)