@decencia/ch-cli 1.30.0 → 1.31.0

package/dist/commands/userflows.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUserflowOrder = parseUserflowOrder;
+exports.registerUserflowsCommand = registerUserflowsCommand;
+const client_1 = require("../client");
+const output_1 = require("../output");
+const utils_1 = require("../utils");
+/**
+ * ch userflows — 유저플로우(분기 있는 사용자 여정의 Mermaid 문서) 관리 명령.
+ *
+ * ch-api의 /userflows REST(이슈 #216)를 호출한다. 명령 계약의 SSOT는 스킬
+ * `2t-decencia-channel-userflow-v2` §5이며, `ch screens` 선례를 그대로 따른다.
+ *
+ * 지키는 계약 두 가지:
+ *  - 출력(PLAT-003): `--json`(기계 모드)이면 stdout은 순수 JSON 문서 하나뿐이고
+ *    사람용 메시지는 stderr로 나간다. 빈 목록도 stdout에는 `[]`로 나간다.
+ *  - 종료코드: HTTP 4xx/5xx는 client의 응답 인터셉터가 exitCode를 세우지만, 서버에
+ *    닿기 전 로컬 입력 오류(파일 없음·--order 비숫자·수정 필드 0개)는 아무도
+ *    세워주지 않는다. 그래서 공용 failInput()(output.ts)으로 직접 exitCode=1을 세운다.
+ *
+ * Mermaid 문법은 CLI도 서버도 검증하지 않는다 — 문자열로 실어 보낼 뿐이다
+ * (렌더러 버전마다 유효 문법이 갈려서, 파서를 들고 있으면 그 버전이 곧 저장 가능한
+ * 문법의 상한이 된다). 렌더 실패는 웹 뷰어가 안내한다.
+ */
+/** create/update의 help 하단에 붙는 --file 안내. */
+const FILE_HELP = `
+--file <경로> — Mermaid 코드 파일 (.mmd):
+  ch userflows create --name "로그인·계정 복구" --file ./login-flow.mmd
+  cat login-flow.mmd | ch userflows create --name "로그인·계정 복구" --file -
+
+  BOM·CRLF는 자동 정제되어 LF로 전송된다 (PowerShell Out-File 호환).
+  "-"를 주면 stdin에서 읽는다. 플래그 없이 stdin을 넘겨다보지는 않는다 —
+  에이전트·CI 셸에서 fd0가 '열린 채 EOF가 오지 않는 파이프'인 경우가 흔해서,
+  암묵적 stdin 읽기는 "ch userflows update <id> --order 3" 같은 평범한 호출을
+  무한 대기시킨다.
+
+수정은 Read-before-Write:
+  Mermaid는 통째 교체다(부분 병합 없음). 고칠 때는 먼저
+  'ch userflows get <flowId> --json'으로 현재 코드를 받아 편집한 뒤 전체를 넘긴다.
+`;
+/**
+ * `--order` 값을 숫자로 파싱한다. 문자열을 그대로 서버에 실어 보내면 400으로
+ * 되돌아오므로 요청 전에 CLI가 거른다 (screens의 parseScreenOrder 선례).
+ *
+ * screens에서 import하지 않고 여기 둔다 — 커맨드 모듈끼리 헬퍼를 주고받으면
+ * 리소스 하나의 규칙 변경이 다른 리소스로 새어 나간다.
+ */
+function parseUserflowOrder(value, label = '--order') {
+    const trimmed = String(value).trim();
+    const n = Number(trimmed);
+    if (trimmed === '' || !Number.isFinite(n)) {
+        throw new Error(`${label}: 숫자를 지정하세요 (예: 3). 받은 값: "${value}"`);
+    }
+    return n;
+}
+/**
+ * Mermaid 코드를 해석한다. `--file -`이면 stdin, 그 외에는 파일에서 읽는다.
+ * 어느 경로든 BOM 제거 + CRLF→LF 정규화(readContentFile/readContentStdin).
+ *
+ * 인라인 플래그(`--mermaid "<코드>"`)는 두지 않는다. 플로우차트는 여러 줄이라
+ * 셸 인용부호를 타고 넘어오다 줄바꿈이 뭉개진다 — 파일이 정본이다.
+ */
+function resolveMermaid(file) {
+    if (file === '-') {
+        const piped = (0, utils_1.readContentStdin)();
+        if (piped === null) {
+            throw new Error('--file -: stdin에서 읽을 내용이 없습니다. Mermaid 코드를 파이프로 넘기거나 --file <경로>를 쓰세요.');
+        }
+        return requireNonEmptyMermaid(piped, '--file -');
+    }
+    return requireNonEmptyMermaid((0, utils_1.readContentFile)(file, '--file'), '--file');
+}
+/**
+ * 빈 Mermaid를 요청 전에 거른다. 서버도 400으로 막지만(CreateUserflowDto), 여기서
+ * 걸러야 "저장됐겠거니" 하고 넘어가지 않는다. PowerShell `Out-File`이 개행만 흘려
+ * 넣은 .mmd가 실제로 이 모양이라 흔하다.
+ */
+function requireNonEmptyMermaid(mermaid, label) {
+    if (mermaid.trim() === '') {
+        throw new Error(`${label}: Mermaid 코드가 비어 있습니다.`);
+    }
+    return mermaid;
+}
+/**
+ * 플래그를 요청 바디로 변환한다. 지정된 플래그만 담으므로 update에서 그대로 PATCH
+ * 바디가 되고, 미지정 필드는 서버가 보존한다.
+ *
+ * 입력 오류(파일 없음·본문 비었음·--order 비숫자)는 throw한다 — 호출부가
+ * failInput으로 받아 종료코드를 세운다.
+ */
+function buildUserflowBody(options) {
+    const body = {};
+    if (options.name !== undefined)
+        body.name = options.name;
+    // 빈 문자열 판정은 `!== undefined`로 한다. falsy 체크를 쓰면 `--description ""`
+    // (설명 지우기)가 무시된다.
+    if (options.description !== undefined)
+        body.description = options.description;
+    if (options.file !== undefined)
+        body.mermaid = resolveMermaid(options.file);
+    if (options.order !== undefined) {
+        body.order = parseUserflowOrder(options.order, '--order');
+    }
+    return body;
+}
+/** 기계 모드(=stdout이 순수 JSON이어야 하는 모드)인지. */
+function isMachineOutput(globalOpts) {
+    return !!(globalOpts.json || globalOpts.csv || globalOpts.quiet);
+}
+// ── 서브커맨드 ────────────────────────────────────────────────────────────
+function registerUserflowsList(userflows, program) {
+    userflows
+        .command('list')
+        .description('유저플로우 목록 조회 (order 오름차순, order 없는 플로우는 뒤)')
+        .action(async () => {
+        const globalOpts = program.opts();
+        try {
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.get('/userflows');
+            const items = Array.isArray(data) ? data : data?.data ?? [];
+            // 기계 모드 분기를 빈값 안내(printInfo)보다 앞에 둔다. 빈 결과도 stdout에
+            // `[]`로 나가야 하고, 사람용 안내문이 stdout(JSON)을 오염시키면 안 된다
+            // (PLAT-003, 이슈 #50 — db-tables에서 겪은 회귀).
+            if (isMachineOutput(globalOpts)) {
+                (0, output_1.formatOutput)(items, globalOpts);
+                return;
+            }
+            if (!items.length) {
+                (0, output_1.printInfo)('등록된 유저플로우가 없습니다.');
+                return;
+            }
+            // 표는 스킬 §5대로 order | id | name 세 컬럼이다. Mermaid 본문은 목록에
+            // 싣지 않는다 — 한 장이 수십 줄이라 표가 읽히지 않는다(get으로 본다).
+            (0, output_1.printTable)(['order', 'id', 'name'], items.map((f) => [
+                f?.order === undefined || f?.order === null ? '' : String(f.order),
+                String(f?.id ?? ''),
+                String(f?.name ?? ''),
+            ]));
+        }
+        catch (error) {
+            // 오류 출력·종료코드는 client 인터셉터가 처리했다.
+        }
+    });
+}
+function registerUserflowsGet(userflows, program) {
+    // 로컬 --json은 두지 않는다. commander가 부모(program)의 전역 옵션을 서브커맨드
+    // 뒤에서도 해석하므로 `ch userflows get <id> --json`이 그대로 동작한다.
+    userflows
+        .command('get <flowId>')
+        .description('유저플로우 상세 조회 (Mermaid 코드 포함 — 수정 전 Read-before-Write)')
+        .action(async (flowId) => {
+        const globalOpts = program.opts();
+        try {
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.get(`/userflows/${flowId}`);
+            (0, output_1.formatOutput)(data, globalOpts);
+        }
+        catch (error) {
+            // Error already handled
+        }
+    });
+}
+function registerUserflowsCreate(userflows, program) {
+    userflows
+        .command('create')
+        .description('유저플로우 생성 (한 장 = 한 여정)')
+        .requiredOption('--name <name>', '여정 이름 (필수)')
+        // --file을 requiredOption으로 둔다. mermaid는 서버 필수 필드라 없으면 400인데,
+        // 왕복 한 번 없이 여기서 걸러야 종료코드 계약("로컬 입력 오류는 요청 없이 exit≠0")이 선다.
+        .requiredOption('--file <path>', 'Mermaid 코드 파일 (.mmd, "-"이면 stdin) (필수)')
+        .option('--description <text>', '한 줄 설명 (이 여정이 무엇을 보여주는지)')
+        .option('--order <n>', '목록 정렬 순서 (숫자)')
+        .addHelpText('after', FILE_HELP)
+        .action(async (options) => {
+        const globalOpts = program.opts();
+        try {
+            // 파일을 먼저 읽고 dry-run을 판정한다 — 깨진 파일이 --dry-run에서 통과하면
+            // 정작 실행할 때 실패한다 (sqa add-scenario와 같은 순서).
+            let body;
+            try {
+                body = buildUserflowBody(options);
+            }
+            catch (e) {
+                (0, output_1.failInput)(e?.message ?? String(e));
+                return;
+            }
+            if (globalOpts.dryRun) {
+                (0, output_1.printInfo)(`[DRY-RUN] 유저플로우 "${options.name}" 생성 요청`);
+                return;
+            }
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.post('/userflows', body);
+            (0, output_1.formatOutput)(data, globalOpts);
+            (0, output_1.printSuccess)('유저플로우가 생성되었습니다.');
+        }
+        catch (error) {
+            // Error already handled
+        }
+    });
+}
+function registerUserflowsUpdate(userflows, program) {
+    userflows
+        .command('update <flowId>')
+        .description('유저플로우 부분 업데이트 (지정한 플래그만 변경)')
+        .option('--name <name>', '여정 이름')
+        .option('--file <path>', 'Mermaid 코드 파일 (.mmd, "-"이면 stdin) — 통째 교체')
+        .option('--description <text>', '한 줄 설명 ("" 이면 지움)')
+        .option('--order <n>', '목록 정렬 순서 (숫자)')
+        .addHelpText('after', FILE_HELP)
+        .action(async (flowId, options) => {
+        const globalOpts = program.opts();
+        try {
+            // 파일 읽기·입력 검증을 dry-run 판정보다 먼저 — create와 같은 이유.
+            let body;
+            try {
+                body = buildUserflowBody(options);
+            }
+            catch (e) {
+                (0, output_1.failInput)(e?.message ?? String(e));
+                return;
+            }
+            if (Object.keys(body).length === 0) {
+                (0, output_1.failInput)('수정할 필드를 지정하세요.');
+                return;
+            }
+            if (globalOpts.dryRun) {
+                (0, output_1.printInfo)(`[DRY-RUN] 유저플로우 "${flowId}" 수정 요청`);
+                return;
+            }
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.patch(`/userflows/${flowId}`, body);
+            (0, output_1.formatOutput)(data, globalOpts);
+            (0, output_1.printSuccess)('유저플로우가 수정되었습니다.');
+        }
+        catch (error) {
+            // Error already handled
+        }
+    });
+}
+function registerUserflowsDelete(userflows, program) {
+    userflows
+        .command('delete <flowId>')
+        .description('유저플로우 삭제')
+        .action(async (flowId) => {
+        const globalOpts = program.opts();
+        try {
+            if (globalOpts.dryRun) {
+                (0, output_1.printInfo)(`[DRY-RUN] 유저플로우 "${flowId}" 삭제 요청`);
+                return;
+            }
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.delete(`/userflows/${flowId}`);
+            // 기계 모드에서는 서버 응답을 stdout에 순수 JSON으로 남겨 JSON.parse가 되게 한다.
+            // 사람용(표) 모드에서는 성공 한 줄이면 충분하다.
+            if (isMachineOutput(globalOpts)) {
+                (0, output_1.formatOutput)(data, globalOpts);
+            }
+            (0, output_1.printSuccess)('유저플로우가 삭제되었습니다.');
+        }
+        catch (error) {
+            // Error already handled
+        }
+    });
+}
+function registerUserflowsCommand(program) {
+    const userflows = program
+        .command('userflows')
+        .description('유저플로우 관리 — 분기 있는 사용자 여정의 Mermaid 문서 (/userflows)');
+    registerUserflowsList(userflows, program);
+    registerUserflowsGet(userflows, program);
+    registerUserflowsCreate(userflows, program);
+    registerUserflowsUpdate(userflows, program);
+    registerUserflowsDelete(userflows, program);
+}
+//# sourceMappingURL=userflows.js.map

