opencode-novel 0.0.1

package/dist/plugin-handlers/config-handler.d.ts

@@ -0,0 +1,9 @@
+import type { NovelConfig } from "../config/schema";
+type OpenCodeConfig = Record<string, unknown> & {
+    model?: unknown;
+    agent?: Record<string, unknown>;
+};
+export declare function createConfigHandler(deps: {
+    pluginConfig: NovelConfig;
+}): (config: OpenCodeConfig) => Promise<void>;
+export {};

package/dist/plugin-handlers/index.d.ts

@@ -0,0 +1 @@
+export { createConfigHandler } from "./config-handler";

package/dist/shared/errors/diagnostics.d.ts

@@ -0,0 +1,19 @@
+export type DiagnosticSeverity = "error" | "warn" | "info";
+export type DiagnosticEvidence = {
+    file: string;
+    line?: number;
+    excerpt?: string;
+};
+export type Diagnostic = {
+    severity: DiagnosticSeverity;
+    code: string;
+    message: string;
+    file?: string;
+    line?: number;
+    evidence?: DiagnosticEvidence[];
+    suggestedFix?: string;
+    repro?: string;
+};
+export declare function inferReproFromDiagnosticCode(code: string): string | undefined;
+export declare function sortDiagnostics(diagnostics: Diagnostic[]): Diagnostic[];
+export declare function formatDiagnosticsMarkdown(diagnostics: Diagnostic[]): string;

package/dist/shared/fs/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function toPosixPath(path: string): string;
+export declare function toRelativePosixPath(rootDir: string, absoluteOrRelativePath: string): string;
+export declare function fromRelativePosixPath(rootDir: string, relativePosixPath: string): string;

package/dist/shared/fs/read.d.ts

@@ -0,0 +1,5 @@
+import type { TextEncoding } from "../strings/text-encoding";
+export declare function decodeText(buf: Uint8Array, encoding: TextEncoding): string;
+export declare function readTextFileSync(filePath: string, options?: {
+    encoding?: TextEncoding;
+}): string;

package/dist/shared/fs/write.d.ts

@@ -0,0 +1,8 @@
+export type WriteResult = {
+    changed: boolean;
+};
+export declare function ensureDirForFile(filePath: string): void;
+export declare function normalizeLf(text: string): string;
+export declare function writeTextFile(filePath: string, content: string, options?: {
+    mode?: "always" | "if-changed";
+}): WriteResult;

package/dist/shared/hashing/hash8.d.ts

@@ -0,0 +1 @@
+export declare function hash8(input: string): string;

package/dist/shared/hashing/sha256.d.ts

@@ -0,0 +1,2 @@
+export declare function createSha256Hex(content: string): string;
+export declare function createSha256HexFromBytes(content: Uint8Array): string;

package/dist/shared/markdown/frontmatter.d.ts

@@ -0,0 +1,15 @@
+import type { Diagnostic } from "../errors/diagnostics";
+export type ParsedFrontmatter<T extends Record<string, unknown>> = {
+    data: Partial<T>;
+    body: string;
+    hasFrontmatter: boolean;
+    diagnostics: Diagnostic[];
+};
+export declare function parseFrontmatter<T extends Record<string, unknown>>(content: string, options?: {
+    file?: string;
+    strict?: boolean;
+}): ParsedFrontmatter<T>;
+export declare function serializeFrontmatter(data: Record<string, unknown>, options?: {
+    lineWidth?: number;
+}): string;
+export declare function buildFrontmatterFile(data: Record<string, unknown>, body: string): string;

package/dist/shared/opencode/artifacts.d.ts

@@ -0,0 +1,12 @@
+export declare function yamlQuote(value: string): string;
+export declare function buildCommandMarkdown(def: {
+    description?: string;
+    agent?: string;
+    argumentHint?: string;
+    template: string;
+}): string;
+export declare function buildSkillMarkdown(def: {
+    name: string;
+    description: string;
+    template: string;
+}): string;

