swallowkit 1.0.0-beta.9 → 1.0.0

package/dist/core/operations/scaffold-machine.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMachineScaffoldOperation = runMachineScaffoldOperation;
+const scaffold_1 = require("../../cli/commands/scaffold");
+const runtime_1 = require("./runtime");
+function deriveErrorMessage(messages) {
+    return (0, runtime_1.deriveCapturedErrorMessage)(messages, "Scaffold failed.");
+}
+async function runMachineScaffoldOperation(options) {
+    const originalMachineOutput = process.env.SWALLOWKIT_MACHINE_OUTPUT;
+    process.env.SWALLOWKIT_MACHINE_OUTPUT = "1";
+    try {
+        const tracked = await (0, runtime_1.trackFileMutations)(async () => {
+            const captured = await (0, runtime_1.captureConsoleMessagesWithError)(async () => {
+                await (0, runtime_1.interceptProcessExit)(async () => {
+                    await (0, scaffold_1.scaffoldCommand)(options);
+                });
+            });
+            if (captured.error) {
+                if (captured.error instanceof runtime_1.ProcessExitInterceptError) {
+                    throw new Error(deriveErrorMessage(captured.messages));
+                }
+                if (captured.error instanceof Error) {
+                    throw captured.error;
+                }
+                throw new Error(deriveErrorMessage(captured.messages));
+            }
+            return captured.messages;
+        });
+        return {
+            createdFiles: tracked.mutations.createdFiles,
+            updatedFiles: tracked.mutations.updatedFiles,
+            appendedFiles: tracked.mutations.appendedFiles,
+            deletedFiles: tracked.mutations.deletedFiles,
+            createdDirectories: tracked.mutations.createdDirectories,
+            diagnostics: [
+                ...tracked.result.warnings.map((warning) => `warning:${warning}`),
+                ...tracked.result.errors.map((error) => `error:${error}`),
+            ],
+        };
+    }
+    finally {
+        if (originalMachineOutput === undefined) {
+            delete process.env.SWALLOWKIT_MACHINE_OUTPUT;
+        }
+        else {
+            process.env.SWALLOWKIT_MACHINE_OUTPUT = originalMachineOutput;
+        }
+    }
+}
+//# sourceMappingURL=scaffold-machine.js.map

package/dist/core/operations/scaffold-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-machine.js","sourceRoot":"","sources":["../../../src/core/operations/scaffold-machine.ts"],"names":[],"mappings":";;AA6BA,kEA+CC;AA5ED,0DAA8D;AAC9D,uCAMmB;AAkBnB,SAAS,kBAAkB,CAAC,QAAkE;IAC5F,OAAO,IAAA,oCAA0B,EAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAClE,CAAC;AAEM,KAAK,UAAU,2BAA2B,CAC/C,OAAwC;IAExC,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,GAAG,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAkB,EAAC,KAAK,IAAI,EAAE;YAClD,MAAM,QAAQ,GAAG,MAAM,IAAA,yCAA+B,EAAC,KAAK,IAAI,EAAE;gBAChE,MAAM,IAAA,8BAAoB,EAAC,KAAK,IAAI,EAAE;oBACpC,MAAM,IAAA,0BAAe,EAAC,OAAO,CAAC,CAAC;gBACjC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,IAAI,QAAQ,CAAC,KAAK,YAAY,mCAAyB,EAAE,CAAC;oBACxD,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzD,CAAC;gBAED,IAAI,QAAQ,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;oBACpC,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,QAAQ,CAAC,QAAQ,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY;YAC5C,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY;YAC5C,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa;YAC9C,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY;YAC5C,kBAAkB,EAAE,OAAO,CAAC,SAAS,CAAC,kBAAkB;YACxD,WAAW,EAAE;gBACX,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,OAAO,EAAE,CAAC;gBACjE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC;aAC1D;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,qBAAqB,CAAC;QAChE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/operations/scaffold-plan.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Plan Scaffold — scaffold を collect モードで実行し、書き込み予定を差分計画として返す。
+ * ディスクへの書き込みは一切行わない。
+ */
+import { ArtifactOwnership } from "./file-session";
+export interface PlanScaffoldOptions {
+    model: string;
+    functionsDir?: string;
+    apiDir?: string;
+    apiOnly?: boolean;
+}
+export type ScaffoldPlanAction = "create" | "update" | "overwrite" | "append" | "delete" | "skip";
+export interface ScaffoldPlanOperation {
+    path: string;
+    action: ScaffoldPlanAction;
+    ownership: ArtifactOwnership;
+    conflict: boolean;
+    conflictReason?: string;
+}
+export interface ScaffoldPlanData {
+    planId: string;
+    planType: "scaffold";
+    model: string;
+    options: {
+        functionsDir?: string;
+        apiDir?: string;
+        apiOnly?: boolean;
+    };
+    createdAt: string;
+    swallowkitVersion: string;
+    operations: ScaffoldPlanOperation[];
+    warnings: string[];
+    conflicts: ScaffoldPlanOperation[];
+    requiresApproval: boolean;
+    /** project-relative path -> pre-plan content hash (null = did not exist). Used for stale-plan detection. */
+    fingerprints: Record<string, string | null>;
+}
+export declare function planScaffoldOperation(options: PlanScaffoldOptions): Promise<ScaffoldPlanData>;
+export declare function verifyPlanFingerprints(plan: ScaffoldPlanData, projectRoot?: string): {
+    fresh: boolean;
+    changedFiles: string[];
+};
+//# sourceMappingURL=scaffold-plan.d.ts.map