package/dist/commands/userflows.js.map

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

package/dist/index.js

@@ -53,6 +53,8 @@ const prd_1 = require("./commands/prd");
 const db_schema_1 = require("./commands/db-schema");
 const db_tables_1 = require("./commands/db-tables");
 const screens_1 = require("./commands/screens");
+const userflows_1 = require("./commands/userflows");
+const policies_1 = require("./commands/policies");
 const backup_1 = require("./commands/backup");
 const handoff_1 = require("./commands/handoff");
 const notifications_1 = require("./commands/notifications");
@@ -112,6 +114,8 @@ program.hook('preAction', (thisCommand) => {
 (0, db_schema_1.registerDbSchemaCommand)(program);
 (0, db_tables_1.registerDbTablesCommand)(program);
 (0, screens_1.registerScreensCommand)(program);
+(0, userflows_1.registerUserflowsCommand)(program);
+(0, policies_1.registerPoliciesCommand)(program);
 (0, backup_1.registerBackupCommand)(program);
 (0, handoff_1.registerHandoffCommand)(program);
 (0, notifications_1.registerNotificationsCommand)(program);

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decencia/ch-cli",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "Decencia Communication Channel CLI",
   "main": "dist/index.js",
   "bin": {

package/skill/2t-decencia-channel-change-manager/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-change-manager
 description: 기존 소통채널 프로젝트의 기능 추가/수정을 사용자와 대화로 명확화 → 전파 스킬로 연관 PRD/spec/DB/SQA 일괄 갱신 → 변경으로 생긴 새 할일을 GitHub 이슈로 발행하는 오케스트레이터 스킬. (1)대화로 변경 내용 확정 → (2)[게이트] 영향 범위 확인 후 전파 적용 → (3)[게이트] 할일 목록 확인 후 이슈 발행. "이 기능 바꿀래"·"기획 수정"·"이거 추가해줘(기존 프로젝트)" 류 요청 시.
 allowed-tools: Bash(ch:*) Bash(git:*) Bash(gh:*) Read Write
-version: 1.30.0
+version: 1.31.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-change-propagation-v2/SKILL.md

@@ -10,7 +10,7 @@ description: |
   (3) 명세·DB·SQA가 서로 어긋나 있는 의심이 들 때 (정합성 점검),
   (4) PRD 갱신 후 하위 spec/db/SQA로 변경분을 흘려보내야 할 때,
   (5) Sprint 진행 중 도메인 규칙·스키마가 흔들렸을 때 연쇄 갱신이 필요할 때.
-version: 1.30.0
+version: 1.31.0
 ---
 
 <!-- ch-version-gate -->
@@ -134,14 +134,18 @@ ch check
 | D | **spec 의 비즈니스 규칙(logic)** 변경 | `spec.logic` | 의존 spec, SQA(정상/비정상 TC), db-tables(검증 규칙·trigger), PRD 도메인 규칙 절 |
 | E | **권한/역할 정책** 변경 | 영향 spec.logic, db-tables.securityRules | 모든 영향 spec의 SQA(접근권한 TC), db-schema 보안 일관성 절, PRD 권한 절 |
 | F | **Story Point(points) 변경** | `spec.points` | Sprint 용량 산정, workStatus |
-| G | **Epic 명/범위 변경** | `spec.epic`, PRD Epic 절 | 모든 같은 Epic 산하 spec 재태깅, Sprint 묶음 |
+| G | **Epic 명/범위 변경** | `spec.epic`, PRD 기능 요구사항 카테고리 절 | 모든 같은 Epic 산하 spec 재태깅, Sprint 묶음 |
 | H | **PRD 본문 변경** | `prd` | 그 PRD에서 파생된 spec, db-schema, SQA 시트 — **전수 리뷰 트리거** |
 
+> **스토리 명세 프로젝트**(`storySpecsEnabled=true` — [[2t-decencia-channel-spec-v2]] §0)에서는 이렇게 읽는다:
+> C(UI 변경) = 화면 연결(`ui.screenRefs`)·화면(screens) 변경. interactionMap 등 UI 상세는 없다.
+> D(logic 변경) = 스토리문장(`story`)·사전 조건(`preconditions`)·로직 플로우(`dataFlowScenarios`)·비즈니스 규칙 변경. stateTransitions는 없다.
+
 사용자 발화 → 진앙 매핑 예시:
 - "users 테이블에 last_login_at 추가" → **A**
 - "회원 등급에 VIP 추가, 권한도 더 줘야 함" → **E** (+ D)
 - "로그인 화면에 SNS 로그인 버튼 추가" → **C** (+ E if 권한)
-- "이 spec의 규모(Story Point)를 다시 매김" → **F** (규모가 너무 크면 spec 자체를 여러 Story로 분리 — [[2t-decencia-channel-spec-v2]] §9)
+- "이 spec의 규모(Story Point)를 다시 매김" → **F** (규모가 너무 크면 spec 자체를 여러 Story로 분리 — [[2t-decencia-channel-spec-v2]] §2·§14)
 
 ---
 
@@ -153,7 +157,7 @@ ch check
 
 ```bash
 # 모든 spec과 dbTableRefs/relatedSpecIds
-ch specs list --json --per-page 200 > /tmp/specs.json
+ch specs list --json --per-page 100 > /tmp/specs.json
 
 # 모든 db-table
 ch db-tables list --json > /tmp/tables.json
@@ -313,7 +317,7 @@ ch prd get --json | jq -r '.content' | grep -niE "데이터 모델|컬럼|nullab
 - **B (새 테이블)**: 1 → 2(인벤토리/ERD, 테이블 단위) → 3(dbTableRefs) → 4 → 6. **5(PRD) 스킵** (새 *기능*이면 그건 C/H로 별도)
 - **C (UI만 변경)**: 1·2 스킵하고 3 → 4 → 5 → 6
 - **E (권한)**: 1(securityRules) + 3(logic) 거의 동시 → 2 → 4 → 5(권한 *정책* 절 — 기능이므로 PRD 가능) → 6
-- **G (Epic 변경)**: 3(spec.epic 재태깅) → 5(PRD Epic 절) → 6
+- **G (Epic 변경)**: 3(spec.epic 재태깅) → 5(PRD 기능 요구사항 카테고리) → 6
 - **H (PRD 변경)**: 5(PRD) → 영향 재조사 → 1~4 순차 → 6
 
 ---
@@ -378,7 +382,7 @@ ch specs update <specId> --work-status /tmp/ws.md --no-version
 ### 6.1 spec ↔ db-table 양방향 일치
 
 ```bash
-ch specs list --json --per-page 200 | jq -r '.data[] | "spec\t" + .id + "\t" + ((.dbTableRefs // []) | join(","))' > /tmp/spec_refs.tsv
+ch specs list --json --per-page 100 | jq -r '.data[] | "spec\t" + .id + "\t" + ((.dbTableRefs // []) | join(","))' > /tmp/spec_refs.tsv
 ch db-tables list --json | jq -r '.data[] | "table\t" + .id + "\t" + ((.relatedSpecIds // []) | join(","))' > /tmp/table_refs.tsv
 
 # spec.dbTableRefs에는 있는데 table.relatedSpecIds에 누락된 경우 → 불일치
@@ -489,7 +493,7 @@ jq -r '.data[] | select((.logic // "" | tostring) | test("nullable|timestamp\\b|
 3) ch specs update — 영향 spec.epic 일괄 재태깅
    (스크립트: for s in $(jq -r ... ); do ch specs update $s --epic <new>; done)
 4) (SQA는 대개 무영향. Epic 단위 필터링하는 사용처가 있다면 시트 분리 검토)
-5) PRD Epic 절
+5) PRD 기능 요구사항 카테고리 절
 6) Sprint — Epic 단위 묶음 사용 중이라면 sprint 재구성 검토
 7) workStatus
 ```

package/skill/2t-decencia-channel-cli-v2/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-cli-v2
 description: |
   [2t][v2] 소통채널 CLI(`ch`, npm @decencia/ch-cli) 가이드.
-  Epic-Story 체계(규모=Story Point)와 db-tables·screens 리소스, --work-status, --id, --points 등 플래그를 망라한다.
+  Epic-Story 체계(규모=Story Point)와 db-tables·screens 리소스, 스토리 명세 플래그(--story·--preconditions), --work-status, --id, --points 등을 망라한다.
   Use when:
   (1) spec/db-table/화면(screen)을 CLI로 다룰 때,
   (2) spec 규모를 Story Point(`--points`)로 매길 때,
@@ -10,7 +10,7 @@ description: |
   (4) ch screens 명령(list/get/create/update/delete/migrate)으로 화면을 다루거나 레거시 프로젝트를 화면 모드로 이관할 때,
   (5) spec의 화면 연결을 CLI로 걸거나 풀 때 (`ch specs screen-refs`),
   (6) Spec ID를 JIRA 스타일(`LOGIN-001`)로 직접 지정할 때 (`ch specs create --id`).
-version: 1.30.0
+version: 1.31.0
 ---
 
 <!-- ch-version-gate -->
@@ -42,32 +42,52 @@ ch specs update <specId> --logic /tmp/logic.json   # 3) 수정 적용
 
 ## 1. spec 명령
 
+프로젝트 모드에 따라 쓰는 플래그가 다르다 ([[2t-decencia-channel-spec-v2]] §0).
+
+**스토리 명세 모드** (`storySpecsEnabled=true` — 신규 프로젝트 기본):
+
+```bash
+# 생성 (사용자 지정 Spec ID = Epic 도메인 코드 prefix 권장)
+#   ID 패턴: ^[A-Za-z][A-Za-z0-9_]*-[A-Za-z0-9]+$ (MaxLength 60), 충돌 시 409
+ch specs create --id AUTH-001 \
+  --name "로그인" \
+  --device web,app --domain 회원 --permission 비회원 \
+  --epic AUTH \
+  --points 5 \
+  --story "회원은 이메일과 비밀번호로 로그인해서, 재인증 없이 자신의 프로젝트에 바로 접근하고 싶다." \
+  --preconditions ./preconditions.md \
+  --logic ./logic.json \
+  --db-tables tbl_users,tbl_sessions
+
+# 수정: 지정한 플래그만 PATCH. --no-version 시 버전 기록 생략.
+ch specs update <specId> --story "..." --no-version
+ch specs update <specId> --preconditions ./preconditions.md --no-version
+ch specs update <specId> --points 8 --no-version
+```
+
+- `--story "<줄글>"` — 스토리문장(As a/I want/So that). 스칼라라 그 값만 바뀐다.
+- `--preconditions <텍스트|파일경로>` — 사전 조건 마크다운.
+- `--domain`은 쉼표로 **복수** 지정 (`--domain 회원,관리자`).
+- `--type`(기능유형)·`--content`는 스토리 명세 모드에서 쓰지 않는다 (레거시 전용).
+- `--ui`는 화면 연결이 필요할 때 `{"screenRefs":[...]}`만 싣는다 (생성 시에만 — §1 화면 연결).
+
+**레거시 모드** (`storySpecsEnabled` 미설정·false — 기존 프로젝트):
+
 ```bash
