@tienne/gestalt 0.77.1 → 0.78.0

package/dist/schemas/gestalt.schema.json

@@ -110,6 +110,27 @@
       "description": "Directory containing agent definitions (env: GESTALT_AGENTS_DIR)",
       "default": "agents"
     },
+    "ruleSources": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/ruleSource" },
+      "maxItems": 32,
+      "description": "Rule sources outside this repo that skills must read before producing work — declared per repo so Gestalt itself stays organization-agnostic. Only declared sources are read; Gestalt never scans attached MCP servers to pick one",
+      "default": []
+    },
+    "ruleSourceErrors": {
+      "type": "array",
+      "items": { "type": "string" },
+      "readOnly": true,
+      "description": "Filled by Gestalt, not by the author. Non-empty means a ruleSources declaration could not be parsed — skills stop. Do not read an empty ruleSources array as 'nothing declared' without checking this",
+      "default": []
+    },
+    "ruleSourceWarnings": {
+      "type": "array",
+      "items": { "type": "string" },
+      "readOnly": true,
+      "description": "Filled by Gestalt, not by the author. Things worth pointing out that are not a reason to stop, such as a top-level key that looks like a misspelled 'ruleSources'. Kept apart from ruleSourceErrors so widening a detector can never halt a session",
+      "default": []
+    },
     "notifications": {
       "type": "boolean",
       "description": "Enable OS desktop notifications for pipeline events (env: GESTALT_NOTIFICATIONS)",
@@ -154,6 +175,50 @@
       },
       "required": ["provider", "model"],
       "additionalProperties": false
+    },
+    "ruleSource": {
+      "type": "object",
+      "description": "A standard neither Gestalt nor the target repo owns — design tokens, org conventions, product principles. See plugin/skills/_shared/rule-sources.md",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64,
+          "description": "Name used in reporting. Must be unique within this config. Shown to the user as-is, so anything that opens a new line or table cell is rejected — control characters, line/paragraph separators, backticks and pipes, including forms that normalize into them. Leading and trailing whitespace is rejected too. Non-ASCII names such as Korean are fine"
+        },
+        "kind": {
+          "type": "string",
+          "enum": ["mcp", "file", "skill"],
+          "description": "Where the rule lives — an MCP tool, a file path, or another skill that owns the task"
+        },
+        "ref": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "description": "Target for the given kind — MCP tool name (mcp__plate__get_design_tokens), repo-relative file path, or skill name (review, gestalt:review). No character that could make the checked value differ from the value actually opened: whitespace, invisible characters, forms that normalize into something else, and separator lookalikes. The stored ref is normalized to NFC so it matches what was checked. A file ref must stay inside the repo: absolute paths, .., and credential files are rejected. Over the length limit the source is rejected rather than truncated, so a source is never silently unreadable. The full list lives in plugin/skills/_shared/rule-sources.md"
+        },
+        "scope": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1, "maxLength": 32 },
+          "maxItems": 16,
+          "description": "Read this source only for tasks tagged with one of these. Tags come from the files the task touches (ui, css, api, db, docs, test), not from the request wording. Empty means always read",
+          "default": []
+        },
+        "trust": {
+          "type": "string",
+          "enum": ["convention", "delegate"],
+          "description": "'convention' follows the format it defines (token names, naming, required fields). 'delegate' hands the task to it instead and requires kind: skill. Neither lets the source widen the scope of work",
+          "default": "convention"
+        },
+        "onMissing": {
+          "type": "string",
+          "enum": ["skip", "warn", "stop"],
+          "description": "When the source cannot be read. 'skip' proceeds silently, 'warn' proceeds and records the gap in the completion report, 'stop' halts and explains what would unblock it",
+          "default": "warn"
+        }
+      },
+      "required": ["id", "kind", "ref"],
+      "additionalProperties": false
     }
   }
 }

package/dist/src/core/config.d.ts

@@ -16,6 +16,63 @@ declare const llmTierConfigSchema: z.ZodObject<{
     baseURL?: string | undefined;
 }>;
 export type LLMTierConfig = z.infer<typeof llmTierConfigSchema>;
