@milenyumai/film-kit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# ShotForge Agent Configuration
+
+ShotForge artık bir **agent configuration npm paketi**dir.
+Amaç: Cursor, Claude Code, VS Code Copilot ve Google Antigravity için proje içinde doğru kural/skill dosyalarını otomatik oluşturmak.
+
+Bu paket **shot üreten bir CLI değildir**.
+Editördeki AI ajanlarına `/generate` davranışını öğreten yapı dosyalarını yazar.
+
+## Ne Oluşturur?
+
+### Cursor
+- `./.cursorrules` (legacy)
+- `./.cursor/rules/global.mdc`
+- (ortak sözleşme) `./AGENTS.md`
+
+### Claude Code
+- `./CLAUDE.md`
+- `./.claude/CLAUDE.md`
+- `./.claude/rules/generate-flow.md`
+- `./.claude/rules/output-contract.md`
+- `./.claude/settings.json`
+- `./.claude/settings.local.json`
+
+### VS Code Copilot
+- `./.github/copilot-instructions.md`
+- `./.github/instructions/shotforge.instructions.md`
+
+### Google Antigravity
+- `./.agent/skills/shotforge-generate/SKILL.md`
+
+## Kurulum
+
+```bash
+npm i -D @your-scope/shotforge-agent-config
+```
+
+Kurulumdan sonra paket `postinstall` ile proje köküne dosyaları yazmaya çalışır.
+
+## Opsiyonel Proje Konfigürasyonu
+
+Proje köküne `shotforge-agent.config.json` koyarsan varsayılanları özelleştirebilirsin:
+
+```json
+{
+  "outputDir": "./shots",
+  "scenarioHint": "scenario.md",
+  "platforms": ["cursor", "claude", "copilot", "antigravity"],
+  "overwrite": false,
+  "includeAgentsMd": true
+}
+```
+
+## Programatik Kullanım (CLI yok)
+
+İstersen Node içinden direkt çağırabilirsin:
+
+```ts
+import { configureAgents } from "@your-scope/shotforge-agent-config";
+
+await configureAgents({
+  rootDir: process.cwd(),
+  outputDir: "./shots",
+  scenarioHint: "scenario.md",
+  platforms: ["cursor", "claude", "copilot", "antigravity"],
+  overwrite: false
+});
+```
+
+## Editör Davranış Sözleşmesi
+
+Yazılan dosyalar editör AI'ına şu kontratı verir:
+- Kullanıcı `/generate` dediğinde seçili/aktif senaryo dosyasını oku.
+- `./shots/bible.md` ve `./shots/S01.md ...` formatında markdown çıktısı üret.
+- Shot dosyalarında prompt + cinematography + continuity bilgisi olsun.
+
+## Global Skill Notu (Antigravity)
+
+Bu paket varsayılan olarak sadece workspace içine yazar.
+Global skill yolu bilgi amaçlı:
+- `~/.gemini/antigravity/skills/<skill-adı>/SKILL.md`
+
+## Geliştirme
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```

package/build/index.d.ts

@@ -0,0 +1,2 @@
+export { configureAgents } from "./lib/configure.js";
+export type { AgentConfigOptions, ConfigureResult, SupportedPlatform } from "./lib/types.js";

package/build/index.js

@@ -0,0 +1 @@
+export { configureAgents } from "./lib/configure.js";

package/build/lib/configure.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfigOptions, ConfigureResult } from "./types.js";
+export declare function configureAgents(options?: AgentConfigOptions): Promise<ConfigureResult>;

package/build/lib/configure.js

@@ -0,0 +1,119 @@
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readdir, readFile } from "node:fs/promises";
+import { exists, readJsonIfExists, writeText } from "./fs.js";
+import { resolveOptions } from "./defaults.js";
+import { buildProjectFiles } from "./templates.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Resolve the path to the package's content/ directory.
+ * Works both in development (src/lib/) and in the published package (build/lib/).
+ */
+function getContentDir() {
+    // __dirname is either src/lib or build/lib — go up two levels to package root
+    return join(__dirname, "..", "..", "content");
+}
+/**
+ * Recursively collect all files in a directory, returning relative paths.
+ */
+async function collectFiles(dir, prefix = "") {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        const abs = join(dir, entry.name);
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            const nested = await collectFiles(abs, rel);
+            results.push(...nested);
+        }
+        else if (entry.isFile()) {
+            results.push({ relativePath: rel, absolutePath: abs });
+        }
+    }
+    return results;
+}
+/**
+ * Copy content files from the package's content/ directory into the target project's .agent/ directory.
+ */
+async function copyContentFiles(rootDir, overwrite, templateVars) {
+    const contentDir = getContentDir();
+    const contentExists = await exists(contentDir);
+    if (!contentExists) {
+        return { written: [], skipped: [] };
+    }
+    const files = await collectFiles(contentDir);
+    const written = [];
+    const skipped = [];
+    for (const file of files) {
+        const targetRelative = `.agent/${file.relativePath}`;
+        const targetAbsolute = join(rootDir, targetRelative);
+        const targetExists = await exists(targetAbsolute);
+        if (targetExists && !overwrite) {
+            skipped.push(targetRelative);
+            continue;
+        }
+        const rawContent = await readFile(file.absolutePath, "utf8");
+        const content = renderContentTemplate(rawContent, templateVars);
+        await writeText(targetAbsolute, content);
+        written.push(targetRelative);
+    }
+    return { written, skipped };
+}
+function renderContentTemplate(content, vars) {
+    return content
+        .replaceAll("$OUTPUT_DIR", vars.outputDir)
+        .replaceAll("$SCENARIO_HINT", vars.scenarioHint)
+        .replaceAll("$ARGUMENTS", "");
+}
+export async function configureAgents(options = {}) {
+    const rootDir = options.rootDir ?? process.cwd();
+    const packageConfigPath = join(rootDir, "shotforge-agent.config.json");
+    const fromFile = await readJsonIfExists(packageConfigPath);
+    const merged = { rootDir };
+    const outputDir = options.outputDir ?? fromFile?.outputDir;
+    const scenarioHint = options.scenarioHint ?? fromFile?.scenarioHint;
+    const platforms = options.platforms ?? fromFile?.platforms;
+    const overwrite = options.overwrite ?? fromFile?.overwrite;
+    const includeAgentsMd = options.includeAgentsMd ?? fromFile?.includeAgentsMd;
+    const copyContent = options.copyContent ?? fromFile?.copyContent;
+    if (outputDir !== undefined)
+        merged.outputDir = outputDir;
+    if (scenarioHint !== undefined)
+        merged.scenarioHint = scenarioHint;
+    if (platforms !== undefined)
+        merged.platforms = platforms;
+    if (overwrite !== undefined)
+        merged.overwrite = overwrite;
+    if (includeAgentsMd !== undefined)
+        merged.includeAgentsMd = includeAgentsMd;
+    if (copyContent !== undefined)
+        merged.copyContent = copyContent;
+    const resolved = resolveOptions(merged);
+    // 1. Copy content files (.agent/ system) if enabled
+    const contentResult = resolved.copyContent
+        ? await copyContentFiles(resolved.rootDir, resolved.overwrite, {
+            outputDir: resolved.outputDir,
+            scenarioHint: resolved.scenarioHint
+        })
+        : { written: [], skipped: [] };
+    // 2. Generate platform-specific config files
+    const files = buildProjectFiles(resolved);
+    const written = [...contentResult.written];
+    const skipped = [...contentResult.skipped];
+    for (const [relativePath, content] of Object.entries(files)) {
+        const absolutePath = join(resolved.rootDir, relativePath);
+        const fileExists = await exists(absolutePath);
+        if (fileExists && !resolved.overwrite) {
+            skipped.push(relativePath);
+            continue;
+        }
+        await writeText(absolutePath, content);
+        written.push(relativePath);
+    }
+    return {
+        rootDir: resolved.rootDir,
+        written,
+        skipped
+    };
+}

package/build/lib/defaults.d.ts

@@ -0,0 +1,2 @@
+import type { AgentConfigOptions, ResolvedAgentConfig } from "./types.js";
+export declare function resolveOptions(input: AgentConfigOptions): ResolvedAgentConfig;

package/build/lib/defaults.js

@@ -0,0 +1,12 @@
+const ALL_PLATFORMS = ["cursor", "claude", "copilot", "antigravity"];
+export function resolveOptions(input) {
+    return {
+        rootDir: input.rootDir ?? process.cwd(),
+        outputDir: input.outputDir ?? "./outputs",
+        scenarioHint: input.scenarioHint ?? "scenario.md",
+        platforms: (input.platforms && input.platforms.length > 0 ? input.platforms : ALL_PLATFORMS).slice(),
+        overwrite: input.overwrite ?? false,
+        includeAgentsMd: input.includeAgentsMd ?? true,
+        copyContent: input.copyContent ?? true
+    };
+}

package/build/lib/fs.d.ts

@@ -0,0 +1,3 @@
+export declare function exists(path: string): Promise<boolean>;
+export declare function readJsonIfExists<T>(path: string): Promise<T | undefined>;
+export declare function writeText(path: string, content: string): Promise<void>;

package/build/lib/fs.js

@@ -0,0 +1,23 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { constants } from "node:fs";
+import { dirname } from "node:path";
+export async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readJsonIfExists(path) {
+    if (!(await exists(path))) {
+        return undefined;
+    }
+    const text = await readFile(path, "utf8");
+    return JSON.parse(text);
+}
+export async function writeText(path, content) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, "utf8");
+}

package/build/lib/templates.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedAgentConfig } from "./types.js";
+export declare function buildProjectFiles(config: ResolvedAgentConfig): Record<string, string>;