-# 생성 (자동 ID)
 ch specs create \
   --name "로그인" \
   --device web,app --domain user --type 인증 --permission 비회원 \
   --content "이메일/비밀번호 로그인" \
-  --epic 인증 \
-  --points 5 \
-  --ui ./ui.json \
-  --logic ./logic.json \
+  --epic 인증 --points 5 \
+  --ui ./ui.json --logic ./logic.json \
   --db-tables tbl_users,tbl_sessions \
   --work-status ./work-status.md
 
-# 생성 (사용자 지정 Spec ID, JIRA 스타일 — ch-cli 1.3.5+ / ch-api b029f88+)
-#   패턴: ^[A-Za-z][A-Za-z0-9_]*-[A-Za-z0-9]+$ (MaxLength 60)
-#   충돌 시 409, 패턴 위반 시 400
-ch specs create --id LOGIN-001 \
-  --name "로그인" --device web --domain user --type 인증 --epic 인증
-
-# 수정: 지정한 플래그만 PATCH. --no-version 시 버전 기록 생략.
 ch specs update <specId> --epic 인증 --no-version
-ch specs update <specId> --points 8 --no-version
 ch specs update <specId> --work-status ./status.md
 ```
 
-> `--id`의 자세한 네이밍 규칙·예외·자동 다음 번호 산정 스크립트는 [[2t-decencia-channel-spec-v2]] §1.5 참조.
+> `--id`의 자세한 네이밍 규칙·예외·자동 다음 번호 산정 스크립트는 [[2t-decencia-channel-spec-v2]] §4 참조.
 
 ### Story Point (`--points`)
 
@@ -79,7 +99,7 @@ ch specs update <specId> --points 8 --no-version
 ```
 
 - `--points <n>` — 0 이상의 숫자(보통 피보나치 1/2/3/5/8/13). 진행률(%)·완료율은 없다 — 완료 여부는 `status`로.
