opencode-novel 0.0.1

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

@@ -0,0 +1,106 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelScanMode = "full" | "incremental";
+export type NovelScanArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    mode?: NovelScanMode;
+    strictMode?: boolean;
+    writeCache?: boolean;
+};
+export type NovelFileHash = {
+    path: string;
+    mtimeMs: number;
+    size: number;
+    sha256: string;
+};
+export type ChapterStructureEntity = {
+    act?: number;
+    beat_id?: string;
+    beat_goal?: string;
+};
+export type ChapterSceneEntity = {
+    scene_id?: string;
+    objective?: string;
+    conflict?: string;
+    outcome?: string;
+    hook?: string;
+};
+export type ChapterEntity = {
+    chapter_id: string;
+    title?: string;
+    path: string;
+    pov?: string;
+    timeline?: {
+        date?: string;
+        start?: string;
+        end?: string;
+        location?: string;
+    };
+    characters?: string[];
+    factions?: string[];
+    locations?: string[];
+    threads_opened?: string[];
+    threads_advanced?: string[];
+    threads_closed?: string[];
+    summary?: string;
+    tags?: string[];
+    structure?: ChapterStructureEntity;
+    scenes?: ChapterSceneEntity[];
+};
+export type CharacterEntity = {
+    id: string;
+    name?: string;
+    path: string;
+    alias?: string[];
+};
+export type ThreadEntity = {
+    thread_id: string;
+    type?: string;
+    status?: string;
+    path: string;
+};
+export type FactionEntity = {
+    id: string;
+    name?: string;
+    path: string;
+};
+export type LocationEntity = {
+    id: string;
+    name?: string;
+    path: string;
+};
+export type NovelScanResultJson = {
+    version: 1;
+    rootDir: string;
+    manuscriptDir: string;
+    stats: {
+        filesScanned: number;
+        entities: Record<string, number>;
+        durationMs: number;
+        cache: {
+            mode: NovelScanMode;
+            loaded: boolean;
+            written: boolean;
+            fastHits: number;
+            hashHits: number;
+            misses: number;
+        };
+    };
+    files: NovelFileHash[];
+    entities: {
+        chapters: ChapterEntity[];
+        characters: CharacterEntity[];
+        threads: ThreadEntity[];
+        factions: FactionEntity[];
+        locations: LocationEntity[];
+    };
+    diagnostics: Diagnostic[];
+    cache: {
+        scanCachePath?: string;
+    };
+};
+export type ScanCacheV1 = NovelScanResultJson & {
+    __internal?: {
+        perFileDiagnostics?: Record<string, Diagnostic[]>;
+    };
+};

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

@@ -0,0 +1,2 @@
+export { createNovelSceneCheckTool } from "./tool";
+export type { NovelSceneArgs, NovelSceneResultJson, NovelSceneScope, SceneFinding } from "./types";

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

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

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

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

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

@@ -0,0 +1,38 @@
+import type { Diagnostic, DiagnosticEvidence } from "../../shared/errors/diagnostics";
+export type NovelSceneScope = {
+    kind: "all";
+} | {
+    kind: "chapter";
+    chapter_id: string;
+};
+export type NovelSceneArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    scope?: NovelSceneScope;
+    writeReport?: boolean;
+    requiredFields?: Array<"scene_id" | "objective" | "conflict" | "outcome" | "hook">;
+};
+export type SceneFinding = {
+    severity: "error" | "warn" | "info";
+    code: string;
+    message: string;
+    evidence: DiagnosticEvidence[];
+    suggestedFix?: string;
+    repro?: string;
+};
+export type NovelSceneResultJson = {
+    version: 1;
+    reportPath?: string;
+    stats: {
+        sceneCount: number;
+        invalidCount: number;
+        errors: number;
+        warns: number;
+        infos: number;
+        durationMs: number;
+    };
+    findings: SceneFinding[];
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

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

@@ -0,0 +1,2 @@
+export { createNovelSetupTool } from "./tool";
+export type { NovelSetupArgs, NovelSetupResultJson } from "./types";

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

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

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

@@ -0,0 +1,35 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelSetupArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    bookTitle?: string;
+    writeTemplates?: boolean;
+    forceOverwriteTemplates?: boolean;
+    exportCommands?: boolean;
+    exportSkills?: boolean;
+    forceOverwriteCommands?: boolean;
+    forceOverwriteSkills?: boolean;
+    writeConfigJsonc?: boolean;
+};
+export type NovelSetupResultJson = {
+    version: 1;
+    manuscriptDir: string;
+    configPath?: string;
+    createdDirs: string[];
+    writtenFiles: string[];
+    skippedExisting: string[];
+    commands: {
+        dir: string;
+        written: string[];
+        skipped: string[];
+    };
+    skills: {
+        dir: string;
+        written: string[];
+        skipped: string[];
+    };
+    stats: {
+        durationMs: number;
+    };
+    diagnostics: Diagnostic[];
+};

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