package/dist/shared/strings/chinese-number.d.ts

@@ -0,0 +1 @@
+export declare function parseChineseNumber(input: string): number | null;

package/dist/shared/strings/slug.d.ts

@@ -0,0 +1 @@
+export declare function slugify(input: string): string;

package/dist/shared/strings/text-encoding.d.ts

@@ -0,0 +1,2 @@
+export declare const TEXT_ENCODINGS: readonly ["auto", "utf8", "utf8-bom", "utf16le", "utf16be", "gbk", "gb18030"];
+export type TextEncoding = (typeof TEXT_ENCODINGS)[number];

package/dist/shared/tool-output.d.ts

@@ -0,0 +1,6 @@
+import type { Diagnostic } from "./errors/diagnostics";
+export declare function formatToolMarkdownOutput(options: {
+    summaryLines: string[];
+    resultJson: unknown;
+    diagnostics: Diagnostic[];
+}): string;

package/dist/tools/novel-apply-candidates/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelApplyCandidatesTool } from "./tool";
+export type { CandidateOp, NovelApplyCandidatesArgs, NovelApplyCandidatesResultJson, NovelCandidatesV1, } from "./types";

package/dist/tools/novel-apply-candidates/render.d.ts

@@ -0,0 +1,2 @@
+import type { NovelApplyCandidatesResultJson } from "./types";
+export declare function renderApplyReportMd(result: NovelApplyCandidatesResultJson): string;

package/dist/tools/novel-apply-candidates/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelApplyCandidatesTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-apply-candidates/types.d.ts

@@ -0,0 +1,52 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelCandidatesV1 = {
+    version: 1;
+    generatedAt: string;
+    scope: {
+        kind: "all";
+    } | {
+        kind: "chapter";
+        chapter_id: string;
+    };
+    notes?: string;
+    ops: CandidateOp[];
+};
+export type CandidateOp = {
+    op: "ensure_entity";
+    kind: "character" | "faction" | "location" | "thread";
+    id: string;
+    name?: string;
+    filePath?: string;
+} | {
+    op: "patch_frontmatter";
+    filePath: string;
+    patch: Record<string, unknown>;
+    mode?: "deep_merge" | "shallow_merge" | "merge" | "replace";
+};
+export type NovelApplyCandidatesArgs = {
+    rootDir?: string;
+    candidatesPath?: string;
+    dryRun?: boolean;
+    writeReport?: boolean;
+    snapshot?: boolean;
+    snapshotTag?: string;
+};
+export type NovelApplyCandidatesResultJson = {
+    version: 1;
+    dryRun: boolean;
+    appliedOps: number;
+    writtenFiles: string[];
+    skippedOps: {
+        index: number;
+        reason: string;
+    }[];
+    snapshot?: {
+        enabled: boolean;
+        tag?: string;
+        dir?: string;
+        savedFiles: string[];
+    };
+    nextSteps?: string[];
+    reportPath?: string;
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-bible/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelBibleTool } from "./tool";
+export type { BibleRule, GlossaryTerm, NovelBibleArgs, NovelBibleResultJson } from "./types";

package/dist/tools/novel-bible/render.d.ts

@@ -0,0 +1,3 @@
+import type { BibleRule, GlossaryTerm } from "./types";
+export declare function renderBibleSummaryMd(rules: BibleRule[]): string;
+export declare function renderGlossaryMd(terms: GlossaryTerm[]): string;

package/dist/tools/novel-bible/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelBibleTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-bible/types.d.ts

@@ -0,0 +1,26 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelBibleArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    writeDerivedFiles?: boolean;
+};
+export type BibleRule = {
+    id: string;
+    text: string;
+    sourceFile: string;
+    line?: number;
+};
+export type GlossaryTerm = {
+    term: string;
+    definition?: string;
+    sourceFile: string;
+};
+export type NovelBibleResultJson = {
+    version: 1;
+    summaryPath?: string;
+    glossaryPath?: string;
+    rules: BibleRule[];
+    glossary: GlossaryTerm[];
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-bootstrap/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelBootstrapTool } from "./tool";
+export type { NovelBootstrapArgs, NovelBootstrapResultJson } from "./types";