-- Sprint 용량 = Σ spec.points ([[2t-decencia-channel-sprint-builder-v2]]). 규모 산정 가이드는 [[2t-decencia-channel-spec-v2]] §3.
+- Sprint 용량 = Σ spec.points ([[2t-decencia-channel-sprint-builder-v2]]). 규모 산정 가이드는 [[2t-decencia-channel-spec-v2]] §11.
 
 ### Task JSON (`--tasks`) — [deprecated]
 
@@ -107,7 +127,13 @@ ch specs update <specId> --points 8 --no-version
 
 ### UI JSON (`--ui`)
 
-**화면 모드** (`screensEnabled=true`) — spec.ui 소유 4필드만 쓴다.
+**스토리 명세 모드** (`storySpecsEnabled=true`) — `screenRefs`만 쓴다. interactionMap·primaryActions·keyInformation은 스토리 명세에 없다.
+
+```json
+{ "screenRefs": ["SCR-LOGIN"] }
+```
+
+**레거시 + 화면 모드** (`screensEnabled=true`) — spec.ui 소유 4필드만 쓴다.
 
 ```json
 {
@@ -161,7 +187,8 @@ ch specs update <specId> --points 8 --no-version
 ```
 
 - `dataFlowScenarios[]`=시나리오, 각 시나리오의 `steps[]`=순서 있는 단계, 각 단계의 `refs[]`=**db-tables의 tableId(+선택 field)를 가리키는 구조적 참조**(SSOT — 스키마 정의는 db-tables에만). 서버가 실존 검증: 없는 tableId/컬럼이면 400. `direction`은 `READ|WRITE|READWRITE`.
