@kienmatu/inkos-core 0.1.0

package/dist/forecast/render.js

@@ -0,0 +1,154 @@
+// Deterministic markdown renderers for forecast artifacts. Both documents are
+// derived purely from forecast.json so re-rendering never needs another LLM
+// call and tests stay clock-free.
+export function renderForecastComparisonMarkdown(forecast) {
+    const zh = forecast.language === "zh";
+    const header = zh
+        ? [
+            `# 叙事推演对比：${forecast.divergence}`,
+            "",
+            `- 推演 ID：${forecast.forecastId}`,
+            `- 书籍：${forecast.bookId}`,
+            `- 基准章节：第 ${forecast.baseChapter} 章`,
+            `- 推演跨度：约 ${forecast.horizon} 章`,
+            `- 生成时间：${forecast.createdAt}`,
+            "",
+            "> 本文件是非正史规划材料，不会改动正文或权威状态。",
+        ]
+        : [
+            `# Narrative forecast comparison: ${forecast.divergence}`,
+            "",
+            `- Forecast id: ${forecast.forecastId}`,
+            `- Book: ${forecast.bookId}`,
+            `- Base chapter: ${forecast.baseChapter}`,
+            `- Horizon: ~${forecast.horizon} chapters`,
+            `- Created at: ${forecast.createdAt}`,
+            "",
+            "> Non-canonical planning material. Nothing here modifies prose or authoritative state.",
+        ];
+    const tableHeader = zh
+        ? ["| 分支 | 标题 | 意图匹配 | 风险数 | 前提 |", "| --- | --- | --- | --- | --- |"]
+        : ["| Branch | Title | Intent fit | Risks | Premise |", "| --- | --- | --- | --- | --- |"];
+    const tableRows = forecast.branches.map((branch) => `| ${branch.branchId} | ${escapeCell(branch.title)} | ${branch.intentAlignment.score} | ${branch.risks.length} | ${escapeCell(branch.premise)} |`);
+    const sections = forecast.branches.map((branch) => renderBranchSection(branch, zh));
+    return [...header, "", ...tableHeader, ...tableRows, "", sections.join("\n\n")].join("\n");
+}
+export function renderSelectedBranchPlanMarkdown(input) {
+    const { forecast, branch } = input;
+    const zh = forecast.language === "zh";
+    const staleWarning = input.stale
+        ? (zh
+            ? "> ⚠️ 该推演已过期：正史章节或状态在推演生成后发生了变化。以下计划基于旧上下文，采用前请重新核对，必要时重新生成推演。"
+            : "> ⚠️ This forecast is stale: canonical chapters or state changed after it was generated. The plan below is based on outdated context — re-check before applying, and regenerate if needed.")
+        : "";
+    const header = zh
+        ? [
+            `# 已选分支计划：${branch.title}`,
+            "",
+            `- 推演 ID：${forecast.forecastId}`,
+            `- 分支：${branch.branchId}`,
+            `- 分歧点：${forecast.divergence}`,
+            `- 基准章节：第 ${forecast.baseChapter} 章`,
+            `- 选择时间：${input.selectedAt}`,
+        ]
+        : [
+            `# Selected branch plan: ${branch.title}`,
+            "",
+            `- Forecast id: ${forecast.forecastId}`,
+            `- Branch: ${branch.branchId}`,
+            `- Divergence: ${forecast.divergence}`,
+            `- Base chapter: ${forecast.baseChapter}`,
+            `- Selected at: ${input.selectedAt}`,
+        ];
+    const footer = zh
+        ? "> 本计划不修改正史。要把它应用到大纲、章节意图或权威状态，需要另行确认的操作（v1 不自动执行）。"
+        : "> This plan does not modify canon. Applying it to the outline, chapter intents, or authoritative state is a separate, explicitly confirmed operation (not automated in v1).";
+    return [
+        ...header,
+        ...(staleWarning ? ["", staleWarning] : []),
+        "",
+        renderBranchSection(branch, zh, { headingLevel: 2, includeBranchId: false }),
+        "",
+        footer,
+    ].join("\n");
+}
+function renderBranchSection(branch, zh, options = {}) {
+    const level = "#".repeat(options.headingLevel ?? 2);
+    const sub = `${level}#`;
+    const heading = options.includeBranchId === false
+        ? `${level} ${branch.title}`
+        : `${level} ${branch.branchId}：${branch.title}`;
+    const labels = zh
+        ? {
+            premise: "前提与假设",
+            beats: "未来章节节拍",
+            decisions: "人物决策",
+            changes: "预计变化",
+            characters: "人物",
+            relationships: "关系",
+            world: "世界",
+            hooks: "伏笔",
+            risks: "一致性风险",
+            uncertainties: "不确定性",
+            alignment: "作者意图匹配度",
+            chapterPrefix: (n) => `第 ${n} 章`,
+            none: "（无）",
+        }
+        : {
+            premise: "Premise and assumptions",
+            beats: "Future chapter beats",
+            decisions: "Character decisions",
+            changes: "Projected changes",
+            characters: "Characters",
+            relationships: "Relationships",
+            world: "World",
+            hooks: "Hooks",
+            risks: "Consistency risks",
+            uncertainties: "Uncertainties",
+            alignment: "Author intent alignment",
+            chapterPrefix: (n) => `Chapter ${n}`,
+            none: "(none)",
+        };
+    const list = (items) => items.length > 0 ? items.map((item) => `- ${item}`).join("\n") : labels.none;
+    return [
+        heading,
+        "",
+        `${sub} ${labels.premise}`,
+        "",
+        branch.premise,
+        "",
+        `${sub} ${labels.beats}`,
+        "",
+        list(branch.beats.map((beat) => `${labels.chapterPrefix(beat.chapter)}：${beat.summary}`)),
+        "",
+        `${sub} ${labels.decisions}`,
+        "",
+        list(branch.characterDecisions.map((decision) => `${decision.character}：${decision.decision}`)),
+        "",
+        `${sub} ${labels.changes}`,
+        "",
+        `- ${labels.characters}：${joinOrNone(branch.projectedChanges.characters, labels.none)}`,
+        `- ${labels.relationships}：${joinOrNone(branch.projectedChanges.relationships, labels.none)}`,
+        `- ${labels.world}：${joinOrNone(branch.projectedChanges.world, labels.none)}`,
+        `- ${labels.hooks}：${joinOrNone(branch.projectedChanges.hooks, labels.none)}`,
+        "",
+        `${sub} ${labels.risks}`,
+        "",
+        list(branch.risks.map((risk) => `[${risk.kind}] ${risk.description}`)),
+        "",
+        `${sub} ${labels.uncertainties}`,
+        "",
+        list([...branch.uncertainties]),
+        "",
+        `${sub} ${labels.alignment}`,
+        "",
+        `${branch.intentAlignment.score}/100 — ${branch.intentAlignment.rationale}`,
+    ].join("\n");
+}
+function joinOrNone(items, none) {
+    return items.length > 0 ? items.join("；") : none;
+}
+function escapeCell(value) {
+    return value.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+//# sourceMappingURL=render.js.map

package/dist/forecast/render.js.map

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

package/dist/forecast/runner.d.ts

@@ -0,0 +1,51 @@
+import type { AgentContext } from "../agents/base.js";
+import { type ForecastBranch, type NarrativeForecast } from "./schema.js";
+import { type ForecastStoreOptions } from "./store.js";
+export interface CreateNarrativeForecastOptions {
+    readonly projectRoot: string;
+    readonly bookId: string;
+    readonly divergence: string;
+    readonly branchCount?: number;
+    readonly horizon?: number;
+    readonly runtime: AgentContext;
+    readonly determinism?: ForecastStoreOptions;
+    readonly onProgress?: (message: string) => void;
+}
+export interface NarrativeForecastCreateResult {
+    readonly forecast: NarrativeForecast;
+    readonly forecastJsonPath: string;
+    readonly comparisonPath: string;
+}
+export declare function createNarrativeForecast(options: CreateNarrativeForecastOptions): Promise<NarrativeForecastCreateResult>;
+export interface GetNarrativeForecastOptions {
+    readonly projectRoot: string;
+    readonly bookId: string;
+    readonly forecastId: string;
+}
+export interface NarrativeForecastGetResult {
+    readonly forecast: NarrativeForecast;
+    readonly stale: boolean;
+    readonly forecastJsonPath: string;
+    readonly comparisonPath: string;
+}
+export declare function getNarrativeForecast(options: GetNarrativeForecastOptions): Promise<NarrativeForecastGetResult>;
+export interface SelectNarrativeBranchOptions {
+    readonly projectRoot: string;
+    readonly bookId: string;
+    readonly forecastId: string;
+    readonly branchId: string;
+    readonly determinism?: ForecastStoreOptions;
+}
+export interface NarrativeForecastSelectResult {
+    readonly forecast: NarrativeForecast;
+    readonly branch: ForecastBranch;
+    readonly stale: boolean;
+    readonly planPath: string;
+}
+/**
+ * Select one branch: writes ONLY selected-branch-plan.md. Applying the plan
+ * to the outline / chapter intents / canonical state is a separate,
+ * user-confirmed operation outside v1.
+ */
+export declare function selectNarrativeBranch(options: SelectNarrativeBranchOptions): Promise<NarrativeForecastSelectResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/forecast/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/forecast/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKtD,OAAO,EAOL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMtE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAiDxC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAkBrC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,6BAA6B,CAAC,CA0BxC"}

package/dist/forecast/runner.js

@@ -0,0 +1,115 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { assertSafeBookId } from "../utils/book-id.js";
+import { NarrativeForecastAgent } from "./agent.js";
+import { buildForecastContext, renderForecastContextMarkdown } from "./context-builder.js";
+import { renderForecastComparisonMarkdown, renderSelectedBranchPlanMarkdown } from "./render.js";
+import { FORECAST_DEFAULT_BRANCHES, FORECAST_DEFAULT_HORIZON, FORECAST_MAX_BRANCHES, FORECAST_MAX_HORIZON, FORECAST_MIN_BRANCHES, FORECAST_MIN_HORIZON, } from "./schema.js";
+import { ForecastStore } from "./store.js";
+export async function createNarrativeForecast(options) {
+    const bookId = assertSafeBookId(options.bookId, "forecast.bookId");
+    const divergence = options.divergence.trim();
+    if (!divergence) {
+        throw new Error("divergence is required: describe the decision point the forecast should branch on.");
+    }
+    const branchCount = boundedInteger(options.branchCount, FORECAST_DEFAULT_BRANCHES, "branchCount", FORECAST_MIN_BRANCHES, FORECAST_MAX_BRANCHES);
+    const horizon = boundedInteger(options.horizon, FORECAST_DEFAULT_HORIZON, "horizon", FORECAST_MIN_HORIZON, FORECAST_MAX_HORIZON);
+    const bookDir = await resolveBookDir(options.projectRoot, bookId);
+    options.onProgress?.("Reading canonical context...");
+    const context = await buildForecastContext({ bookDir, bookId });
+    options.onProgress?.(`Projecting ${branchCount} candidate branches...`);
+    const agent = new NarrativeForecastAgent(options.runtime);
+    const modelOutput = await agent.generateBranches({
+        contextMarkdown: renderForecastContextMarkdown(context),
+        divergence,
+        branchCount,
+        horizon,
+        baseChapter: context.baseChapter,
+        language: context.language,
+    });
+    const store = new ForecastStore(bookDir, options.determinism);
+    const forecast = {
+        version: 1,
+        forecastId: await store.allocateForecastId(),
+        bookId,
+        createdAt: store.now().toISOString(),
+        language: context.language,
+        divergence,
+        horizon,
+        baseChapter: context.baseChapter,
+        contextFingerprint: context.contextFingerprint,
+        status: "active",
+        branches: modelOutput.branches.map((branch, index) => ({
+            branchId: `branch-${index + 1}`,
+            ...branch,
+        })),
+    };
+    options.onProgress?.("Writing forecast artifacts...");
+    const paths = await store.save(forecast, renderForecastComparisonMarkdown(forecast));
+    return { forecast, ...paths };
+}
+export async function getNarrativeForecast(options) {
+    const bookId = assertSafeBookId(options.bookId, "forecast.bookId");
+    const bookDir = await resolveBookDir(options.projectRoot, bookId);
+    const store = new ForecastStore(bookDir);
+    let forecast = await store.load(options.forecastId);
+    const stale = await isForecastStale(bookDir, bookId, forecast);
+    if (stale && forecast.status === "active") {
+        // Persist the stale marker so later readers see it without recomputing.
+        forecast = await store.markStale(forecast);
+    }
+    return {
+        forecast,
+        stale,
+        forecastJsonPath: store.forecastJsonPath(forecast.forecastId),
+        comparisonPath: store.comparisonPath(forecast.forecastId),
+    };
+}
+/**
+ * Select one branch: writes ONLY selected-branch-plan.md. Applying the plan
+ * to the outline / chapter intents / canonical state is a separate,
+ * user-confirmed operation outside v1.
+ */
+export async function selectNarrativeBranch(options) {
+    const bookId = assertSafeBookId(options.bookId, "forecast.bookId");
+    const bookDir = await resolveBookDir(options.projectRoot, bookId);
+    const store = new ForecastStore(bookDir, options.determinism);
+    const forecast = await store.load(options.forecastId);
+    const branch = forecast.branches.find((candidate) => candidate.branchId === options.branchId);
+    if (!branch) {
+        throw new Error(`Branch "${options.branchId}" not found in forecast "${forecast.forecastId}". `
+            + `Available branches: ${forecast.branches.map((candidate) => candidate.branchId).join(", ")}`);
+    }
+    const stale = await isForecastStale(bookDir, bookId, forecast);
+    const planPath = await store.writeSelectedPlan(forecast.forecastId, renderSelectedBranchPlanMarkdown({
+        forecast,
+        branch,
+        selectedAt: store.now().toISOString(),
+        stale,
+    }));
+    return { forecast, branch, stale, planPath };
+}
+async function isForecastStale(bookDir, bookId, forecast) {
+    if (forecast.status === "stale")
+        return true;
+    const context = await buildForecastContext({ bookDir, bookId });
+    return context.contextFingerprint !== forecast.contextFingerprint;
+}
+async function resolveBookDir(projectRoot, bookId) {
+    const bookDir = join(projectRoot, "books", bookId);
+    try {
+        await access(join(bookDir, "book.json"));
+    }
+    catch {
+        throw new Error(`Book "${bookId}" not found under ${join(projectRoot, "books")}.`);
+    }
+    return bookDir;
+}
+function boundedInteger(value, fallback, name, min, max) {
+    const parsed = value ?? fallback;
+    if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+        throw new Error(`${name} must be an integer between ${min} and ${max}.`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=runner.js.map

package/dist/forecast/runner.js.map

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