package/dist/tools/novel-bootstrap/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelBootstrapTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-bootstrap/types.d.ts

@@ -0,0 +1,38 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+import type { NovelCharacterReportResultJson } from "../novel-character-report/types";
+import type { NovelEntityGapsResultJson } from "../novel-entity-gaps/types";
+import type { NovelGraphResultJson } from "../novel-graph/types";
+import type { NovelImportMode, NovelImportResultJson } from "../novel-import/types";
+import type { NovelIndexResultJson } from "../novel-index/types";
+import type { NovelScaffoldResultJson } from "../novel-scaffold/types";
+export type NovelBootstrapArgs = {
+    rootDir?: string;
+    fromDir?: string;
+    manuscriptDir?: string;
+    bookTitle?: string;
+    importMode?: NovelImportMode;
+    createStubs?: boolean;
+};
+export type NovelBootstrapResultJson = {
+    version: 1;
+    rootDir: string;
+    fromDir: string;
+    manuscriptDir: string;
+    results: {
+        scaffold: NovelScaffoldResultJson;
+        import: NovelImportResultJson;
+        index: NovelIndexResultJson;
+        entityGaps: NovelEntityGapsResultJson;
+        graphs: {
+            relationships: NovelGraphResultJson;
+            factions: NovelGraphResultJson;
+        };
+        characterReport: NovelCharacterReportResultJson;
+    };
+    writtenFiles: string[];
+    nextSteps: string[];
+    diagnostics: Diagnostic[];
+    stats: {
+        durationMs: number;
+    };
+};

package/dist/tools/novel-candidates-write/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelCandidatesWriteTool } from "./tool";
+export type { NovelCandidatesWriteArgs, NovelCandidatesWriteResultJson } from "./types";

package/dist/tools/novel-candidates-write/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelCandidatesWriteTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-candidates-write/types.d.ts

@@ -0,0 +1,13 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelCandidatesWriteArgs = {
+    rootDir?: string;
+    candidatesPath?: string;
+    candidates: unknown;
+};
+export type NovelCandidatesWriteResultJson = {
+    version: 1;
+    candidatesPath?: string;
+    changed?: boolean;
+    ops?: number;
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-chapter-plan/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelChapterPlanTool } from "./tool";
+export type { ChapterPlanJson, ChapterPlanScene, NovelChapterPlanArgs, NovelChapterPlanResultJson, } from "./types";

package/dist/tools/novel-chapter-plan/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelChapterPlanTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-chapter-plan/types.d.ts

@@ -0,0 +1,32 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelChapterPlanArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    chapter_id: string;
+    structureRef?: string;
+    outputPath?: string;
+    writeFile?: boolean;
+    sceneCount?: number;
+};
+export type ChapterPlanScene = {
+    scene_id: string;
+    objective: string;
+    conflict: string;
+    outcome: string;
+    hook?: string;
+};
+export type ChapterPlanJson = {
+    chapter_id: string;
+    title?: string;
+    structureRef?: string;
+    sourceChapterPath?: string;
+    sceneBlueprint: ChapterPlanScene[];
+    writingChecklist: string[];
+    qualityGates: string[];
+};
+export type NovelChapterPlanResultJson = {
+    version: 1;
+    planPath?: string;
+    planJson: ChapterPlanJson;
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-character-report/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelCharacterReportTool } from "./tool";
+export type { CharacterReportItem, NovelCharacterReportArgs, NovelCharacterReportResultJson, } from "./types";

package/dist/tools/novel-character-report/render.d.ts