-- 단계 `description`은 필드명 나열이 아니라 **완결 문장**으로 — [[2t-decencia-channel-spec-v2]] §5.
+- `stateTransitions`(화면 상태 전이)는 **레거시 전용**이다. 스토리 명세 모드에서는 쓰지 않는다. 스토리 명세의 흐름은 로직 플로우 하나다(정상/예외 구분 없음 — 실패 경로는 분기로) — [[2t-decencia-channel-spec-v2]] §7.
+- 단계 `description`은 필드명 나열이 아니라 **완결 문장**으로 — [[2t-decencia-channel-spec-v2]] §7.
 - 하위호환: 레거시 `dataFlow`(문자열)/`dataFlowRefs[]`/`businessRuleRefs[]`도 그대로 수용된다(점진 마이그레이션). SQA 항목도 동일 취지로 `--db-tables`(쉼표 구분)를 가진다 — [[2t-decencia-channel-sqa-v2]].
 
 ### dbTableRefs (`--db-tables`)
@@ -248,6 +275,7 @@ ch db-tables delete <tableId>                    # 참조 spec의 dbTableRefs도
 ## 3. screens 명령 (화면)
 
 화면(Screen)은 화면 정의의 SSOT다. `ch_projects.screensEnabled=true`인 프로젝트에서 쓴다.