@@ -0,0 +1,2 @@
+export { createNovelSnapshotTool } from "./tool";
+export type { NovelSnapshotArgs, NovelSnapshotEntry, NovelSnapshotResultJson } from "./types";

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

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

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

@@ -0,0 +1,26 @@
+import type { Diagnostic } from "../../shared/errors/diagnostics";
+export type NovelSnapshotArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    tag?: string;
+    includeBible?: boolean;
+    includeDerived?: boolean;
+};
+export type NovelSnapshotEntry = {
+    source: string;
+    dest: string;
+};
+export type NovelSnapshotResultJson = {
+    version: 1;
+    tag: string;
+    snapshotDir: string;
+    entries: NovelSnapshotEntry[];
+    savedFiles: string[];
+    stats: {
+        durationMs: number;
+        savedFiles: number;
+    };
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

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

@@ -0,0 +1,2 @@
+export { createNovelStructureCheckTool } from "./tool";
+export type { NovelStructureArgs, NovelStructureResultJson, NovelStructureScope, StructureFinding, } from "./types";

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

@@ -0,0 +1,14 @@
+import type { StructureFinding } from "./types";
+export declare function renderStructureReportMd(options: {
+    stats: {
+        coverage: number;
+        requiredBeats: number;
+        seenRequiredBeats: number;
+        missing: number;
+        orderErrors: number;
+        errors: number;
+        warns: number;
+        infos: number;
+    };
+    findings: StructureFinding[];
+}): string;

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

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

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

@@ -0,0 +1,42 @@
+import type { Diagnostic, DiagnosticEvidence } from "../../shared/errors/diagnostics";
+export type NovelStructureScope = {
+    kind: "all";
+} | {
+    kind: "chapter";
+    chapter_id: string;
+};
+export type NovelStructureArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    scope?: NovelStructureScope;
+    writeReport?: boolean;
+    requiredBeats?: string[];
+    minCoverage?: number;
+};
+export type StructureFinding = {
+    severity: "error" | "warn" | "info";
+    code: string;
+    message: string;
+    evidence: DiagnosticEvidence[];
+    suggestedFix?: string;
+    repro?: string;
+};
+export type NovelStructureResultJson = {
+    version: 1;
+    reportPath?: string;
+    stats: {
+        coverage: number;
+        requiredBeats: number;
+        seenRequiredBeats: number;
+        missing: number;
+        orderErrors: number;
+        errors: number;
+        warns: number;
+        infos: number;
+        durationMs: number;
+    };
+    findings: StructureFinding[];
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

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

@@ -0,0 +1,2 @@
+export { createNovelStyleCheckTool } from "./tool";
+export type { NovelStyleArgs, NovelStyleResultJson, NovelStyleScope, StyleFinding } from "./types";

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

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

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

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

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

@@ -0,0 +1,39 @@
+import type { Diagnostic, DiagnosticEvidence } from "../../shared/errors/diagnostics";
+export type NovelStyleScope = {
+    kind: "all";
+} | {
+    kind: "chapter";
+    chapter_id: string;
+} | {
+    kind: "character";
+    id: string;
+};
+export type NovelStyleArgs = {
+    rootDir?: string;
+    manuscriptDir?: string;
+    outputDir?: string;
+    scope?: NovelStyleScope;
+    catchphraseMaxCount?: number;
+    catchphraseReportMissing?: boolean;
+    writeReport?: boolean;
+};
+export type StyleFinding = {
+    severity: "warn" | "info";
+    code: string;
+    message: string;
+    evidence: DiagnosticEvidence[];
+    suggestedFix?: string;
+    repro?: string;
+};
+export type NovelStyleResultJson = {
+    version: 1;
+    reportPath?: string;
+    stats: {
+        warns: number;
+        infos: number;
+        durationMs: number;
+    };
+    findings: StyleFinding[];
+    nextSteps?: string[];
+    diagnostics: Diagnostic[];
+};

package/dist/tools/skill/index.d.ts

@@ -0,0 +1,3 @@
+export { discoverAllSkills } from "./loader";
+export { createSkillTool } from "./tool";
+export type { LoadedSkill, SkillScope } from "./types";

package/dist/tools/skill/loader.d.ts

@@ -0,0 +1,5 @@
+import type { LoadedSkill } from "./types";
+export declare function discoverAllSkills(options: {
+    projectRoot: string;
+    disabledSkills?: string[];
+}): LoadedSkill[];

package/dist/tools/skill/tool.d.ts

@@ -0,0 +1,5 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+export declare function createSkillTool(options: {
+    projectRoot: string;
+    disabledSkills?: string[];
+}): ToolDefinition;

package/dist/tools/skill/types.d.ts

@@ -0,0 +1,14 @@
+export type SkillScope = "builtin" | "project" | "user";
+export type LoadedSkill = {
+    name: string;
+    scope: SkillScope;
+    path?: string;
+    definition: {
+        description?: string;
+        argumentHint?: string;
+        agent?: string;
+        model?: string;
+        subtask?: boolean;
+        template: string;
+    };
+};

package/dist/tools/slashcommand/index.d.ts

@@ -0,0 +1,3 @@
+export { discoverAllCommands } from "./loader";
+export { createSlashcommandTool } from "./tool";
+export type { CommandInfo, CommandScope } from "./types";

package/dist/tools/slashcommand/loader.d.ts

@@ -0,0 +1,5 @@
+import type { CommandInfo } from "./types";
+export declare function discoverAllCommands(options: {
+    projectRoot: string;
+    disabledCommands?: string[];
+}): CommandInfo[];

package/dist/tools/slashcommand/tool.d.ts

@@ -0,0 +1,6 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+export declare function createSlashcommandTool(options: {
+    projectRoot: string;
+    disabledCommands?: string[];
+    disabledSkills?: string[];
+}): ToolDefinition;

package/dist/tools/slashcommand/types.d.ts

@@ -0,0 +1,14 @@
+export type CommandScope = "builtin" | "project" | "user";
+export type CommandInfo = {
+    name: string;
+    scope: CommandScope;
+    path?: string;
+    metadata: {
+        description?: string;
+        argumentHint?: string;
+        agent?: string;
+        model?: string;
+        subtask?: boolean;
+    };
+    content: string;
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "opencode-novel",
+  "version": "0.0.1",
+  "description": "Novel writing workflow plugin for OpenCode (Bun/TypeScript).",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "opencode-novel": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema.json": "./dist/novel.schema.json"
+  },
+  "scripts": {
+    "build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly && bun run build:schema",
+    "build:schema": "bun run script/build-schema.ts",
+    "clean": "rm -rf dist",
+    "install:opencode": "bun run script/install-opencode.ts -- --target=global",
+    "uninstall:opencode": "bun run script/uninstall-opencode.ts -- --target=global",
+    "benchmark:index": "bun run script/perf-index-benchmark.ts",
+    "check:code-rules": "bun run script/check-code-rules.ts",
+    "lint": "biome check --error-on-warnings .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "check": "bun run lint && bun run check:code-rules && bun run typecheck && bun test && bun run build",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.19",
+    "@opencode-ai/sdk": "^1.1.19",
+    "docx": "^9.5.1",
+    "fflate": "^0.8.2",
+    "js-yaml": "^4.1.1",
+    "jsonc-parser": "^3.3.1",
+    "marked": "^16.2.1",
+    "picomatch": "^4.0.2",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.2.4",
+    "@types/js-yaml": "^4.0.9",
+    "@types/picomatch": "^3.0.2",
+    "bun-types": "1.3.6",
+    "lefthook": "^1.13.4",
+    "typescript": "^5.7.3"
+  }
+}