@@ -0,0 +1,2 @@
+import type { CharacterReportItem } from "./types";
+export declare function renderCharacterReportMd(items: CharacterReportItem[]): string;

package/dist/tools/novel-character-report/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelCharacterReportTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-character-report/types.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelCharacterReportArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    writeReport?: boolean;
+};
+export type CharacterReportItem = {
+    id: string;
+    path: string;
+    appearances: number;
+    first_seen?: string;
+    last_seen?: string;
+    threads_involved: string[];
+    arc_summary?: string;
+    missingFields?: string[];
+};
+export type NovelCharacterReportResultJson = {
+    version: 1;
+    reportPath?: string;
+    characters: CharacterReportItem[];
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-config-check/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelConfigCheckTool } from "./tool";
+export type { NovelConfigCheckArgs, NovelConfigCheckResultJson } from "./types";

package/dist/tools/novel-config-check/tool.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+export declare function createNovelConfigCheckTool(deps: {
+    projectRoot: string;
+}): ToolDefinition;

package/dist/tools/novel-config-check/types.d.ts

@@ -0,0 +1,15 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelConfigCheckArgs = {
+    rootDir?: string;
+};
+export type NovelConfigCheckResultJson = {
+    version: 1;
+    valid: boolean;
+    projectRoot: string;
+    sources: {
+        user?: string;
+        project?: string;
+    };
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-context-pack/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelContextPackTool } from "./tool";
+export type { NovelContextPackArgs, NovelContextPackResultJson, NovelContextPackTask, } from "./types";

package/dist/tools/novel-context-pack/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelContextPackTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-context-pack/types.d.ts

@@ -0,0 +1,37 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelContextPackTask = "draft" | "review" | "rewrite" | "continuity" | "foreshadowing";
+export type NovelContextPackArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    task: NovelContextPackTask;
+    chapter_id?: string;
+    thread_id?: string;
+    budget?: {
+        maxChars: number;
+    };
+    include?: {
+        bible?: boolean;
+        characters?: boolean;
+        openThreads?: boolean;
+        lastChapters?: number;
+    };
+    redaction?: {
+        enabled: boolean;
+        patterns: string[];
+    };
+    writeFile?: boolean;
+};
+export type NovelContextPackResultJson = {
+    version: 1;
+    packPath?: string;
+    included: {
+        path: string;
+        reason: string;
+        chars: number;
+    }[];
+    stats: {
+        totalChars: number;
+        budgetChars: number;
+    };
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-continuity-check/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelContinuityCheckTool } from "./tool";
+export type { ContinuityFinding, ContinuitySeverity, NovelContinuityArgs, NovelContinuityResultJson, NovelContinuityScope, } from "./types";

package/dist/tools/novel-continuity-check/render.d.ts

@@ -0,0 +1,9 @@
+import type { ContinuityFinding } from "./types";
+export declare function renderContinuityReportMd(options: {
+    stats: {
+        errors: number;
+        warns: number;
+        infos: number;
+    };
+    findings: ContinuityFinding[];
+}): string;

package/dist/tools/novel-continuity-check/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelContinuityCheckTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-continuity-check/types.d.ts

@@ -0,0 +1,37 @@
+import type { Diagnostic, DiagnosticEvidence } from "../../shared/errors/diagnostics";
+export type NovelContinuityScope = {
+    kind: "all";
+} | {
+    kind: "chapter";
+    chapter_id: string;
+};
+export type NovelContinuityArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    scope?: NovelContinuityScope;
+    strictMode?: boolean;
+    writeReport?: boolean;
+};
+export type ContinuitySeverity = "error" | "warn" | "info";
+export type ContinuityFinding = {
+    ruleId: string;
+    severity: ContinuitySeverity;
+    message: string;
+    evidence: DiagnosticEvidence[];
+    suggestedFix?: string;
+    repro?: string;
+};
+export type NovelContinuityResultJson = {
+    version: 1;
+    reportPath?: string;
+    stats: {
+        errors: number;
+        warns: number;
+        infos: number;
+        durationMs: number;
+    };
+    findings: ContinuityFinding[];
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-entity-gaps/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelEntityGapsTool } from "./tool";
+export type { MissingEntityRef, NovelEntityGapsArgs, NovelEntityGapsResultJson, NovelEntityKind, OrphanEntity, } from "./types";