+**무엇을 적어야 하는지**(필수 기재항목 6종·디스크립션 작성규칙·예외상태 4종)는 [[2t-decencia-channel-screen-v2]]가 정본이다.
 
 ```bash
 ch screens list                                  # 표 출력: order | id | name | route | epic | states | specs
@@ -281,7 +309,7 @@ ch screens migrate --rollback                    # 화면 모드만 끄기 (화
 ch screens migrate --rollback --force            # 되돌아갈 route가 없어도 강행 (기본은 서버가 409로 거절)
 ```
 
-- `--id`는 JIRA 스타일(`SCR-001`). 패턴 `^[A-Za-z][A-Za-z0-9_]*-[A-Za-z0-9]+$`, 중복 시 409.
+- `--id`는 슬러그 스타일(`SCR-001`, `STORE-ORDER-DETAIL` 같은 다중 세그먼트 허용). 패턴 `^[A-Za-z][A-Za-z0-9_]*(-[A-Za-z0-9_]+)+$`, 중복 시 409. (spec ID 패턴과 다르다 — 화면만 완화됐다.)
 - 화면 소유 필드다. spec.ui가 아니라 여기에 적는다.
   - `--figma-node-id <id>` — 이 화면의 Figma 노드 ID(`123:456`). Figma URL의 `?node-id=` 값에서 `-`를 `:`로 바꾼 값이다.
   - `--page-file <path>` — 이 화면의 **페이지 진입 파일** 경로 하나(예: `src/app/store/[code]/page.tsx`). 하위 컴포넌트는 적지 않는다.