+/**
+ * 레포 밖에 있는 규칙 소스. 게슈탈트도 대상 레포도 소유하지 않은 기준을 가리킨다.
+ *
+ * 선언된 것만 읽는다 — 붙어 있는 MCP를 훑어 고르면 무엇을 근거로 삼았는지 사라진다.
+ * 적용 규칙은 `plugin/skills/_shared/rule-sources.md`가 원본이다.
+ */
+declare const ruleSourceSchema: z.ZodEffects<z.ZodObject<{
+    /** 보고에 쓰는 이름. 레포 안에서 고유해야 한다. ref 와 같이 NFC 로 맞춰 둔다 */
+    id: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>;
+    kind: z.ZodEnum<["mcp", "file", "skill"]>;
+    /**
+     * kind별 대상 — mcp면 도구 이름, file이면 경로, skill이면 스킬 이름.
+     *
+     * 상한이 있는 건 이 값이 ges_status 응답으로 매번 실려 나가서다. 넘으면 자르지
+     * 않고 거부한다 — 자른 ref 는 스킬이 가진 유일한 ref 라, 읽기에 실패한 뒤
+     * onMissing 을 타고 조용히 지나간다. 거부하면 ruleSourceErrors 로 드러난다.
+     *
+     * NFC 로 맞춰 둔다. 검사만 정규화하고 원본을 저장하면 검사한 값과 스킬이 받는 값이
+     * 또 갈라진다 — 그 틈을 없애려고 고친 자리라 여기서 되풀이하지 않는다
+     */
+    ref: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>;
+    /** 이 태그가 걸린 작업에서만 읽는다. 비면 항상 읽는다 */
+    scope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** convention=형식을 따른다, delegate=그 작업을 넘긴다 */
+    trust: z.ZodDefault<z.ZodEnum<["convention", "delegate"]>>;
+    /** 못 읽었을 때. warn 이상은 결과에 남는다 */
+    onMissing: z.ZodDefault<z.ZodEnum<["skip", "warn", "stop"]>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    kind: "mcp" | "file" | "skill";
+    ref: string;
+    scope: string[];
+    trust: "convention" | "delegate";
+    onMissing: "skip" | "warn" | "stop";
+}, {
+    id: string;
+    kind: "mcp" | "file" | "skill";
+    ref: string;
+    scope?: string[] | undefined;
+    trust?: "convention" | "delegate" | undefined;
+    onMissing?: "skip" | "warn" | "stop" | undefined;
+}>, {
+    id: string;
+    kind: "mcp" | "file" | "skill";
+    ref: string;
+    scope: string[];
+    trust: "convention" | "delegate";
+    onMissing: "skip" | "warn" | "stop";
+}, {
+    id: string;
+    kind: "mcp" | "file" | "skill";
+    ref: string;
+    scope?: string[] | undefined;
+    trust?: "convention" | "delegate" | undefined;
+    onMissing?: "skip" | "warn" | "stop" | undefined;
+}>;
+export type RuleSource = z.infer<typeof ruleSourceSchema>;
 declare const configSchema: z.ZodObject<{
     llm: z.ZodDefault<z.ZodObject<{
         apiKey: z.ZodDefault<z.ZodString>;
@@ -149,6 +206,83 @@ declare const configSchema: z.ZodObject<{
         standard?: "haiku" | "sonnet" | "opus" | "fable" | undefined;
         frontier?: "haiku" | "sonnet" | "opus" | "fable" | undefined;
     }>>;
+    ruleSources: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        /** 보고에 쓰는 이름. 레포 안에서 고유해야 한다. ref 와 같이 NFC 로 맞춰 둔다 */
+        id: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>;
+        kind: z.ZodEnum<["mcp", "file", "skill"]>;
+        /**
+         * kind별 대상 — mcp면 도구 이름, file이면 경로, skill이면 스킬 이름.
+         *
+         * 상한이 있는 건 이 값이 ges_status 응답으로 매번 실려 나가서다. 넘으면 자르지
+         * 않고 거부한다 — 자른 ref 는 스킬이 가진 유일한 ref 라, 읽기에 실패한 뒤
+         * onMissing 을 타고 조용히 지나간다. 거부하면 ruleSourceErrors 로 드러난다.
+         *
+         * NFC 로 맞춰 둔다. 검사만 정규화하고 원본을 저장하면 검사한 값과 스킬이 받는 값이
+         * 또 갈라진다 — 그 틈을 없애려고 고친 자리라 여기서 되풀이하지 않는다
+         */
+        ref: z.ZodPipeline<z.ZodEffects<z.ZodString, string, string>, z.ZodString>;
+        /** 이 태그가 걸린 작업에서만 읽는다. 비면 항상 읽는다 */
+        scope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** convention=형식을 따른다, delegate=그 작업을 넘긴다 */
+        trust: z.ZodDefault<z.ZodEnum<["convention", "delegate"]>>;
+        /** 못 읽었을 때. warn 이상은 결과에 남는다 */
+        onMissing: z.ZodDefault<z.ZodEnum<["skip", "warn", "stop"]>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope: string[];
+        trust: "convention" | "delegate";
+        onMissing: "skip" | "warn" | "stop";
+    }, {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope?: string[] | undefined;
+        trust?: "convention" | "delegate" | undefined;
+        onMissing?: "skip" | "warn" | "stop" | undefined;
+    }>, {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope: string[];
+        trust: "convention" | "delegate";
+        onMissing: "skip" | "warn" | "stop";
+    }, {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope?: string[] | undefined;
+        trust?: "convention" | "delegate" | undefined;
+        onMissing?: "skip" | "warn" | "stop" | undefined;
+    }>, "many">, {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope: string[];
+        trust: "convention" | "delegate";
+        onMissing: "skip" | "warn" | "stop";
+    }[], {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope?: string[] | undefined;
+        trust?: "convention" | "delegate" | undefined;
+        onMissing?: "skip" | "warn" | "stop" | undefined;
+    }[]>>;
+    /**
+     * ruleSources 선언이 깨졌을 때 그 이유. 사용자가 쓰는 필드가 아니라 loadConfig가 채운다.
+     * 비어 있지 않으면 선언은 있었는데 못 읽은 상태이므로 스킬은 진행하지 않는다.
+     */
+    ruleSourceErrors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 선언이 깨지진 않았는데 짚어줄 게 있을 때. 마찬가지로 loadConfig가 채운다.
+     *
+     * **멈춤 사유와 한 필드에 담지 않는다.** 담으면 탐지기를 한 번 넓힐 때마다 그게
+     * 세션을 세우는 레버가 된다 — 실제로 키 이름 오타 탐지를 넓혔더니 `resources` 같은
+     * 남의 키 하나로 이 값을 읽는 자리가 전부 멈췄다. 확실하지 않은 판정은 여기로 온다.
+     */
+    ruleSourceWarnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     notifications: z.ZodDefault<z.ZodBoolean>;
     dbPath: z.ZodDefault<z.ZodString>;
     skillsDir: z.ZodDefault<z.ZodString>;
@@ -197,6 +331,16 @@ declare const configSchema: z.ZodObject<{
         standard: "haiku" | "sonnet" | "opus" | "fable";
         frontier: "haiku" | "sonnet" | "opus" | "fable";
     };
+    ruleSources: {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope: string[];
+        trust: "convention" | "delegate";
+        onMissing: "skip" | "warn" | "stop";
+    }[];
+    ruleSourceErrors: string[];
+    ruleSourceWarnings: string[];
     notifications: boolean;
     dbPath: string;
     skillsDir: string;
@@ -204,7 +348,7 @@ declare const configSchema: z.ZodObject<{
     roleAgentsDir: string;
     reviewAgentsDir: string;
     personasDir: string;
-    logLevel: "debug" | "info" | "warn" | "error";
+    logLevel: "warn" | "debug" | "info" | "error";
     client: "claude-code" | "codex" | "both" | "grok";
 }, {
     interview?: {
@@ -245,6 +389,16 @@ declare const configSchema: z.ZodObject<{
         standard?: "haiku" | "sonnet" | "opus" | "fable" | undefined;
         frontier?: "haiku" | "sonnet" | "opus" | "fable" | undefined;
     } | undefined;
+    ruleSources?: {
+        id: string;
+        kind: "mcp" | "file" | "skill";
+        ref: string;
+        scope?: string[] | undefined;
+        trust?: "convention" | "delegate" | undefined;
+        onMissing?: "skip" | "warn" | "stop" | undefined;
+    }[] | undefined;
+    ruleSourceErrors?: string[] | undefined;
+    ruleSourceWarnings?: string[] | undefined;
     notifications?: boolean | undefined;
     dbPath?: string | undefined;
     skillsDir?: string | undefined;
@@ -252,7 +406,7 @@ declare const configSchema: z.ZodObject<{
     roleAgentsDir?: string | undefined;
     reviewAgentsDir?: string | undefined;
     personasDir?: string | undefined;
-    logLevel?: "debug" | "info" | "warn" | "error" | undefined;
+    logLevel?: "warn" | "debug" | "info" | "error" | undefined;
     client?: "claude-code" | "codex" | "both" | "grok" | undefined;
 }>;
 export type GestaltConfig = z.infer<typeof configSchema>;

package/dist/src/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;EAKvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAgChE,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBhB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAmBzD;;;GAGG;AACH,iBAAS,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,CAAC,CAmBH;AAED;;GAEG;AACH,iBAAS,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAclD;AASD;;;GAGG;AACH,iBAAS,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiFjD;AAoDD,wBAAgB,UAAU,CACxB,SAAS,GAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,EAChD,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5D,aAAa,CAoCf;AAYD,OAAO,EACL,SAAS,IAAI,UAAU,EACvB,eAAe,IAAI,gBAAgB,EACnC,cAAc,IAAI,eAAe,GAClC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;EAKvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAkKhE;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB;IAElB,sDAAsD;;;IAOtD;;;;;;;;;OASG;;IAOH,oCAAoC;;IAEpC,6CAA6C;;IAE7C,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4GhC,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAS1D,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAlJd,sDAAsD;;;QAOtD;;;;;;;;;WASG;;QAOH,oCAAoC;;QAEpC,6CAA6C;;QAE7C,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyIlC;;;OAGG;;IAEH;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAmBzD;;;GAGG;AACH,iBAAS,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,CAAC,CAmBH;AAED;;GAEG;AACH,iBAAS,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAclD;AASD;;;GAGG;AACH,iBAAS,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiFjD;AA2GD,wBAAgB,UAAU,CACxB,SAAS,GAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,EAChD,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5D,aAAa,CAsDf;AAuHD,OAAO,EACL,SAAS,IAAI,UAAU,EACvB,eAAe,IAAI,gBAAgB,EACnC,cAAc,IAAI,eAAe,GAClC,CAAC"}