swallowkit 1.0.0-beta.9 → 1.0.0

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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"}

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

@@ -0,0 +1,58 @@
+/**
+ * Capabilities — 「SwallowKit に何ができるか」の機械可読な自己記述。
+ *
+ * inspect project/boundaries/infra が「今の状態」を返すのに対し、
+ * inspect capabilities は「モデルで宣言できるもの・認証の正しい導入手順・
+ * 生成 CRUD の守備範囲・シード適用方法」など、状態に依存しない
+ * フレームワーク仕様を返す。Coding Agent がドキュメント外の知識を
+ * 推測で埋めるのを構造的に防ぐことが目的。
+ */
+export interface CapabilityModelDeclaration {
+    name: string;
+    required: boolean;
+    description: string;
+    format: string;
+    notes?: string[];
+}
+export interface CapabilityAuthProvider {
+    provider: string;
+    description: string;
+    postApplySteps: string[];
+}
+export interface CapabilitiesContract {
+    contractVersion: number;
+    swallowkitVersion: string;
+    modelDeclarations: CapabilityModelDeclaration[];
+    authentication: {
+        correctWorkflow: string[];
+        rules: string[];
+        providers: CapabilityAuthProvider[];
+        authorizationPolicies: {
+            semantics: string;
+            configExample: string;
+            handEditAllowed: boolean;
+        };
+    };
+    generatedCrud: {
+        guarantees: string[];
+        notGuaranteed: string[];
+        guidance: string[];
+    };
+    sharedModels: {
+        idFieldRule: string;
+        buildNote: string;
+    };
+    seeding: {
+        createTemplates: string;
+        applySeeds: string;
+        notes: string[];
+    };
+    machineCommands: string[];
+    verifyChecks: {
+        defaultChecks: string[];
+        optInChecks: string[];
+        customChecks: string;
+    };
+}
+export declare function inspectCapabilities(): CapabilitiesContract;
+//# sourceMappingURL=capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/project/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;IAChD,cAAc,EAAE;QACd,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,EAAE,sBAAsB,EAAE,CAAC;QACpC,qBAAqB,EAAE;YACrB,SAAS,EAAE,MAAM,CAAC;YAClB,aAAa,EAAE,MAAM,CAAC;YACtB,eAAe,EAAE,OAAO,CAAC;SAC1B,CAAC;KACH,CAAC;IACF,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE;QACZ,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,wBAAgB,mBAAmB,IAAI,oBAAoB,CAkI1D"}

