@yohakuforce/core 0.4.0

package/dist/change-summary/schema.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yohakuforce.dev/schemas/change-summary.schema.json",
+  "title": "yohakuforce Change Summary",
+  "description": "Phase 3 差分意味づけの正本スキーマ。各値フィールドは source 列付き Tracked<T> を必須とする。",
+  "type": "object",
+  "required": ["id", "createdAt", "fromRef", "toRef", "staticAnalysisFindings", "categories", "humanAnnotations"],
+  "properties": {
+    "id": { "$ref": "#/$defs/TrackedString" },
+    "createdAt": { "$ref": "#/$defs/TrackedString" },
+    "fromRef": { "$ref": "#/$defs/TrackedString" },
+    "toRef": { "$ref": "#/$defs/TrackedString" },
+    "staticAnalysisFindings": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/SarifFinding" }
+        },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "categories": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/CategorySection" }
+    },
+    "humanAnnotations": { "$ref": "#/$defs/HumanAnnotations" }
+  },
+  "$defs": {
+    "Source": { "type": "string", "enum": ["deterministic", "ai", "human"] },
+    "TrackedString": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": { "type": "string" },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "TrackedBoolean": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": { "type": "boolean" },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "TrackedStringArray": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": { "type": "array", "items": { "type": "string" } },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "TrackedChangeKind": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": { "type": "string", "enum": ["added", "modified", "removed", "renamed"] },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "TrackedScopeSize": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": { "type": "string", "enum": ["small", "medium", "large"] },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "TrackedCategoryKind": {
+      "type": "object",
+      "required": ["value", "source"],
+      "properties": {
+        "value": {
+          "type": "string",
+          "enum": ["data_model", "automation", "permission", "ui", "logic", "operational", "manual"]
+        },
+        "source": { "$ref": "#/$defs/Source" },
+        "promptHash": { "type": "string" },
+        "model": { "type": "string" },
+        "temperature": { "type": "number" }
+      }
+    },
+    "SarifFinding": {
+      "type": "object",
+      "required": ["ruleId", "level", "message", "locations"],
+      "properties": {
+        "ruleId": { "type": "string" },
+        "level": { "type": "string", "enum": ["none", "note", "warning", "error"] },
+        "message": { "type": "string" },
+        "locations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "ChangeEntry": {
+      "type": "object",
+      "required": [
+        "entity",
+        "changeKind",
+        "scopeSize",
+        "affectedEntities",
+        "reviewPoints",
+        "manualStepsRequired",
+        "businessImpactHint"
+      ],
+      "properties": {
+        "entity": { "$ref": "#/$defs/TrackedString" },
+        "changeKind": { "$ref": "#/$defs/TrackedChangeKind" },
+        "scopeSize": { "$ref": "#/$defs/TrackedScopeSize" },
+        "affectedEntities": { "$ref": "#/$defs/TrackedStringArray" },
+        "reviewPoints": { "$ref": "#/$defs/TrackedStringArray" },
+        "manualStepsRequired": { "$ref": "#/$defs/TrackedBoolean" },
+        "businessImpactHint": { "$ref": "#/$defs/TrackedString" }
+      }
+    },
+    "CategorySection": {
+      "type": "object",
+      "required": ["type", "changes"],
+      "properties": {
+        "type": { "$ref": "#/$defs/TrackedCategoryKind" },
+        "changes": { "type": "array", "items": { "$ref": "#/$defs/ChangeEntry" } }
+      }
+    },
+    "HumanAnnotations": {
+      "type": "object",
+      "required": ["businessContext", "customerCommunicationNeeded"],
+      "properties": {
+        "businessContext": { "$ref": "#/$defs/TrackedString" },
+        "customerCommunicationNeeded": { "$ref": "#/$defs/TrackedBoolean" }
+      }
+    }
+  }
+}

package/dist/change-summary/types.d.ts