package/dist/core/operations/scaffold-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-plan.d.ts","sourceRoot":"","sources":["../../../src/core/operations/scaffold-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EACL,iBAAiB,EAIlB,MAAM,gBAAgB,CAAC;AAQxB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4GAA4G;IAC5G,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7C;AAgDD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8FnG;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,gBAAgB,EACtB,WAAW,GAAE,MAAsB,GAClC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAS5C"}

package/dist/core/operations/scaffold-plan.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * Plan Scaffold — scaffold を collect モードで実行し、書き込み予定を差分計画として返す。
+ * ディスクへの書き込みは一切行わない。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planScaffoldOperation = planScaffoldOperation;
+exports.verifyPlanFingerprints = verifyPlanFingerprints;
+const crypto = __importStar(require("crypto"));
+const path = __importStar(require("path"));
+const scaffold_1 = require("../../cli/commands/scaffold");
+const version_1 = require("../../version");
+const artifacts_1 = require("../project/artifacts");
+const state_1 = require("../project/state");
+const file_session_1 = require("./file-session");
+const runtime_1 = require("./runtime");
+function deriveScaffoldErrorMessage(messages) {
+    return (0, runtime_1.deriveCapturedErrorMessage)(messages, "Scaffold plan failed.");
+}
+/**
+ * scaffold を collect セッションで実行し、記録された操作を返す。
+ */
+async function collectScaffoldOperations(options) {
+    const session = new file_session_1.FileOperationSession("collect");
+    const originalMachineOutput = process.env.SWALLOWKIT_MACHINE_OUTPUT;
+    process.env.SWALLOWKIT_MACHINE_OUTPUT = "1";
+    try {
+        const captured = await (0, runtime_1.captureConsoleMessagesWithError)(async () => {
+            await (0, runtime_1.interceptProcessExit)(async () => {
+                await (0, file_session_1.runWithFileSession)(session, async () => {
+                    await (0, scaffold_1.scaffoldCommand)({
+                        model: options.model,
+                        functionsDir: options.functionsDir,
+                        apiDir: options.apiDir,
+                        apiOnly: options.apiOnly,
+                    });
+                });
+            });
+        });
+        if (captured.error) {
+            if (captured.error instanceof runtime_1.ProcessExitInterceptError) {
+                throw new Error(deriveScaffoldErrorMessage(captured.messages));
+            }
+            if (captured.error instanceof Error) {
+                throw captured.error;
+            }
+            throw new Error(deriveScaffoldErrorMessage(captured.messages));
+        }
+        return session;
+    }
+    finally {
+        if (originalMachineOutput === undefined) {
+            delete process.env.SWALLOWKIT_MACHINE_OUTPUT;
+        }
+        else {
+            process.env.SWALLOWKIT_MACHINE_OUTPUT = originalMachineOutput;
+        }
+    }
+}
+async function planScaffoldOperation(options) {
+    const projectRoot = process.cwd();
+    const session = await collectScaffoldOperations(options);
+    const ledger = (0, artifacts_1.loadArtifactLedger)(projectRoot);
+    const operations = [];
+    const fingerprints = { ...session.inputFingerprints };
+    const warnings = [...session.warnings];
+    for (const op of session.operations) {
+        fingerprints[op.path] = op.previousHash;
+        let action;
+        let conflict = false;
+        let conflictReason;
+        switch (op.action) {
+            case "create":
+                action = "create";
+                break;
+            case "skip":
+                action = "skip";
+                break;
+            case "append":
+                action = "append";
+                break;
+            case "delete":
+                action = "delete";
+                break;
+            case "modify": {
+                const record = ledger ? (0, artifacts_1.findArtifactRecord)(ledger, op.path) : undefined;
+                if (record && record.contentHash === op.previousHash) {
+                    // 生成後に変更されていない managed ファイルの再生成 — 安全
+                    action = "update";
+                }
+                else if (record) {
+                    action = "overwrite";
+                    conflict = true;
+                    conflictReason = "modified-after-generation";
+                }
+                else {
+                    action = "overwrite";
+                    conflict = true;
+                    conflictReason = "unknown-provenance";
+                    warnings.push(`unknown-provenance: ${op.path} exists but is not tracked in .swallowkit/artifacts.json; regenerating will overwrite it.`);
+                }
+                break;
+            }
+        }
+        operations.push({
+            path: op.path,
+            action,
+            ownership: op.ownership,
+            conflict,
+            ...(conflictReason ? { conflictReason } : {}),
+        });
+    }
+    const conflicts = operations.filter((op) => op.conflict);
+    const planId = crypto
+        .createHash("sha256")
+        .update(JSON.stringify({
+        model: options.model,
+        options: { functionsDir: options.functionsDir, apiDir: options.apiDir, apiOnly: options.apiOnly },
+        operations: operations.map((op) => ({ path: op.path, action: op.action })),
+        fingerprints,
+    }))
+        .digest("hex")
+        .slice(0, 12);
+    const plan = {
+        planId,
+        planType: "scaffold",
+        model: options.model,
+        options: {
+            ...(options.functionsDir ? { functionsDir: options.functionsDir } : {}),
+            ...(options.apiDir ? { apiDir: options.apiDir } : {}),
+            ...(options.apiOnly !== undefined ? { apiOnly: options.apiOnly } : {}),
+        },
+        createdAt: new Date().toISOString(),
+        swallowkitVersion: (0, version_1.getSwallowKitVersion)(),
+        operations,
+        warnings,
+        conflicts,
+        requiresApproval: conflicts.length > 0,
+        fingerprints,
+    };
+    (0, state_1.savePlanState)(plan, projectRoot);
+    return plan;
+}
+function verifyPlanFingerprints(plan, projectRoot = process.cwd()) {
+    const changedFiles = [];
+    for (const [relativePath, expectedHash] of Object.entries(plan.fingerprints)) {
+        const currentHash = (0, file_session_1.hashFileIfExists)(path.join(projectRoot, relativePath));
+        if (currentHash !== expectedHash) {
+            changedFiles.push(relativePath);
+        }
+    }
+    return { fresh: changedFiles.length === 0, changedFiles };
+}
+//# sourceMappingURL=scaffold-plan.js.map