package/dist/core/project/capabilities.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Capabilities — 「SwallowKit に何ができるか」の機械可読な自己記述。
+ *
+ * inspect project/boundaries/infra が「今の状態」を返すのに対し、
+ * inspect capabilities は「モデルで宣言できるもの・認証の正しい導入手順・
+ * 生成 CRUD の守備範囲・シード適用方法」など、状態に依存しない
+ * フレームワーク仕様を返す。Coding Agent がドキュメント外の知識を
+ * 推測で埋めるのを構造的に防ぐことが目的。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectCapabilities = inspectCapabilities;
+const version_1 = require("../../version");
+function inspectCapabilities() {
+    return {
+        contractVersion: 1,
+        swallowkitVersion: (0, version_1.getSwallowKitVersion)(),
+        modelDeclarations: [
+            {
+                name: "schema",
+                required: true,
+                description: "Zod object schema; the schema constant and the inferred type share the same PascalCase name. `id` MUST be a required string — generated CRUD, UI, and repositories assume it is always present. Only `createdAt` / `updatedAt` are optional (backend-managed).",
+                format: "export const Todo = z.object({ id: z.string(), title: z.string().min(1), createdAt: z.string().optional(), updatedAt: z.string().optional() });\nexport type Todo = z.infer<typeof Todo>;",
+            },
+            {
+                name: "displayName",
+                required: false,
+                description: "Human-readable name used by generated UI. Defaults to the model name.",
+                format: "export const displayName = 'Todo';",
+            },
+            {
+                name: "partitionKey",
+                required: false,
+                description: "Cosmos DB partition key path for the generated container. Must start with '/' and reference a field that exists in the schema. Defaults to '/id'.",
+                format: "export const partitionKey = '/learnerId';",
+                notes: ["The referenced field (e.g. learnerId) must be declared in the Zod schema."],
+            },
+            {
+                name: "authPolicy",
+                required: false,
+                description: "Role-based access control metadata applied to the generated CRUD Functions. `roles` guards all operations; `read`/`write` guard per-operation; `policy` references a named authorization policy from swallowkit.config auth.authorization.policies.",
+                format: "export const authPolicy = { roles: ['admin'] };\n// or per-operation:\nexport const authPolicy = { read: ['user'], write: ['admin'] };\n// or a named policy:\nexport const authPolicy = { policy: 'adminOnly' };",
+            },
+            {
+                name: "connectorConfig",
+                required: false,
+                description: "Binds the model to a configured external connector (RDB / API) instead of Cosmos DB. The connector must exist in swallowkit.config connectors.",
+                format: "export const connectorConfig = {\n  connector: 'mysql',\n  table: 'todos',\n  operations: ['list', 'get', 'create', 'update', 'delete'],\n};",
+            },
+        ],
+        authentication: {
+            correctWorkflow: [
+                "1. plan auth --provider <custom-jwt|swa|external-token> [--scheme <name>] [--allowed-providers <csv>] — computes the change plan; SwallowKit writes auth.schemes into swallowkit.config for you.",
+                "2. apply auth --plan <planId> — generates auth code and appends the scheme to swallowkit.config.",
+                "3. Hand-edit swallowkit.config auth.authorization.policies to define named policies (the config is an extension point; this edit is expected).",
+                "4. For swa schemes: set swa.allowedProviders via --allowed-providers at plan time, or hand-edit it in the config after apply.",
+                "5. For external-token schemes: implement the generated verifier stub — it fails closed (throws) until implemented.",
+                "6. Re-run plan/apply scaffold for models that need auth guards, then verify project.",
+            ],
+            rules: [
+                "NEVER hand-write auth.schemes entries in swallowkit.config — plan/apply auth owns them and duplicate names abort with 'already exists'.",
+                "authorization.policies and swa.allowedProviders ARE hand-edited after apply (extension-point edits).",
+                "Verifier stubs pass typecheck and verify; a passing verify does NOT mean external-token auth works end-to-end.",
+            ],
+            providers: [
+                {
+                    provider: "custom-jwt",
+                    description: "Login/logout/me endpoints backed by an RDB user table, bcrypt password check, HS256 JWT.",
+                    postApplySteps: ["Set JWT_SECRET in functions/local.settings.json.", "Ensure the user table matches auth.customJwt config."],
+                },
+                {
+                    provider: "swa",
+                    description: "Azure Static Web Apps built-in auth (EasyAuth). Principal arrives via x-ms-client-principal.",
+                    postApplySteps: [
+                        "Set swa.allowedProviders (e.g. ['github']) via --allowed-providers or by hand-editing the config; generated login URLs use the first entry.",
+                    ],
+                },
+                {
+                    provider: "external-token",
+                    description: "Bearer tokens issued by an external IdP (LINE, Auth0, ...). SwallowKit generates a fail-closed verifier stub.",
+                    postApplySteps: [
+                        "Implement the generated verifier (extension point / generated-once; edit freely).",
+                        "Implement the frontend token adapter (lib/auth/**/token-adapter.ts).",
+                    ],
+                },
+                {
+                    provider: "none",
+                    description: "Disables authentication in the config.",
+                    postApplySteps: [],
+                },
+            ],
+            authorizationPolicies: {
+                semantics: "A named policy lists which schemes may satisfy it and which roles are required. Generated guards call requireAuth(request, policyName). Exactly one scheme must match the presented credentials.",
+                configExample: "auth: {\n  schemes: { admin: { provider: 'swa', swa: { allowedProviders: ['github'] } }, api: { provider: 'external-token' } },\n  authorization: {\n    defaultPolicy: 'anonymous',\n    policies: {\n      adminOnly: { schemes: ['admin'], roles: ['administrator'] },\n      learner: { schemes: ['api'] },\n    },\n  },\n}",
+                handEditAllowed: true,
+            },
+        },
+        generatedCrud: {
+            guarantees: [
+                "Generated CRUD endpoints enforce the model's authPolicy (authentication + role checks).",
+                "Zod validation runs before persistence.",
+            ],
+            notGuaranteed: [
+                "Owner scoping: generated CRUD does NOT restrict rows to the authenticated principal. Any authenticated caller passing the policy can read/write any document.",
+            ],
+            guidance: [
+                "For multi-user data where users may only touch their own records, add ai-authored custom endpoints that derive the scoping key (e.g. learnerId) from the verified principal — never from the request body — and restrict generated write endpoints to admin roles or disable them.",
+            ],
+        },
+        sharedModels: {
+            idFieldRule: "id: z.string() (required). createdAt/updatedAt: z.string().optional(). The backend owns their values.",
+            buildNote: "verify typecheck resolves the shared package from its built dist/. SwallowKit rebuilds shared automatically during verify; when typechecking manually, build the shared package first (errors like \"no exported member\" usually mean a stale dist).",
+        },
+        seeding: {
+            createTemplates: "swallowkit create-dev-seeds <environment> — writes dev-seeds/<environment>/<model>.json templates.",
+            applySeeds: "swallowkit dev --seed-env <environment> — applies the seed JSON to the local Cosmos DB emulator at dev startup.",
+            notes: ["Editing dev-seeds/*.json alone does nothing; seeds are only applied via dev --seed-env."],
+        },
+        machineCommands: [
+            "inspect project | entities | routes | artifacts | boundaries | infra | drift | capabilities",
+            "validate project",
+            "generate model <names...> | generate scaffold <model>",
+            "plan scaffold <models...> | plan auth --provider <p> [--scheme <name>] [--allowed-providers <csv>] | plan provision -g <rg> --location <loc> --swa-location <loc>",
+            "apply scaffold [models...] --plan <id> [--approve] | apply auth --plan <id> [--approve] | apply provision --plan <id> --approve",
+            "verify project [--checks <ids>] [--compact]",
+            "explain failure [--check <id>]",
+        ],
+        verifyChecks: {
+            defaultChecks: ["structure", "drift", "typecheck"],
+            optInChecks: ["build", "lint", "test"],
+            customChecks: "swallowkit.config verify.checks: [{ id, command, title?, timeoutMs? }]",
+        },
+    };
+}
+//# sourceMappingURL=capabilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/core/project/capabilities.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAsDH,kDAkIC;AAtLD,2CAAqD;AAoDrD,SAAgB,mBAAmB;IACjC,OAAO;QACL,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,IAAA,8BAAoB,GAAE;QACzC,iBAAiB,EAAE;YACjB;gBACE,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EACT,gQAAgQ;gBAClQ,MAAM,EACJ,2LAA2L;aAC9L;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,uEAAuE;gBACpF,MAAM,EAAE,oCAAoC;aAC7C;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,KAAK;gBACf,WAAW,EACT,mJAAmJ;gBACrJ,MAAM,EAAE,2CAA2C;gBACnD,KAAK,EAAE,CAAC,2EAA2E,CAAC;aACrF;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,KAAK;gBACf,WAAW,EACT,qPAAqP;gBACvP,MAAM,EACJ,mNAAmN;aACtN;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,QAAQ,EAAE,KAAK;gBACf,WAAW,EACT,gJAAgJ;gBAClJ,MAAM,EACJ,8IAA8I;aACjJ;SACF;QACD,cAAc,EAAE;YACd,eAAe,EAAE;gBACf,kMAAkM;gBAClM,kGAAkG;gBAClG,gJAAgJ;gBAChJ,+HAA+H;gBAC/H,oHAAoH;gBACpH,sFAAsF;aACvF;YACD,KAAK,EAAE;gBACL,yIAAyI;gBACzI,sGAAsG;gBACtG,gHAAgH;aACjH;YACD,SAAS,EAAE;gBACT;oBACE,QAAQ,EAAE,YAAY;oBACtB,WAAW,EAAE,0FAA0F;oBACvG,cAAc,EAAE,CAAC,kDAAkD,EAAE,sDAAsD,CAAC;iBAC7H;gBACD;oBACE,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,8FAA8F;oBAC3G,cAAc,EAAE;wBACd,6IAA6I;qBAC9I;iBACF;gBACD;oBACE,QAAQ,EAAE,gBAAgB;oBAC1B,WAAW,EAAE,+GAA+G;oBAC5H,cAAc,EAAE;wBACd,mFAAmF;wBACnF,sEAAsE;qBACvE;iBACF;gBACD;oBACE,QAAQ,EAAE,MAAM;oBAChB,WAAW,EAAE,wCAAwC;oBACrD,cAAc,EAAE,EAAE;iBACnB;aACF;YACD,qBAAqB,EAAE;gBACrB,SAAS,EACP,kMAAkM;gBACpM,aAAa,EACX,kUAAkU;gBACpU,eAAe,EAAE,IAAI;aACtB;SACF;QACD,aAAa,EAAE;YACb,UAAU,EAAE;gBACV,yFAAyF;gBACzF,yCAAyC;aAC1C;YACD,aAAa,EAAE;gBACb,+JAA+J;aAChK;YACD,QAAQ,EAAE;gBACR,oRAAoR;aACrR;SACF;QACD,YAAY,EAAE;YACZ,WAAW,EAAE,uGAAuG;YACpH,SAAS,EACP,uPAAuP;SAC1P;QACD,OAAO,EAAE;YACP,eAAe,EAAE,oGAAoG;YACrH,UAAU,EAAE,iHAAiH;YAC7H,KAAK,EAAE,CAAC,yFAAyF,CAAC;SACnG;QACD,eAAe,EAAE;YACf,6FAA6F;YAC7F,kBAAkB;YAClB,uDAAuD;YACvD,mKAAmK;YACnK,iIAAiI;YACjI,6CAA6C;YAC7C,gCAAgC;SACjC;QACD,YAAY,EAAE;YACZ,aAAa,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC;YAClD,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;YACtC,YAAY,EAAE,wEAAwE;SACvF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Drift Detection — 生成物と現在のプロジェクト状態の乖離を検出する。
+ *
+ * 検出対象:
+ * - schema-drift:       スキーマ変更後に生成物が再生成されていない
+ * - generator-drift:    Generator (SwallowKit) のバージョンが生成時から変わっている
+ * - artifact-modified:  生成後にファイルが手動変更されている(再生成で失われる可能性)
+ * - artifact-missing:   台帳に記録された生成物が存在しない
+ * - manifest-drift:     Manifest と実際のプロジェクト構造が一致していない
+ */
+export type DriftKind = "schema-drift" | "generator-drift" | "artifact-modified" | "artifact-missing" | "manifest-drift";
+export type DriftSeverity = "error" | "warning" | "info";
+export interface DriftFinding {
+    kind: DriftKind;
+    severity: DriftSeverity;
+    message: string;
+    path?: string;
+    entity?: string;
+    expected?: string;
+    actual?: string;
+    repairAction: string;
+}
+export interface DriftDetectionResult {
+    ledgerFound: boolean;
+    findings: DriftFinding[];
+    checkedArtifacts: number;
+}
+export declare function detectDrift(projectRoot?: string): Promise<DriftDetectionResult>;
+//# sourceMappingURL=drift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../../src/core/project/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAsID,wBAAsB,WAAW,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0BpG"}