package/dist/tools/novel-entity-gaps/render.d.ts

@@ -0,0 +1,5 @@
+import type { MissingEntityRef, OrphanEntity } from "./types";
+export declare function renderEntityGapsMd(options: {
+    missing: MissingEntityRef[];
+    orphans: OrphanEntity[];
+}): string;

package/dist/tools/novel-entity-gaps/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelEntityGapsTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;

package/dist/tools/novel-entity-gaps/types.d.ts

@@ -0,0 +1,33 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelEntityKind = "characters" | "threads" | "factions" | "locations";
+export type NovelEntityGapsArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    writeReport?: boolean;
+    createStubs?: boolean;
+    stubPolicy?: "skip" | "write";
+};
+export type MissingEntityRef = {
+    kind: NovelEntityKind;
+    id: string;
+    referencedBy: {
+        chapter_id: string;
+        path: string;
+    }[];
+    suggestedPath: string;
+};
+export type OrphanEntity = {
+    kind: NovelEntityKind;
+    id: string;
+    path: string;
+};
+export type NovelEntityGapsResultJson = {
+    version: 1;
+    reportPath?: string;
+    missing: MissingEntityRef[];
+    orphans: OrphanEntity[];
+    createdStubs: string[];
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

package/dist/tools/novel-export/docx.d.ts

@@ -0,0 +1,5 @@
+import type { NovelDocxTemplate } from "./types";
+export declare function markdownToDocxBytes(markdown: string, options: {
+    title: string;
+    template?: NovelDocxTemplate;
+}): Promise<Uint8Array>;

package/dist/tools/novel-export/epub.d.ts

@@ -0,0 +1,10 @@
+export type EpubChapter = {
+    id: string;
+    title: string;
+    bodyHtml: string;
+};
+export declare function chaptersToEpubBytes(options: {
+    title: string;
+    language: string;
+    chapters: EpubChapter[];
+}): Uint8Array;

package/dist/tools/novel-export/index.d.ts

@@ -0,0 +1,2 @@
+export { createNovelExportTool } from "./tool";
+export type { NovelChapterOrder, NovelExportArgs, NovelExportFormat, NovelExportResultJson, } from "./types";

package/dist/tools/novel-export/preflight.d.ts

@@ -0,0 +1,19 @@
+import type { ToolContext } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+import type { NovelExportPreflightCheck, NovelExportPreflightFailOn, NovelExportPreflightSummary } from "./types";
+export type RunPreflightOptions = {
+    projectRoot: string;
+    config: NovelConfig;
+    rootDir: string;
+    manuscriptDir: string;
+    enabled: boolean;
+    checks: NovelExportPreflightCheck[];
+    failOn: NovelExportPreflightFailOn;
+    context?: ToolContext;
+};
+/** 执行配置的预检项并汇总检查报告。 */
+export declare function runPreflight(options: RunPreflightOptions): Promise<{
+    summary: NovelExportPreflightSummary | undefined;
+    diagnostics: Diagnostic[];
+}>;

package/dist/tools/novel-export/render.d.ts

@@ -0,0 +1,6 @@
+export declare function wrapHtmlDocument(options: {
+    title: string;
+    bodyHtml: string;
+    language?: string;
+}): string;
+export declare function markdownToHtml(markdown: string): string;

package/dist/tools/novel-export/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { NovelConfig } from "../../config/schema";
+export declare function createNovelExportTool(deps: {
+    projectRoot: string;
+    config: NovelConfig;
+}): ToolDefinition;