package/dist/core/operations/scaffold-plan.js.map

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

package/dist/core/project/agent-instructions.d.ts

@@ -0,0 +1,29 @@
+import { BackendLanguage } from "../../types";
+import { PackageManager } from "../../utils/package-manager";
+export interface AgentInstructionContext {
+    projectName: string;
+    backendLanguage: BackendLanguage;
+    packageManager: PackageManager;
+}
+export interface AgentInstructionDocuments {
+    agentsMd: string;
+    claudeMd: string;
+    copilotInstructions: string;
+    pathSpecificInstructions: Record<string, string>;
+}
+export declare const AGENT_TEMPLATE_FILES: {
+    readonly agentsMd: "AGENTS.md";
+    readonly claudeMd: "CLAUDE.md";
+    readonly copilotInstructions: "copilot-instructions.md";
+    readonly sharedModelsInstructions: "shared-models.instructions.md";
+    readonly bffRoutesInstructions: "bff-routes.instructions.md";
+    readonly azureFunctionsInstructions: "azure-functions.instructions.md";
+};
+export declare function readAgentInstructionTemplate(fileName: string): string;
+export declare function buildAgentsMd(context: AgentInstructionContext): string;
+export declare function buildClaudeMd(context: AgentInstructionContext): string;
+export declare function buildCopilotInstructions(context: AgentInstructionContext): string;
+export declare function buildPathSpecificInstructions(context: AgentInstructionContext): Record<string, string>;
+export declare function buildAgentInstructionDocuments(context: AgentInstructionContext): AgentInstructionDocuments;
+export declare function writeAgentInstructionFiles(projectDir: string, context: AgentInstructionContext): AgentInstructionDocuments;
+//# sourceMappingURL=agent-instructions.d.ts.map