package/skill/2t-decencia-channel-db-schema-v2/SKILL.md

@@ -8,7 +8,7 @@ description: |
   (2) DB 테이블 단위로 컬럼·인덱스·보안규칙을 등록·수정할 때,
   (3) 새 테이블을 추가하면서 전체 인벤토리도 함께 업데이트할 때,
   (4) spec.dbTableRefs와 양방향 동기화가 필요한 작업 시.
-version: 1.30.0
+version: 1.31.0
 ---
 
 <!-- ch-version-gate -->
@@ -277,7 +277,7 @@ description 활용 권장:
 
 ### 5-4. state-machines.json — 엔티티 상태머신
 
-엔티티가 **저장되는 상태 컬럼**을 가지면(주문 `status`, 배포 `phase` 등) 그 생애주기를 여기에 정의한다. 화면의 휘발성 UI 전이(idle/loading 등)는 여기 말고 spec.logic.stateTransitions에 적는다 — [[2t-decencia-channel-spec-v2]] §5-3.
+엔티티가 **저장되는 상태 컬럼**을 가지면(주문 `status`, 배포 `phase` 등) 그 생애주기를 여기에 정의한다. 화면의 휘발성 UI 전이(idle/loading 등)는 여기 적지 않는다 — 화면(screens)의 `states`에, 레거시 프로젝트는 spec.logic.stateTransitions에 적는다([[2t-decencia-channel-spec-v2]] §L-3).
 
 `StateMachine[]` — 한 테이블에 상태머신 여러 개 가능(컬럼별).
 
