@flextudio/scenario 0.1.0

package/contract-data/runtime/v1/intent-system/kinds/updateActive.mjs

@@ -0,0 +1,74 @@
+// kinds/updateActive.mjs — 가드 2단 + 직접 대입 N + 옵션 reload (scripts.md §A)
+
+import {
+  CATEGORY_NAME_RE,
+  FID_RE,
+  jsString,
+  jsValue,
+  validateKey,
+} from "./_base.mjs";
+
+export const meta = Object.freeze({
+  name: "updateActive",
+  allowedScopes: null,
+  summary: "활성 섹터의 N개 필드 일괄 갱신 — 가드 2단 + 직접 대입 + 옵션 reload",
+});
+
+export default function expand(props, scopePath) {
+  const errors = [];
+  const { cat, set, reload } = props;
+  if (!CATEGORY_NAME_RE.test(cat || "")) {
+    errors.push({
+      kind: "intent",
+      phase: "updateActive-cat-format",
+      path: `${scopePath}.cat`,
+      message: `intent.script(updateActive).cat 형식 위반 — 'Ctg' 접두 + PascalCase.`,
+    });
+  }
+  if (!set || typeof set !== "object" || Array.isArray(set)) {
+    errors.push({
+      kind: "intent",
+      phase: "updateActive-set-shape",
+      path: `${scopePath}.set`,
+      message: `intent.script(updateActive).set 은 { key: value, ... } 객체 필수.`,
+    });
+  } else if (Object.keys(set).length === 0) {
+    errors.push({
+      kind: "intent",
+      phase: "updateActive-set-empty",
+      path: `${scopePath}.set`,
+      message: `intent.script(updateActive).set 은 1개 이상의 키 필수.`,
+    });
+  }
+  if (reload != null && !FID_RE.test(reload)) {
+    errors.push({
+      kind: "intent",
+      phase: "updateActive-reload-format",
+      path: `${scopePath}.reload`,
+      message: `intent.script(updateActive).reload 는 'f_N' 형태 (옵션).`,
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  // set 의 키 형식 / 예약어 검사 — _base 의 통일 헬퍼.
+  for (const k of Object.keys(set)) {
+    validateKey(k, {
+      path: `${scopePath}.set.${k}`,
+      errors,
+      kindLabel: "intent.script(updateActive).set",
+      kindPhasePrefix: "updateActive-set-key",  // → updateActive-set-key-format / -reserved
+    });
+  }
+  if (errors.length > 0) return { script: "", errors };
+
+  const lines = [
+    `if (!_c.${cat}) return;`,
+    `const cur = _c.${cat}.activeSector;`,
+    `if (!cur) return;`,
+  ];
+  for (const [k, v] of Object.entries(set)) {
+    lines.push(`cur.${k} = ${jsValue(v)};`);
+  }
+  if (reload) lines.push(`f.Content(${jsString(reload)}).reload();`);
+  return { script: lines.join("\n"), errors: [] };
+}

package/contract-data/runtime/v1/intent-system/materialize.mjs

@@ -0,0 +1,495 @@
+// intent-system/materialize.mjs
+// ─────────────────────────────────────────────────────────────────────────────
+// `intent` 키 expander — 런타임 영역 (컬렉션/섹터/카테고리/스크립트) 의
+// short-form 진입점을 raw 메타/Script 본문으로 펼친다.
+//
+// 책임 분리:
+//   - 슬롯 walker (mock/script/categories) + scope 추론 + 슬롯 디스패치 → 본 파일
+//   - script kind 펼침 함수 → kinds/<kind>.mjs (registry 로 자동 로드)
+//   - 공통 헬퍼 (jsString / 예약어 / 패턴) → kinds/_base.mjs
+//   - mock / categories 슬롯 펼침 함수 → 본 파일 (단일 펼침이라 분리 안 함)
+//
+// 진실원본:
+//   - 슬롯 카탈로그: INTENT.md
+//   - schema: intent.schema.json
+//   - 예약어 enum: schema/v1/naming-objects.schema.json (kinds/_base.mjs 가 import)
+//
+// 위치 — design-system 과의 차이:
+//   - design-system 은 schema/v1/design-system/ 에서 컨트롤 노드 단위로 동작.
+//   - intent-system 은 runtime/v1/intent-system/ 에서 시나리오 전역 walker.
+//     호스트가 Action / Step.Events / scenario root 등 여러 위치라 컨트롤
+//     walker (_base.materialize.mjs) 와 분리. validate entry 가 두 단계를
+//     순차 호출.
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+import {
+  CATEGORY_NAME_RE,
+  jsString,
+  validateKey,
+} from "./kinds/_base.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const KINDS_DIR = join(__dirname, "kinds");
+
+const INTENT_KEY = "intent";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Scope 시스템
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * 스크립트 / 호스트 종류별 스코프 enum.
+ * INTENT.md "Scope 카탈로그" 표와 정렬.
+ */
+export const SCOPES = Object.freeze({
+  SCENARIO_ROOT: "scenario-root",
+  EVENT_SCRIPT_INIT: "event-script-init",
+  EVENT_SCRIPT: "event-script",
+  LOAD_SCRIPT: "load-script",       // 트리 노드 아님 — 미래 확장 placeholder
+  FILTER_SCRIPT: "filter-script",   // 미래 확장 placeholder
+  GROUP: "group",
+  CONTROL: "control",
+});
+
+/** initHandlers 미전달 시 기본 — 빈 Set (절대 변형 금지). */
+const _NO_INIT_HANDLERS = new Set();
+
+/**
+ * 노드 + path 로부터 호스트 scope 를 추론.
+ *
+ * 1) path 기반: `.Events.<name>[N]` 매치 → event-script-init / event-script
+ *    - 인라인 `$.Steps.<id>.Events.Init[N]` → event-script-init
+ *    - 어떤 Step 의 Events.Init 이 문자열로 참조하는 named 핸들러
+ *      (`$.Events.<name>[N]`, name ∈ initHandlers) → event-script-init
+ *      (그래야 named 핸들러 안의 intent.mock 이 펼쳐진다 — intent.mock 은
+ *       event-script-init 전용. 인라인 배열 Init 은 schema Init:string 와
+ *       충돌하므로 named 핸들러가 schema-valid 한 정상 배치.)
+ *    - 그 외 Events 핸들러 → event-script
+ * 2) node 기반 fallback: `ContentsType:'Group'` → group, `ControlType:'X'` → control:X
+ * 3) path === '$' → scenario-root
+ * 4) 그 외 → unknown
+ *
+ * @param {Set<string>} initHandlers Step.Events.Init 이 참조하는 named 핸들러 이름 집합
+ *   (applyIntentToScenario 가 수집해 전달; 미전달 시 인라인 Init 만 init scope).
+ */
+export function inferScope(node, path, initHandlers = _NO_INIT_HANDLERS) {
+  if (path === "$") return SCOPES.SCENARIO_ROOT;
+
+  const m = /\.Events\.([A-Za-z_][A-Za-z0-9_]*)\[\d+\](?![^[]*\.Events\.)/.exec(path);
+  if (m) {
+    const eventName = m[1];
+    const isScriptAction = node && typeof node === "object" && node.Action === "Script";
+    if (isScriptAction || node?.intent != null) {
+      const isInlineStepInit =
+        eventName === "Init" &&
+        /^\$\.Steps\.[A-Za-z_][A-Za-z0-9_]*\.Events\.Init\[\d+\]$/.test(path);
+      const isNamedInitHandler =
+        initHandlers.has(eventName) &&
+        /^\$\.Events\.[A-Za-z_][A-Za-z0-9_]*\[\d+\]$/.test(path);
+      return (isInlineStepInit || isNamedInitHandler)
+        ? SCOPES.EVENT_SCRIPT_INIT
+        : SCOPES.EVENT_SCRIPT;
+    }
+  }
+
+  if (node && typeof node === "object") {
+    if (node.ContentsType === "Group") return SCOPES.GROUP;
+    if (typeof node.ControlType === "string") return `control:${node.ControlType}`;
+  }
+
+  return "unknown";
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// kind registry — kinds/ 디렉토리 스캔으로 자동 등록.
+//
+// 부팅 시 한 번만 await — 이후 sync 디스패치. 새 kind 추가는 kinds/<name>.mjs
+// 파일만 추가하면 자동 인식. 파일명 = kind 이름 (확장자 제외, `_` 접두는 무시).
+// ─────────────────────────────────────────────────────────────────────────────
+
+const _SCRIPT_KIND_REGISTRY = new Map();
+
+async function loadScriptKindRegistry() {
+  const entries = readdirSync(KINDS_DIR);
+  for (const entry of entries) {
+    if (entry.startsWith("_")) continue; // _base.mjs 등 제외
+    if (!entry.endsWith(".mjs")) continue;
+    const name = entry.slice(0, -".mjs".length);
+    const mod = await import(pathToFileURL(join(KINDS_DIR, entry)).href);
+    if (typeof mod.default !== "function") {
+      throw new Error(`intent kind '${name}' (${entry}) 에 default export (expand fn) 없음.`);
+    }
+    _SCRIPT_KIND_REGISTRY.set(name, {
+      meta: mod.meta ?? { name, allowedScopes: null },
+      expand: mod.default,
+    });
+  }
+}
+
+await loadScriptKindRegistry();
+
+/** kind 이름 list — introspection / 에러 메시지 / INTENT.md 검증용. */
+export function listScriptKinds() {
+  return [..._SCRIPT_KIND_REGISTRY.keys()];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 슬롯 카탈로그 — 각 슬롯의 활성 Phase + 허용 scope + 펼침 함수
+// ─────────────────────────────────────────────────────────────────────────────
+
+const KNOWN_SLOTS = Object.freeze({
+  mock: {
+    activePhase: 2,
+    placeholderPhase: 2,
+    allowedScopes: [SCOPES.EVENT_SCRIPT_INIT],
+    expand: expandMock,
+  },
+  script: {
+    activePhase: 3,
+    placeholderPhase: 3,
+    allowedScopes: [SCOPES.EVENT_SCRIPT, SCOPES.EVENT_SCRIPT_INIT],
+    expand: expandScript,
+  },
+  // categories 슬롯은 Phase 4 에서 도입 후 폐기. Panel.* + Collections 모두
+  // 스튜디오가 자동 재생성하므로 AI 가 카테고리 정의를 박을 필요 없음.
+  // 카테고리 사용 사실은 intent.mock 의 카테고리명 + DataConnection.CategoryName
+  // 으로 cross-check 가 추출.
+});
+
+// ─────────────────────────────────────────────────────────────────────────────
+// mock 슬롯 펼침
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * 입력:  { <Cat>: [ {<field>: <value>, ...}, ... ], ... }
+ * 출력:  { script: "f.Collection.addSector({...}, '<Cat>')\n...", errors }
+ *
+ * 카테고리당 한 줄씩, 같은 카테고리 안 섹터는 `\n` 으로 연결. 호스트 Action 의
+ * Script 와 prepend 머지 (applyIntent 가 처리).
+ */
+function expandMock(props, scopePath) {
+  const errors = [];
+  if (!props || typeof props !== "object" || Array.isArray(props)) {
+    errors.push({
+      kind: "intent",
+      phase: "mock-shape",
+      path: scopePath,
+      message: `intent.mock 값은 객체여야 함 ({ '<Cat>': [{...}, ...] }). 받은 타입: ${Array.isArray(props) ? "array" : props === null ? "null" : typeof props}`,
+    });
+    return { script: "", errors };
+  }
+
+  const lines = [];
+  for (const [catName, sectors] of Object.entries(props)) {
+    const catPath = `${scopePath}.${catName}`;
+    if (!CATEGORY_NAME_RE.test(catName)) {
+      errors.push({
+        kind: "intent",
+        phase: "mock-category-name",
+        path: catPath,
+        catName,
+        message: `카테고리명 '${catName}' 형식 위반 — 'Ctg' 접두 + PascalCase (예: CtgEmployee, CtgItemList).`,
+        hint: `runtime/v1/collection/naming.md §2 (cross-check [category-name] 과 정렬).`,
+      });
+      continue;
+    }
+    if (!Array.isArray(sectors)) {
+      errors.push({
+        kind: "intent",
+        phase: "mock-sectors-shape",
+        path: catPath,
+        catName,
+        message: `intent.mock['${catName}'] 값은 섹터 객체 배열이어야 함. 받은 타입: ${typeof sectors}`,
+      });
+      continue;
+    }
+    if (sectors.length === 0) continue;
+
+    for (let i = 0; i < sectors.length; i++) {
+      const sector = sectors[i];
+      const sectorPath = `${catPath}[${i}]`;
+      if (!sector || typeof sector !== "object" || Array.isArray(sector)) {
+        errors.push({
+          kind: "intent",
+          phase: "mock-sector-shape",
+          path: sectorPath,
+          catName,
+          index: i,
+          message: `섹터 객체는 { key: value, ... } 형태여야 함.`,
+        });
+        continue;
+      }
+      // 키 형식 + 예약어 검사 (case-insensitive) — _base 의 통일 헬퍼.
+      let keyError = false;
+      for (const k of Object.keys(sector)) {
+        const beforeLen = errors.length;
+        validateKey(k, {
+          path: `${sectorPath}.${k}`,
+          errors,
+          kindLabel: "mock 섹터",
+          kindPhasePrefix: "mock-sector-key",
+        });
+        if (errors.length !== beforeLen) keyError = true;
+      }
+      if (keyError) continue;
+
+      lines.push(`f.Collection.addSector(${serializeSectorObject(sector)}, '${catName}')`);
+    }
+  }
+
+  return { script: lines.join("\n"), errors };
+}
+
+function serializeSectorObject(sector) {
+  const parts = [];
+  for (const [k, v] of Object.entries(sector)) {
+    parts.push(`${k}: ${JSON.stringify(v)}`);
+  }
+  return `{${parts.join(", ")}}`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// script 슬롯 — kind registry 디스패치
+// ─────────────────────────────────────────────────────────────────────────────
+
+function expandScript(props, scopePath) {
+  if (!props || typeof props !== "object" || Array.isArray(props)) {
+    return {
+      script: "",
+      errors: [{
+        kind: "intent",
+        phase: "script-shape",
+        path: scopePath,
+        message: `intent.script 값은 객체여야 함 ({ "kind": "<name>", ... }). 받은 타입: ${Array.isArray(props) ? "array" : props === null ? "null" : typeof props}`,
+      }],
+    };
+  }
+  const kind = props.kind;
+  if (typeof kind !== "string" || kind === "") {
+    return {
+      script: "",
+      errors: [{
+        kind: "intent",
+        phase: "script-kind-missing",
+        path: scopePath,
+        message: `intent.script.kind 필드 누락 또는 빈 문자열. 활성 kind: ${listScriptKinds().join(" / ")}.`,
+      }],
+    };
+  }
+  const entry = _SCRIPT_KIND_REGISTRY.get(kind);
+  if (!entry) {
+    return {
+      script: "",
+      errors: [{
+        kind: "intent",
+        phase: "unknown-kind",
+        path: `${scopePath}.kind`,
+        kindName: kind,
+        message: `intent.script.kind '${kind}' 미정의 — 활성 kind: ${listScriptKinds().join(" / ")}. 새 kind 는 runtime/v1/intent-system/kinds/<name>.mjs 추가로 등록.`,
+      }],
+    };
+  }
+  return entry.expand(props, scopePath);
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Public — applyIntent (단일 노드)
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function applyIntent(node, path = "$", initHandlers = _NO_INIT_HANDLERS) {
+  if (node == null || typeof node !== "object" || Array.isArray(node)) {
+    return { node, errors: [], applied: 0 };
+  }
+  if (!(INTENT_KEY in node)) {
+    return { node, errors: [], applied: 0 };
+  }
+
+  const intent = node[INTENT_KEY];
+  const intentPath = `${path}.${INTENT_KEY}`;
+  const errors = [];
+  const scope = inferScope(node, path, initHandlers);
+
+  if (intent == null || typeof intent !== "object" || Array.isArray(intent)) {
+    errors.push({
+      kind: "intent",
+      phase: "shape",
+      path: intentPath,
+      scope,
+      message: `intent 값은 객체여야 함 (받은 타입: ${Array.isArray(intent) ? "array" : intent === null ? "null" : typeof intent}).`,
+      hint: `형태: "intent": { "<slot>": ... } — 슬롯은 ${Object.keys(KNOWN_SLOTS).join(" / ")}.`,
+    });
+    const { [INTENT_KEY]: _drop, ...rest } = node;
+    return { node: rest, errors, applied: 0 };
+  }
+
+  let applied = 0;
+  const merged = { ...node };
+  delete merged[INTENT_KEY];
+
+  for (const slot of Object.keys(intent)) {
+    const meta = KNOWN_SLOTS[slot];
+    const slotPath = `${intentPath}.${slot}`;
+
+    if (!meta) {
+      errors.push({
+        kind: "intent",
+        phase: "unknown-slot",
+        path: slotPath,
+        slot,
+        scope,
+        message: `intent 슬롯 '${slot}' 미정의 — 허용: ${Object.keys(KNOWN_SLOTS).join(" / ")}.`,
+        hint: `runtime/v1/intent-system/INTENT.md '슬롯 ⨯ 호스트 매트릭스' 표 참고.`,
+      });
+      continue;
+    }
+
+    if (!meta.allowedScopes.includes(scope)) {
+      errors.push({
+        kind: "intent",
+        phase: "wrong-scope",
+        path: slotPath,
+        slot,
+        scope,
+        allowedScopes: [...meta.allowedScopes],
+        message: `intent.${slot} 슬롯은 scope '${scope}' 에서 사용 불가 — 허용 scope: ${meta.allowedScopes.join(", ")}.`,
+        hint: `INTENT.md 'Scope 카탈로그' 참고.`,
+      });
+      continue;
+    }
+
+    if (meta.activePhase == null) {
+      errors.push({
+        kind: "intent",
+        phase: "slot-not-implemented",
+        path: slotPath,
+        slot,
+        scope,
+        message: `intent.${slot} 슬롯은 Phase ${meta.placeholderPhase} 에서 활성화 예정 — 현재는 펼침 로직 미구현.`,
+      });
+      continue;
+    }
+
+    // 슬롯별 펼침 디스패치.
+    const r = meta.expand(intent[slot], slotPath);
+    if (r.errors && r.errors.length > 0) {
+      for (const e of r.errors) errors.push({ scope, ...e });
+    }
+
+    // mock / script — script (Script 본문) prepend 머지.
+    // (categories 슬롯 폐기 후 활성 머지 경로는 이것 하나.)
+    if (typeof r.script === "string" && r.script !== "") {
+      const existing = typeof merged.Script === "string" ? merged.Script : "";
+      merged.Script = existing ? `${r.script}\n${existing}` : r.script;
+      applied += 1;
+    }
+  }
+
+  return { node: merged, errors, applied };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Public — 트리 walker
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function applyIntentToScenario(scenario) {
+  const errors = [];
+  const counters = {
+    intentsSeen: 0,
+    slotsApplied: 0,
+    unknownSlots: 0,
+    wrongScopes: 0,
+    mockSectorsExpanded: 0,
+  };
+
+  if (scenario == null || typeof scenario !== "object" || Array.isArray(scenario)) {
+    return {
+      scenario,
+      report: { ...counters, note: "scenario 는 object 가 아님" },
+      errors: [
+        { kind: "intent", phase: "shape", path: "$", message: "scenario 는 object 여야 함." },
+      ],
+    };
+  }
+
+  // Step.Events.Init 이 문자열로 참조하는 named 핸들러 이름 수집 — 그 핸들러
+  // (scenario.Events.<name>) 안의 intent.mock 을 event-script-init 로 인정하기
+  // 위함 (inferScope 로 전달). 인라인 배열 Init 은 schema Init:string 와 충돌하므로
+  // named 핸들러가 intent.mock 의 schema-valid 한 정상 배치.
+  const initHandlers = new Set();
+  if (scenario.Steps && typeof scenario.Steps === "object" && !Array.isArray(scenario.Steps)) {
+    for (const step of Object.values(scenario.Steps)) {
+      const init = step?.Events?.Init;
+      if (typeof init === "string" && init) initHandlers.add(init);
+    }
+  }
+
+  function walk(node, path) {
+    if (node == null) return node;
+    if (Array.isArray(node)) {
+      return node.map((item, i) => walk(item, `${path}[${i}]`));
+    }
+    if (typeof node !== "object") return node;
+
+    let current = node;
+    if (INTENT_KEY in current) {
+      counters.intentsSeen += 1;
+      const r = applyIntent(current, path, initHandlers);
+      for (const e of r.errors) {
+        if (e.phase === "unknown-slot") counters.unknownSlots += 1;
+        if (e.phase === "wrong-scope") counters.wrongScopes += 1;
+        errors.push(e);
+      }
+      counters.slotsApplied += r.applied;
+      if (current[INTENT_KEY].mock && typeof current[INTENT_KEY].mock === "object") {
+        for (const sectors of Object.values(current[INTENT_KEY].mock)) {
+          if (Array.isArray(sectors)) counters.mockSectorsExpanded += sectors.length;
+        }
+      }
+      current = r.node;
+    }
+
+    const out = {};
+    for (const [k, v] of Object.entries(current)) {
+      out[k] = walk(v, `${path}.${k}`);
+    }
+    return out;
+  }
+
+  const out = walk(scenario, "$");
+  return {
+    scenario: out,
+    report: {
+      ...counters,
+      activeSlots: Object.entries(KNOWN_SLOTS).filter(([, m]) => m.activePhase != null).map(([n]) => n),
+      activeKinds: listScriptKinds(),
+    },
+    errors,
+  };
+}
+
+export function applyIntentToFragment(node) {
+  const r = applyIntentToScenario(node);
+  return { fragment: r.scenario, report: r.report, errors: r.errors };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Introspection
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const intentKnownSlots = Object.freeze(Object.keys(KNOWN_SLOTS));
+export const intentSlotMeta = Object.freeze(
+  Object.fromEntries(
+    Object.entries(KNOWN_SLOTS).map(([n, m]) => [
+      n,
+      Object.freeze({
+        activePhase: m.activePhase,
+        placeholderPhase: m.placeholderPhase,
+        allowedScopes: Object.freeze([...m.allowedScopes]),
+      }),
+    ]),
+  ),
+);

package/contract-data/runtime/v1/script/README.md

@@ -0,0 +1,37 @@
+# Runtime · Script (`f.*` / `Current.*` / `f.Content`) 진입점
+
+스크립트 영역(이벤트 스크립트, Init/After Script, Test-API/SQL Script 등)에서 호출 가능한 글로벌 객체들의 정의.
+시나리오 생성(AI 메타 자동 생성) 단계와 사용자 스크립트 단계에서 **사용 가능 범위가 다르므로** 본 폴더에서 그 경계를 명확히 한다.
+
+## 0. 핵심 규칙 — 시나리오 생성 시 허용 범위 (요약)
+
+> 시나리오 생성 결과물의 스크립트 본문에서 사용 가능한 진입점은 **컬렉션 변형 + 리로드 두 영역뿐**.
+> 그 외의 `f.*` / `_c.*` / `Current.*` / `f.Content().*` 멤버는 출력 금지 — 검증에서 차단.
+
+| 영역 | 허용 멤버 |
+|---|---|
+| 컬렉션 변형 | `f.Collection.addSector(obj, '카테고리')` |
+| 컬렉션 직접 접근 | `_c.카테고리.*`, `sector.*` (set/delete/setStatus/select 등) |
+| 리로드 (스텝) | `Current.step.reload()`, `Current.step.reloadWithAnimation()` |
+| 리로드 (그룹) | `f.Content(fid).reload()`, `f.Content(fid).reloadWithAnimation()` |
+
+> **섹터 접근은 스크립트 위치마다 다른 진입점** — 이벤트 Script 는 `_c.<카테고리>.activeSector` / `_c.<카테고리>[n]`, LoadScript(`{% %}`) 는 `Load.sector.<field>`, Filter Custom 은 bare `sector.X`. `_c.Sector` 는 어디서도 금지 (가짜 핸들). 매트릭스는 [scenario-gen-rules.md §2-1.1](./scenario-gen-rules.md) 와 [../collection/_c.md §6.5](../collection/_c.md).
+
+자세한 정책 / 검증 설계는 [scenario-gen-rules.md](./scenario-gen-rules.md).
+
+## 1. 폴더 구성
+
+| 파일 | 내용 |
+|---|---|
+| [f_collection.md](./f_collection.md) | `f.Collection.*` 전체 시그니처와 내부 동작. **생성 시 허용된 것은 `addSector` 뿐** |
+| [current_step.md](./current_step.md) | `Current.step` 의 모든 멤버. **생성 시 허용된 것은 `reload` / `reloadWithAnimation` 뿐** |
+| [f_content.md](./f_content.md) | `f.Content(fid)` 의 모든 멤버. **생성 시 허용된 것은 `reload` / `reloadWithAnimation` 뿐** |
+| [scenario-gen-rules.md](./scenario-gen-rules.md) | 시나리오 생성 단계 작성 규칙 — 결정 트리, 금지 패턴, 검증 설계 |
+
+> 본 폴더는 `f.*` / `Current.*` / `f.Content` 진입점만 다룬다. `_c.*` 직접 접근 패턴은 [../collection/](../collection/) 의 `sector.md` / `category.md` / `_c.md` 참조.
+
+## 2. 관련 문서
+
+- [../collection/README.md](../collection/README.md) — Collection/Category/Sector 모델 전반
+- [../collection/sector.md §4-0](../collection/sector.md) — 직접 대입 vs `set()` vs `setValue()` 비교
+- [../collection/category.md](../collection/category.md) — 카테고리 메서드(`add`/`remove`/`addSector`/`activate` 등)