package/dist/core/project/agent-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../../src/core/project/agent-instructions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAe,MAAM,6BAA6B,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,oBAAoB;;;;;;;CAOvB,CAAC;AAoBX,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErE;AAyDD,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAEtE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAEjF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,uBAAuB,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,uBAAuB,GAC/B,yBAAyB,CAO3B;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,GAC/B,yBAAyB,CAiB3B"}

package/dist/core/project/agent-instructions.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_TEMPLATE_FILES = void 0;
+exports.readAgentInstructionTemplate = readAgentInstructionTemplate;
+exports.buildAgentsMd = buildAgentsMd;
+exports.buildClaudeMd = buildClaudeMd;
+exports.buildCopilotInstructions = buildCopilotInstructions;
+exports.buildPathSpecificInstructions = buildPathSpecificInstructions;
+exports.buildAgentInstructionDocuments = buildAgentInstructionDocuments;
+exports.writeAgentInstructionFiles = writeAgentInstructionFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const package_manager_1 = require("../../utils/package-manager");
+exports.AGENT_TEMPLATE_FILES = {
+    agentsMd: "AGENTS.md",
+    claudeMd: "CLAUDE.md",
+    copilotInstructions: "copilot-instructions.md",
+    sharedModelsInstructions: "shared-models.instructions.md",
+    bffRoutesInstructions: "bff-routes.instructions.md",
+    azureFunctionsInstructions: "azure-functions.instructions.md",
+};
+const BACKEND_LANGUAGE_LABELS = {
+    typescript: "TypeScript",
+    csharp: "C#",
+    python: "Python",
+};
+function getTemplatePath(fileName) {
+    const candidates = [
+        path.join(__dirname, "agent-templates", fileName),
+        path.join(__dirname, "../../../src/core/project/agent-templates", fileName),
+    ];
+    const templatePath = candidates.find((candidate) => fs.existsSync(candidate));
+    if (!templatePath) {
+        throw new Error(`Agent instruction template not found: ${fileName}`);
+    }
+    return templatePath;
+}
+function readAgentInstructionTemplate(fileName) {
+    return fs.readFileSync(getTemplatePath(fileName), "utf-8").replace(/\r\n/g, "\n");
+}
+function getFunctionsStructureLine(backendLanguage) {
+    if (backendLanguage === "typescript") {
+        return "│   └── src/               # HTTP trigger handlers with Cosmos DB bindings";
+    }
+    if (backendLanguage === "csharp") {
+        return "│   ├── Crud/              # C# HTTP trigger handlers\n│   └── generated/         # Native-generated C# schema assets";
+    }
+    return "│   ├── blueprints/        # Python HTTP trigger handlers\n│   └── generated/         # Native-generated Python schema assets";
+}
+function getBackendRules(backendLanguage) {
+    if (backendLanguage === "typescript") {
+        return [
+            "- All backend business logic and data access live in `functions/src/`.",
+            "- Prefer Azure Functions Cosmos DB input/output bindings for reads and writes.",
+            "- Use the Cosmos DB SDK directly only where bindings do not support the operation, such as deletes.",
+            "- Validate data against the shared Zod schemas before persistence.",
+        ].join("\n");
+    }
+    return [
+        "- All backend business logic and data access live in `functions/`.",
+        `- SwallowKit derives OpenAPI and native ${BACKEND_LANGUAGE_LABELS[backendLanguage]} schema assets from the Zod source of truth.`,
+        "- Keep custom business logic in ai-authored locations identified by the current boundary contract.",
+    ].join("\n");
+}
+function interpolateTemplate(template, context) {
+    const runCmd = (0, package_manager_1.getCommands)(context.packageManager).exec;
+    const replacements = {
+        projectName: context.projectName,
+        backendLanguageLabel: BACKEND_LANGUAGE_LABELS[context.backendLanguage],
+        functionsStructureLine: getFunctionsStructureLine(context.backendLanguage),
+        backendRules: getBackendRules(context.backendLanguage),
+        pm: context.packageManager,
+        runCmd,
+    };
+    const result = template.replace(/\{\{([A-Za-z]+)\}\}/g, (placeholder, key) => {
+        const replacement = replacements[key];
+        if (replacement === undefined) {
+            throw new Error(`Unknown Agent instruction placeholder: ${placeholder}`);
+        }
+        return replacement;
+    });
+    if (/\{\{[^}]+\}\}/.test(result)) {
+        throw new Error("Unresolved Agent instruction template placeholder");
+    }
+    return result;
+}
+function buildTemplate(fileName, context) {
+    return interpolateTemplate(readAgentInstructionTemplate(fileName), context);
+}
+function buildAgentsMd(context) {
+    return buildTemplate(exports.AGENT_TEMPLATE_FILES.agentsMd, context);
+}
+function buildClaudeMd(context) {
+    return buildTemplate(exports.AGENT_TEMPLATE_FILES.claudeMd, context);
+}
+function buildCopilotInstructions(context) {
+    return buildTemplate(exports.AGENT_TEMPLATE_FILES.copilotInstructions, context);
+}
+function buildPathSpecificInstructions(context) {
+    return {
+        [exports.AGENT_TEMPLATE_FILES.sharedModelsInstructions]: buildTemplate(exports.AGENT_TEMPLATE_FILES.sharedModelsInstructions, context),
+        [exports.AGENT_TEMPLATE_FILES.bffRoutesInstructions]: buildTemplate(exports.AGENT_TEMPLATE_FILES.bffRoutesInstructions, context),
+        [exports.AGENT_TEMPLATE_FILES.azureFunctionsInstructions]: buildTemplate(exports.AGENT_TEMPLATE_FILES.azureFunctionsInstructions, context),
+    };
+}
+function buildAgentInstructionDocuments(context) {
+    return {
+        agentsMd: buildAgentsMd(context),
+        claudeMd: buildClaudeMd(context),
+        copilotInstructions: buildCopilotInstructions(context),
+        pathSpecificInstructions: buildPathSpecificInstructions(context),
+    };
+}
+function writeAgentInstructionFiles(projectDir, context) {
+    const documents = buildAgentInstructionDocuments(context);
+    fs.writeFileSync(path.join(projectDir, "AGENTS.md"), documents.agentsMd, "utf-8");
+    fs.writeFileSync(path.join(projectDir, "CLAUDE.md"), documents.claudeMd, "utf-8");
+    const githubDir = path.join(projectDir, ".github");
+    const instructionsDir = path.join(githubDir, "instructions");
+    fs.mkdirSync(instructionsDir, { recursive: true });
+    fs.writeFileSync(path.join(githubDir, "copilot-instructions.md"), documents.copilotInstructions, "utf-8");
+    for (const [fileName, content] of Object.entries(documents.pathSpecificInstructions)) {
+        fs.writeFileSync(path.join(instructionsDir, fileName), content, "utf-8");
+    }
+    return documents;
+}
+//# sourceMappingURL=agent-instructions.js.map