@@ -0,0 +1,52 @@
+export type Source = "deterministic" | "ai" | "human";
+/** AI / 人手 / 決定的処理 のどれが値を生んだかを必ず明示する wrapper */
+export interface Tracked<T> {
+    readonly value: T;
+    readonly source: Source;
+    readonly promptHash?: string;
+    readonly model?: string;
+    readonly temperature?: number;
+}
+export declare function deterministic<T>(value: T): Tracked<T>;
+export declare function ai<T>(value: T, meta: {
+    readonly promptHash: string;
+    readonly model: string;
+    readonly temperature: number;
+}): Tracked<T>;
+export declare function human<T>(value: T): Tracked<T>;
+export type ChangeCategoryKind = "data_model" | "automation" | "permission" | "ui" | "logic" | "operational" | "manual";
+export type ChangeKind = "added" | "modified" | "removed" | "renamed";
+export type ScopeSize = "small" | "medium" | "large";
+export interface SarifFinding {
+    readonly ruleId: string;
+    readonly level: "none" | "note" | "warning" | "error";
+    readonly message: string;
+    readonly locations: readonly string[];
+}
+export interface ChangeEntry {
+    readonly entity: Tracked<string>;
+    readonly changeKind: Tracked<ChangeKind>;
+    readonly scopeSize: Tracked<ScopeSize>;
+    readonly affectedEntities: Tracked<readonly string[]>;
+    readonly reviewPoints: Tracked<readonly string[]>;
+    readonly manualStepsRequired: Tracked<boolean>;
+    readonly businessImpactHint: Tracked<string>;
+}
+export interface CategorySection {
+    readonly type: Tracked<ChangeCategoryKind>;
+    readonly changes: readonly ChangeEntry[];
+}
+export interface HumanAnnotations {
+    readonly businessContext: Tracked<string>;
+    readonly customerCommunicationNeeded: Tracked<boolean>;
+}
+export interface ChangeSummary {
+    readonly id: Tracked<string>;
+    readonly createdAt: Tracked<string>;
+    readonly fromRef: Tracked<string>;
+    readonly toRef: Tracked<string>;
+    readonly staticAnalysisFindings: Tracked<readonly SarifFinding[]>;
+    readonly categories: readonly CategorySection[];
+    readonly humanAnnotations: HumanAnnotations;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/change-summary/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/change-summary/types.ts"],"names":[],"mappings":"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"}

package/dist/change-summary/types.js

@@ -0,0 +1,18 @@
+// 再現性ガバナンス層 2: source 列必須化
+// 詳細 ADR: .agents/knowledge/decisions/2026-05-07-source-column-three-layer-boundary.md
+export function deterministic(value) {
+    return { value, source: "deterministic" };
+}
+export function ai(value, meta) {
+    return {
+        value,
+        source: "ai",
+        promptHash: meta.promptHash,
+        model: meta.model,
+        temperature: meta.temperature,
+    };
+}
+export function human(value) {
+    return { value, source: "human" };
+}
+//# sourceMappingURL=types.js.map

package/dist/change-summary/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/change-summary/types.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,uFAAuF;AAavF,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,EAAE,CAChB,KAAQ,EACR,IAA2F;IAE3F,OAAO;QACL,KAAK;QACL,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAI,KAAQ;IAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/change-summary/validate.d.ts

@@ -0,0 +1,8 @@
+import { type ErrorObject } from "ajv/dist/2020.js";
+export declare class ChangeSummaryValidationError extends Error {
+    readonly errors: readonly ErrorObject[];
+    constructor(errors: readonly ErrorObject[]);
+}
+export declare function validateChangeSummary(data: unknown): void;
+export declare function loadChangeSummarySchema(): Record<string, unknown>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/change-summary/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/change-summary/validate.ts"],"names":[],"mappings":"AAIA,OAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgB7D,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;gBAC5B,MAAM,EAAE,SAAS,WAAW,EAAE;CAK3C;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAKzD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE"}

package/dist/change-summary/validate.js

@@ -0,0 +1,35 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import addFormats from "ajv-formats";
+import Ajv2020, {} from "ajv/dist/2020.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const SCHEMA_PATH = resolve(here, "schema.json");
+let cachedValidator;
+function loadValidator() {
+    if (cachedValidator !== undefined)
+        return cachedValidator;
+    const schema = JSON.parse(readFileSync(SCHEMA_PATH, "utf8"));
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    addFormats(ajv);
+    cachedValidator = ajv.compile(schema);
+    return cachedValidator;
+}
+export class ChangeSummaryValidationError extends Error {
+    errors;
+    constructor(errors) {
+        super(`Change summary failed schema validation: ${errors.length} error(s)`);
+        this.name = "ChangeSummaryValidationError";
+        this.errors = errors;
+    }
+}
+export function validateChangeSummary(data) {
+    const validator = loadValidator();
+    if (!validator(data)) {
+        throw new ChangeSummaryValidationError(validator.errors ?? []);
+    }
+}
+export function loadChangeSummarySchema() {
+    return JSON.parse(readFileSync(SCHEMA_PATH, "utf8"));
+}
+//# sourceMappingURL=validate.js.map

package/dist/change-summary/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/change-summary/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,OAAO,EAAE,EAAoB,MAAM,kBAAkB,CAAC;AAE7D,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAEjD,IAAI,eAA2D,CAAC;AAEhE,SAAS,aAAa;IACpB,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAA4B,CAAC;IACxF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,MAAM,CAAyB;IACxC,YAAY,MAA8B;QACxC,KAAK,CAAC,4CAA4C,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,4BAA4B,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAA4B,CAAC;AAClF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAkgCA,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnE"}