@@ -327,7 +327,7 @@ description 활용 권장:
 
 #### spec dataFlow와의 상호참조 (`columnRef` ↔ `toState`)
 
-spec은 이 상태머신을 **`columnRef`로 잇는다**. spec의 dataFlow ref에서 `field`가 이 머신의 `columnRef`와 같으면, 그 ref는 이 엔티티의 상태 접근이다. 그 ref가 WRITE면 `toState`에 목표 상태(이 머신 `states[].value` 중 하나)를 적는다 — [[2t-decencia-channel-spec-v2]] §6-2-1.
+spec은 이 상태머신을 **`columnRef`로 잇는다**. spec의 dataFlow ref에서 `field`가 이 머신의 `columnRef`와 같으면, 그 ref는 이 엔티티의 상태 접근이다. 그 ref가 WRITE면 `toState`에 목표 상태(이 머신 `states[].value` 중 하나)를 적는다 — [[2t-decencia-channel-spec-v2]] §10-2.
 
 - **링크 방향**: db-tables가 상태를 **정의**(states·transitions)하고, spec은 `tableId` + `field`(=columnRef) + `toState`로 **참조**만 한다.
 - `ch specs get`은 이 머신 요약(states·transitions)을 spec ref 옆에 **읽기 시점에 인라인**해 준다. 그래서 상태 목록을 spec에 베낄 필요가 없다.
@@ -372,7 +372,7 @@ spec은 이 상태머신을 **`columnRef`로 잇는다**. spec의 dataFlow ref
 ## 8. 흔한 함정
 
 - columns/indexes/securityRules/stateMachines JSON은 **전체 교체**. 일부 수정 시 반드시 `get` 후 편집.
-- 상태 컬럼의 생애주기(주문 status 등)를 spec.logic.stateTransitions에 적으면 SSOT 위반 — 저장되는 엔티티 상태는 db-tables.stateMachines가 SSOT. spec의 stateTransitions는 화면 휘발성 전이만.
+- 상태 컬럼의 생애주기(주문 status 등)를 spec 쪽(흐름·레거시 stateTransitions)에 정의하면 SSOT 위반 — 저장되는 엔티티 상태는 db-tables.stateMachines가 SSOT. spec의 흐름은 `toState` 링크로 참조만 한다.
 - 전체 스펙 문서의 `--content`도 통째 교체. 작은 수정도 `get` 후 부분 편집해 통째 전송.
 - `relatedSpecIds`를 JSON에 명시해도 서버가 무시 (자동 관리 영역).
 - 새 테이블을 만들고 전체 스펙 인벤토리 갱신을 잊으면, 문서 읽는 사람이 그 테이블의 존재를 모른다.

package/skill/2t-decencia-channel-github-issue/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-github-issue
 description: gh CLI로 현재 repo에 GitHub 이슈를 작성한다. 이슈 1개=유형 1개(feat/fix/bug), 표준 본문 양식(작업내용·관련 명세 백링크·완료조건)으로 발행. "이슈 만들어줘"/"깃헙 이슈로 등록해줘" 요청 시, 또는 소통채널 기획·명세 작업 후 처리할 일들을 GitHub 이슈로 옮길 때 사용. 멱등성/중복방지·확인단계는 다루지 않음(요청대로 바로 생성).
 allowed-tools: Bash(gh:*) Bash(git:*) Read Write
-version: 1.30.0
+version: 1.31.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-orchestrator/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-orchestrator
 description: 소통채널 작업의 단일 진입점(디스패처). 사용자 요청을 듣고 7종(bootstrap·terraformer·change-manager·github-issue·issue-coder·pr-merger·sprint-runner) 중 적절한 곳으로 라우팅하고, 필요하면 여러 단계를 순차 오케스트레이션한다. 대화형 스킬은 메인 세션에서 Skill로, 자율 에이전트는 Agent로 위임. "소통채널 작업 해줘"·"이거 어떻게 처리하지?"처럼 무엇부터 할지 모를 때, 또는 신규기획/코드편입/기획변경/이슈/구현/머지/스프린트실행 어디로든 시작할 때.
 allowed-tools: Skill Agent Read Bash(ch:*) Bash(gh:*) Bash(git:*)
-version: 1.30.0
+version: 1.31.0
 ---
 
 <!-- ch-version-gate -->