swallowkit 1.0.0-beta.54 → 1.0.0-beta.56

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

@@ -0,0 +1,195 @@
+"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 = {};
+    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 } : {}),
+        });
+    }
+    // モデルファイル自体も fingerprint に含め、Plan 後のスキーマ変更を stale として検出する
+    try {
+        const modelPath = (0, scaffold_1.resolveModelPath)(options.model);
+        fingerprints[(0, file_session_1.toProjectRelativePath)(projectRoot, modelPath)] = (0, file_session_1.hashFileIfExists)(modelPath);
+    }
+    catch {
+        // resolveModelPath が失敗する場合は collectScaffoldOperations 側で既に失敗している
+    }
+    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/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"}

package/dist/core/project/artifacts.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Artifact Ledger — `.swallowkit/artifacts.json`
+ *
+ * SwallowKit が生成・管理するファイルの所有権(Ownership)、内容ハッシュ、
+ * 生成元スキーマのハッシュ、Generator バージョンを記録する台帳。
+ * Git 管理を前提とし、Drift 検出と Plan の衝突判定の基礎データとなる。
+ */
+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.SWALLOWKIT_ARTIFACTS_VERSION = exports.SWALLOWKIT_ARTIFACTS_PATH = void 0;
+exports.loadArtifactLedger = loadArtifactLedger;
+exports.saveArtifactLedger = saveArtifactLedger;
+exports.findArtifactRecord = findArtifactRecord;
+exports.recordSessionOperations = recordSessionOperations;
+exports.inspectArtifacts = inspectArtifacts;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const version_1 = require("../../version");
+const file_session_1 = require("../operations/file-session");
+exports.SWALLOWKIT_ARTIFACTS_PATH = path.join(".swallowkit", "artifacts.json");
+exports.SWALLOWKIT_ARTIFACTS_VERSION = 1;
+function loadArtifactLedger(projectRoot = process.cwd()) {
+    const ledgerPath = path.join(projectRoot, exports.SWALLOWKIT_ARTIFACTS_PATH);
+    if (!fs.existsSync(ledgerPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(ledgerPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveArtifactLedger(ledger, projectRoot = process.cwd()) {
+    const ledgerPath = path.join(projectRoot, exports.SWALLOWKIT_ARTIFACTS_PATH);
+    fs.mkdirSync(path.dirname(ledgerPath), { recursive: true });
+    const sorted = {
+        ...ledger,
+        swallowkitVersion: (0, version_1.getSwallowKitVersion)(),
+        artifacts: [...ledger.artifacts].sort((a, b) => a.path.localeCompare(b.path)),
+    };
+    fs.writeFileSync(ledgerPath, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
+}
+function findArtifactRecord(ledger, relativePath) {
+    return ledger?.artifacts.find((record) => record.path === relativePath);
+}
+function toLastOperation(action) {
+    switch (action) {
+        case "create":
+            return "create";
+        case "modify":
+            return "update";
+        case "append":
+            return "append";
+        case "delete":
+            return "delete";
+        default:
+            return null;
+    }
+}
+/**
+ * セッションで記録された操作を台帳へ反映する。
+ * - skip は台帳更新しない(既存記録があれば schemaHash のみ更新)
+ * - delete は台帳からレコードを削除する
+ */
+function recordSessionOperations(operations, context = {}, projectRoot = process.cwd()) {
+    const ledger = loadArtifactLedger(projectRoot) ?? {
+        version: exports.SWALLOWKIT_ARTIFACTS_VERSION,
+        swallowkitVersion: (0, version_1.getSwallowKitVersion)(),
+        artifacts: [],
+    };
+    const byPath = new Map(ledger.artifacts.map((record) => [record.path, record]));
+    const now = new Date().toISOString();
+    const generatorVersion = (0, version_1.getSwallowKitVersion)();
+    for (const operation of operations) {
+        if (operation.action === "delete") {
+            byPath.delete(operation.path);
+            continue;
+        }
+        if (operation.action === "skip") {
+            const existing = byPath.get(operation.path);
+            if (existing && context.schemaHash) {
+                existing.schemaHash = context.schemaHash;
+                existing.generatorVersion = generatorVersion;
+            }
+            else if (!existing && operation.newHash) {
+                // 内容一致でも台帳未登録なら記録し、以後の Drift 検出を可能にする
+                byPath.set(operation.path, {
+                    path: operation.path,
+                    ownership: operation.ownership,
+                    generator: operation.generator,
+                    generatorVersion,
+                    sourceModel: operation.sourceModel ?? context.sourceModel,
+                    schemaHash: context.schemaHash,
+                    contentHash: operation.newHash,
+                    generatedAt: now,
+                    lastOperation: "update",
+                });
+            }
+            continue;
+        }
+        const lastOperation = toLastOperation(operation.action);
+        if (!lastOperation || !operation.newHash) {
+            continue;
+        }
+        byPath.set(operation.path, {
+            path: operation.path,
+            ownership: operation.ownership,
+            generator: operation.generator,
+            generatorVersion,
+            sourceModel: operation.sourceModel ?? context.sourceModel,
+            schemaHash: context.schemaHash,
+            contentHash: operation.newHash,
+            generatedAt: now,
+            lastOperation,
+        });
+    }
+    const updated = {
+        version: exports.SWALLOWKIT_ARTIFACTS_VERSION,
+        swallowkitVersion: generatorVersion,
+        artifacts: Array.from(byPath.values()),
+    };
+    saveArtifactLedger(updated, projectRoot);
+    return updated;
+}
+function inspectArtifacts(projectRoot = process.cwd()) {
+    const ledger = loadArtifactLedger(projectRoot);
+    if (!ledger) {
+        return { ledgerFound: false, swallowkitVersion: null, artifacts: [] };
+    }
+    const artifacts = ledger.artifacts.map((record) => {
+        const absolutePath = path.join(projectRoot, record.path);
+        const currentHash = (0, file_session_1.hashFileIfExists)(absolutePath);
+        return {
+            ...record,
+            exists: currentHash !== null,
+            modified: currentHash !== null && currentHash !== record.contentHash,
+        };
+    });
+    return {
+        ledgerFound: true,
+        swallowkitVersion: ledger.swallowkitVersion,
+        artifacts: artifacts.sort((a, b) => a.path.localeCompare(b.path)),
+    };
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/core/project/artifacts.js.map

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

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

@@ -0,0 +1,50 @@
+/**
+ * Responsibility Boundaries — AI の自由生成と SwallowKit の決定論的処理の責任分界点。
+ *
+ * Coding Agent / 自律ループが「どこを自由に書いてよいか」「どこは SwallowKit の
+ * plan/apply に委ねるべきか」を機械可読な契約として取得できるようにする。
+ *
+ * zone:
+ * - deterministic: SwallowKit が決定論的に生成・再生成する領域。手編集しない。
+ * - ai-authored:   AI / 開発者が自由に記述する領域。SwallowKit は上書きしない。
+ * - shared:        マーカー区切りの共有領域。マーカー内は SwallowKit、外は自由。
+ */
+import { ArtifactOwnership } from "../operations/file-session";
+export type BoundaryZone = "deterministic" | "ai-authored" | "shared";
+export type BoundaryEditPolicy = "never-hand-edit" | "regenerate-via-plan-apply" | "free-edit" | "edit-outside-markers";
+export interface OwnershipPolicy {
+    ownership: ArtifactOwnership;
+    zone: BoundaryZone;
+    editPolicy: BoundaryEditPolicy;
+    howToChange: string;
+}
+export interface BoundaryPathRule {
+    /** Path prefix or glob-like pattern (documentation purpose; matching is prefix-based) */
+    pattern: string;
+    zone: BoundaryZone;
+    editPolicy: BoundaryEditPolicy;
+    description: string;
+}
+export interface BoundaryArtifact {
+    path: string;
+    ownership: ArtifactOwnership;
+    zone: BoundaryZone;
+    editPolicy: BoundaryEditPolicy;
+    generator: string;
+    sourceModel?: string;
+}
+export interface BoundariesContract {
+    contractVersion: number;
+    summary: string;
+    ownershipPolicies: OwnershipPolicy[];
+    /** 台帳に載っていないパスの既定規約 */
+    conventionRules: BoundaryPathRule[];
+    /** 台帳に記録された生成物ごとの解決結果 */
+    artifacts: BoundaryArtifact[];
+    guidance: string[];
+}
+export declare const OWNERSHIP_POLICIES: OwnershipPolicy[];
+export declare const CONVENTION_RULES: BoundaryPathRule[];
+export declare const BOUNDARY_GUIDANCE: string[];
+export declare function inspectBoundaries(projectRoot?: string): BoundariesContract;
+//# sourceMappingURL=boundaries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.d.ts","sourceRoot":"","sources":["../../../src/core/project/boundaries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,2BAA2B,GAC3B,WAAW,GACX,sBAAsB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,uBAAuB;IACvB,eAAe,EAAE,gBAAgB,EAAE,CAAC;IACpC,yBAAyB;IACzB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAkC/C,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAAgB,EAuC9C,CAAC;AAIF,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAMrC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAwBzF"}

package/dist/core/project/boundaries.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Responsibility Boundaries — AI の自由生成と SwallowKit の決定論的処理の責任分界点。
+ *
+ * Coding Agent / 自律ループが「どこを自由に書いてよいか」「どこは SwallowKit の
+ * plan/apply に委ねるべきか」を機械可読な契約として取得できるようにする。
+ *
+ * zone:
+ * - deterministic: SwallowKit が決定論的に生成・再生成する領域。手編集しない。
+ * - ai-authored:   AI / 開発者が自由に記述する領域。SwallowKit は上書きしない。
+ * - shared:        マーカー区切りの共有領域。マーカー内は SwallowKit、外は自由。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOUNDARY_GUIDANCE = exports.CONVENTION_RULES = exports.OWNERSHIP_POLICIES = void 0;
+exports.inspectBoundaries = inspectBoundaries;
+const artifacts_1 = require("./artifacts");
+exports.OWNERSHIP_POLICIES = [
+    {
+        ownership: "managed",
+        zone: "deterministic",
+        editPolicy: "regenerate-via-plan-apply",
+        howToChange: "Edit the source model (shared/models/*.ts) or configuration, then run `swallowkit machine plan scaffold <model>` and `apply scaffold`. Hand-edits are detected as drift and require --approve to overwrite.",
+    },
+    {
+        ownership: "generated-once",
+        zone: "ai-authored",
+        editPolicy: "free-edit",
+        howToChange: "Generated once as a starting point. Edit freely; SwallowKit never regenerates it.",
+    },
+    {
+        ownership: "user-owned",
+        zone: "ai-authored",
+        editPolicy: "free-edit",
+        howToChange: "Owned by the developer/AI. SwallowKit only creates the initial version (e.g. model files). Edit freely; managed artifacts are regenerated from it.",
+    },
+    {
+        ownership: "extension-point",
+        zone: "shared",
+        editPolicy: "edit-outside-markers",
+        howToChange: "SwallowKit appends only inside marked sections (e.g. `# SwallowKit scaffold registrations`). Edit anywhere outside the markers freely; do not remove the markers.",
+    },
+    {
+        ownership: "metadata",
+        zone: "deterministic",
+        editPolicy: "never-hand-edit",
+        howToChange: "Managed entirely by SwallowKit tooling (.swallowkit/). Never hand-edit.",
+    },
+];
+exports.CONVENTION_RULES = [
+    {
+        pattern: ".swallowkit/",
+        zone: "deterministic",
+        editPolicy: "never-hand-edit",
+        description: "SwallowKit metadata (manifest, artifact ledger, plan state). Managed by tooling only.",
+    },
+    {
+        pattern: "shared/models/",
+        zone: "ai-authored",
+        editPolicy: "free-edit",
+        description: "Zod model schemas — the single source of truth. AI/developers author these freely; deterministic generation derives everything else from them.",
+    },
+    {
+        pattern: "infra/main.bicep",
+        zone: "shared",
+        editPolicy: "edit-outside-markers",
+        description: "SwallowKit inserts container modules; other infrastructure edits are free.",
+    },
+    {
+        pattern: "functions/function_app.py",
+        zone: "shared",
+        editPolicy: "edit-outside-markers",
+        description: "SwallowKit appends blueprint registrations under its marker; other edits are free.",
+    },
+    {
+        pattern: "shared/index.ts",
+        zone: "shared",
+        editPolicy: "edit-outside-markers",
+        description: "SwallowKit appends model exports; other exports may be added freely.",
+    },
+    {
+        pattern: "*",
+        zone: "ai-authored",
+        editPolicy: "free-edit",
+        description: "Any path not recorded in the artifact ledger is AI/developer-authored. Business logic, custom pages, custom Functions, and tests belong here.",
+    },
+];
+const POLICY_BY_OWNERSHIP = new Map(exports.OWNERSHIP_POLICIES.map((policy) => [policy.ownership, policy]));
+exports.BOUNDARY_GUIDANCE = [
+    "Author models and business logic freely (ai-authored zone), then let SwallowKit derive CRUD/BFF/UI/infra deterministically via plan/apply.",
+    "Never hand-edit deterministic-zone files; change the model or configuration and regenerate instead.",
+    "Use `swallowkit machine plan scaffold <model>` before applying; a plan with requiresApproval=true means a human (or explicit --approve) must confirm overwriting hand-edited files.",
+    "In shared-zone files, keep SwallowKit markers intact and edit outside them.",
+    "Run `swallowkit machine verify project` after applying changes; use `explain failure` to get repair evidence.",
+];
+function inspectBoundaries(projectRoot = process.cwd()) {
+    const inspected = (0, artifacts_1.inspectArtifacts)(projectRoot);
+    const artifacts = inspected.artifacts.map((artifact) => {
+        const policy = POLICY_BY_OWNERSHIP.get(artifact.ownership);
+        return {
+            path: artifact.path,
+            ownership: artifact.ownership,
+            zone: policy?.zone ?? "ai-authored",
+            editPolicy: policy?.editPolicy ?? "free-edit",
+            generator: artifact.generator,
+            ...(artifact.sourceModel ? { sourceModel: artifact.sourceModel } : {}),
+        };
+    });
+    return {
+        contractVersion: 1,
+        summary: "SwallowKit separates deterministic generation (models → CRUD/BFF/UI/infra via plan/apply) from AI free-form authoring (models, business logic, custom code). This contract tells agents which files belong to which side.",
+        ownershipPolicies: exports.OWNERSHIP_POLICIES,
+        conventionRules: exports.CONVENTION_RULES,
+        artifacts,
+        guidance: exports.BOUNDARY_GUIDANCE,
+    };
+}
+//# sourceMappingURL=boundaries.js.map

package/dist/core/project/boundaries.js.map

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