package/dist/core/project/agent-instructions.js.map

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

package/dist/core/project/artifacts.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Artifact Ledger — `.swallowkit/artifacts.json`
+ *
+ * SwallowKit が生成・管理するファイルの所有権(Ownership)、内容ハッシュ、
+ * 生成元スキーマのハッシュ、Generator バージョンを記録する台帳。
+ * Git 管理を前提とし、Drift 検出と Plan の衝突判定の基礎データとなる。
+ */
+import { ArtifactOwnership, RecordedFileOperation } from "../operations/file-session";
+export declare const SWALLOWKIT_ARTIFACTS_PATH: string;
+export declare const SWALLOWKIT_ARTIFACTS_VERSION = 1;
+export type ArtifactLastOperation = "create" | "update" | "append" | "delete";
+export interface ArtifactRecord {
+    /** Project-relative POSIX path */
+    path: string;
+    ownership: ArtifactOwnership;
+    /** Logical generator name, e.g. "scaffold", "create-model" */
+    generator: string;
+    generatorVersion: string;
+    /** Entity name the artifact was generated from, if any */
+    sourceModel?: string;
+    /** sha256 (LF normalized) of the source model file at generation time */
+    schemaHash?: string;
+    /** sha256 (LF normalized) of the artifact content at generation time */
+    contentHash: string;
+    generatedAt: string;
+    lastOperation: ArtifactLastOperation;
+}
+export interface ArtifactLedger {
+    version: number;
+    swallowkitVersion: string;
+    artifacts: ArtifactRecord[];
+}
+export declare function loadArtifactLedger(projectRoot?: string): ArtifactLedger | null;
+export declare function saveArtifactLedger(ledger: ArtifactLedger, projectRoot?: string): void;
+export declare function findArtifactRecord(ledger: ArtifactLedger | null, relativePath: string): ArtifactRecord | undefined;
+export interface RecordArtifactContext {
+    /** sha256 of the source model file, when the operation batch originates from one model */
+    schemaHash?: string;
+    /** Fallback source model name */
+    sourceModel?: string;
+}
+/**
+ * セッションで記録された操作を台帳へ反映する。
+ * - skip は台帳更新しない(既存記録があれば schemaHash のみ更新)
+ * - delete は台帳からレコードを削除する
+ */
+export declare function recordSessionOperations(operations: RecordedFileOperation[], context?: RecordArtifactContext, projectRoot?: string): ArtifactLedger;
+export interface InspectedArtifact extends ArtifactRecord {
+    exists: boolean;
+    /** true when the current on-disk content differs from the recorded contentHash */
+    modified: boolean;
+}
+export declare function inspectArtifacts(projectRoot?: string): {
+    ledgerFound: boolean;
+    swallowkitVersion: string | null;
+    artifacts: InspectedArtifact[];
+};
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/core/project/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/core/project/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EAEtB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,yBAAyB,QAA6C,CAAC;AACpF,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,iBAAiB,CAAC;IAC7B,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,qBAAqB,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,MAAsB,GAAG,cAAc,GAAG,IAAI,CAW7F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CASpG;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,GAAG,IAAI,EAC7B,YAAY,EAAE,MAAM,GACnB,cAAc,GAAG,SAAS,CAE5B;AAiBD,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,GAAE,qBAA0B,EACnC,WAAW,GAAE,MAAsB,GAClC,cAAc,CAgEhB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,GAAE,MAAsB,GAAG;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC,CAqBA"}