npm - jutell - Versions diffs - 0.3.0 → 1.0.0 - Mend

jutell 0.3.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md +10 -4
package/assets/local-admin/assets/{index-Gxd8X8ii.js → index-4Pw2ygFb.js} +14 -14
package/assets/local-admin/index.html +1 -1
package/assets/local-admin-server.js +5 -0
package/assets/mcp-server/config/bridge-config.js +9 -0
package/assets/mcp-server/index.js +1 -1
package/assets/mcp-server/tools/bridge-tools.js +52 -0
package/assets/skill/SKILL.md +9 -7
package/assets/skill/references/explained-diff-format.md +37 -3
package/assets/skill/references/report-format.md +27 -0
package/assets/templates/request-builder/NEXT_AGENT_HANDOFF.md +91 -106
package/assets/version.json +1 -1
package/dist/config/managed.js +6 -1
package/dist/output/format.js +3 -3
package/dist/process/mcpProbe.js +1 -1
package/package.json +1 -1

package/assets/local-admin/index.html CHANGED Viewed

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content="JuTell by Ju0 개인 베타 로컬 관리자" />
     <title>JuTell 개인 베타 관리자</title>
-    <script type="module" crossorigin src="/assets/index-Gxd8X8ii.js"></script>
+    <script type="module" crossorigin src="/assets/index-4Pw2ygFb.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-CVml-p-C.css">
   </head>
   <body>

package/assets/local-admin-server.js CHANGED Viewed

@@ -91,6 +91,11 @@ function changedFields(before, after) {
   if (before.usageMeasurement.localCountersEnabled !== after.usageMeasurement.localCountersEnabled) {
     changes.push({ field: "usageMeasurement.localCountersEnabled", before: before.usageMeasurement.localCountersEnabled, after: after.usageMeasurement.localCountersEnabled });
   }
+  const beforeVoice = before.voice?.preset ?? "default";
+  const afterVoice = after.voice?.preset ?? "default";
+  if (beforeVoice !== afterVoice) {
+    changes.push({ field: "voice.preset", before: beforeVoice, after: afterVoice });
+  }
   return changes;
 }
 var SUPPORTED_VERSION, FEATURE_IDS, PROFILES, DEFAULT_CONFIG, LIMIT_RANGES, isRecord, hasOnlyKeys;

package/assets/mcp-server/config/bridge-config.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
+export const VOICE_PRESETS = ['default', 'plain', 'learning', 'jutell'];
 export const FEATURE_IDS = ['changeSummary', 'userVisibleChanges', 'internalChanges', 'mainFiles', 'explainedDiff', 'glossary', 'validationResults', 'riskAssessment', 'userActions', 'nextActionSuggestions', 'requestClarificationGuide', 'manualEditGuidance', 'requestBuilder'];
 export const PROFILE_FEATURES = {
     minimal: { changeSummary: true, userVisibleChanges: true, internalChanges: false, mainFiles: false, explainedDiff: false, glossary: false, validationResults: true, riskAssessment: false, userActions: true, nextActionSuggestions: false, requestClarificationGuide: false, manualEditGuidance: false, requestBuilder: true },
@@ -14,6 +15,7 @@ export const DEFAULT_CONFIG = {
     limits: { maxMainFiles: 5, maxGlossaryTerms: 3, compactReportMaxSentences: 12 },
     mcp: { enabled: false },
     usageMeasurement: { localCountersEnabled: false },
+    voice: { preset: 'default' },
 };
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const hasOnlyKeys = (value, keys) => Object.keys(value).every((key) => keys.includes(key));
@@ -35,7 +37,13 @@ export function normalizeConfig(value) {
         return structuredClone(DEFAULT_CONFIG);
     if ('usageMeasurement' in value && (!isRecord(value.usageMeasurement) || !hasOnlyKeys(value.usageMeasurement, ['localCountersEnabled']) || typeof value.usageMeasurement.localCountersEnabled !== 'boolean'))
         return structuredClone(DEFAULT_CONFIG);
+    if ('voice' in value && (!isRecord(value.voice) || !hasOnlyKeys(value.voice, ['preset']) || (value.voice.preset !== undefined && !VOICE_PRESETS.includes(String(value.voice.preset))))) {
+        return structuredClone(DEFAULT_CONFIG);
+    }
     const features = Object.fromEntries(FEATURE_IDS.map((id) => [id, typeof featuresInput[id] === 'boolean' ? featuresInput[id] : PROFILE_FEATURES[value.profile][id]]));
+    const voicePreset = isRecord(value.voice) && typeof value.voice.preset === 'string' && VOICE_PRESETS.includes(value.voice.preset)
+        ? value.voice.preset
+        : DEFAULT_CONFIG.voice.preset;
     return {
         version: 1,
         profile: value.profile,
@@ -43,6 +51,7 @@ export function normalizeConfig(value) {
         limits: { ...value.limits },
         mcp: isRecord(value.mcp) ? { enabled: value.mcp.enabled } : { ...DEFAULT_CONFIG.mcp },
         usageMeasurement: isRecord(value.usageMeasurement) ? { localCountersEnabled: value.usageMeasurement.localCountersEnabled } : { ...DEFAULT_CONFIG.usageMeasurement },
+        voice: { preset: voicePreset },
     };
 }
 async function readText(file) {

package/assets/mcp-server/index.js CHANGED Viewed

@@ -5,7 +5,7 @@ import { activeFeatures, beginnerReportRules, bridgeStatus, reportPreferences, s
 import { recordToolCall } from './tools/usage-counters.js';
 const server = new McpServer({
     name: 'JuTell',
-    version: '0.3.0',
+    version: '1.0.0',
 }, {
     instructions: 'JuTell by Ju0 is a local read-only report helper. Read only project configuration and approved report rules. Never access project code, Git diff, prompts, AI answers, secrets, or external networks. Skill mode remains available if this MCP server is disabled or unavailable. When both jutell and beginner_bridge servers are visible, prefer the canonical jutell server; use beginner_bridge only for compatibility. For owner-facing reports, apply the JuTell reporting guidance before composing the final answer.',
 });

package/assets/mcp-server/tools/bridge-tools.js CHANGED Viewed

@@ -13,6 +13,7 @@ export function bridgeStatus(context) {
         skillFileExists: context.skillExists,
         agentsFileExists: context.agentsExists,
         profile: context.config.profile,
+        voicePreset: context.config.voice.preset,
         activeFeatureCount: Object.values(context.config.features).filter(Boolean).length,
         configVersion: context.config.version,
         skillVersion: parseSkillVersion(context.skillText),
@@ -28,6 +29,7 @@ export function reportPreferences(config) {
     return {
         profile: config.profile,
         profileName: profileLabel[config.profile],
+        voicePreset: config.voice.preset,
         mainFilesLevel: config.limits.maxMainFiles <= 3 ? '최소' : config.limits.maxMainFiles <= 5 ? '보통' : '많이',
         glossaryLevel: config.limits.maxGlossaryTerms === 0 ? '사용 안 함' : config.limits.maxGlossaryTerms <= 1 ? '조금' : config.limits.maxGlossaryTerms <= 3 ? '보통' : '많이',
         reportLengthLevel: reportLength(config.limits.compactReportMaxSentences),
@@ -35,26 +37,76 @@ export function reportPreferences(config) {
     };
 }
 export const EXPLAINED_DIFF_SECTIONS = ['무엇을 바꿨나요?', '왜 바꿨나요?', '어디를 바꿨나요?', '실제 중요한 변경', '내가 직접 다듬고 싶다면?'];
+const readableCodeRule = {
+    when: '중요한 코드 블록이 이미 작업 과정에서 확인되었고, 사용자 이해에 실제 도움이 될 때만 1~2개까지 보여준다.',
+    maxSnippets: 2,
+    absoluteMaxSnippets: 2,
+    form: ['[중요한 코드]', '짧은 코드 블록', '[쉽게 보면]', '[영향]'],
+    reuseOnly: '이미 읽거나 비교한 코드만 사용한다. 이 섹션만을 위해 파일을 다시 읽거나 git diff를 다시 실행하지 않는다.',
+    omitWhen: [
+        '이미 확인된 코드 근거가 없다',
+        '긴 raw diff를 반복하는 형태다',
+        '줄별 프로그래밍 문법 강의가 된다',
+    ],
+    cautionAreas: '인증·권한·결제·데이터베이스처럼 민감한 영역은 코드 일부를 보여주더라도 주의가 필요하다고 표시한다.',
+};
 const explainedDiffRule = {
     when: '의미 있는 변경(기능 동작·화면 변화·데이터 처리 변화)을 보고할 때',
     sections: EXPLAINED_DIFF_SECTIONS,
     groupingRule: '관련된 파일과 변경은 기능 단위로 묶어 설명하고 전체 Diff 원문을 반복하지 않습니다.',
+    readableCodeRule,
     noEvidenceRules: {
         why: '변경 이유의 근거가 없으면 추측하지 않고 "변경 이유는 Agent 결과에서 확인되지 않았습니다."로 표시합니다.',
         customization: '문구·색상·여백·이동 경로처럼 직접 다듬을 수 있는 위치의 코드 근거가 없으면 "내가 직접 다듬고 싶다면?" 섹션을 만들지 않습니다.',
         riskyArea: '인증·권한·결제·데이터베이스처럼 위험한 영역은 간단한 화면 다듬기 대상으로 제시하지 않고 주의가 필요하다고 표시합니다.',
     },
 };
+const handoffRule = {
+    when: '사용자가 다음 AI에게 작업을 넘기거나, 세션을 마무리하며 이어서 할 일을 남겨달라고 할 때',
+    title: '다음 AI에게 전달하기',
+    sections: ['지금 하던 일', '방금 끝난 것', '확인된 것', '아직 확인하지 못한 것', '다음에 해줬으면 하는 것', '먼저 보면 좋은 파일'],
+    optionalSections: ['건드리면 안 되는 것', '사용자 결정이 필요한 것'],
+    evidenceRule: '현재 작업/세션에서 이미 아는 근거만 사용한다. 저장소를 다시 읽거나 테스트를 다시 돌리거나 자동으로 다른 Agent에 보내지 않는다.',
+    format: 'Markdown 복사 가능한 텍스트만 사용한다. HTML·클라우드·자동 오케스트레이션을 만들지 않는다.',
+    templateHint: 'Request Builder의 NEXT_AGENT_HANDOFF 템플릿 또는 세션 SESSION_SUMMARY 내용을 재사용해도 된다.',
+};
+const voiceRules = {
+    default: {
+        preset: 'default',
+        style: '일반적이고 명확한 비개발자용 설명',
+        guidance: '친절하고 분명한 쉬운 한국어로 설명한다. 사실·예상·미확인·위험·사용자 행동을 구분한다.',
+    },
+    plain: {
+        preset: 'plain',
+        style: '짧고 직접적인 평이한 문장',
+        guidance: '문장을 짧게 유지하고 군더더기 없이 핵심만 말한다. 근거·위험·검증 진실을 줄이지 않는다.',
+    },
+    learning: {
+        preset: 'learning',
+        style: '필요한 용어를 조금 더 풀어 설명',
+        guidance: '필수 용어가 나오면 짧은 쉬운 설명을 덧붙인다. 용어 설명을 늘려도 근거와 확인 상태는 그대로 둔다.',
+    },
+    jutell: {
+        preset: 'jutell',
+        style: '친절하고 자연스럽고 간결한 JuTell Style',
+        guidance: '딱딱한 문장을 현실적인 말로 풀고 핵심부터 말한다. 사실·검증·위험을 줄이거나 과장하지 않는다.',
+    },
+};
+export function voiceRule(config) {
+    return voiceRules[config.voice.preset] ?? voiceRules.default;
+}
 export function beginnerReportRules(config) {
     const active = Object.entries(config.features).filter(([, enabled]) => enabled).map(([id]) => FEATURE_CATALOG[id].label);
     return {
         language: '비개발자가 이해할 수 있는 쉬운 한국어',
         activeReportSections: active,
         limits: config.limits,
+        voiceRule: voiceRule(config),
         evidenceRule: '실제로 확인한 사실, 코드만 보고 예상한 내용, 확인하지 못한 내용을 구분합니다.',
         statusRule: '검증 결과와 보고서 상태를 일치시킵니다.',
         diffRule: '코드 또는 Diff를 사용자에게 보여줄 경우, 바로 뒤에 무엇을 수정했고 사용자에게 어떤 영향이 있는지 기능 단위로 설명합니다.',
         ...(config.features.explainedDiff ? { explainedDiffRule } : {}),
+        ...(config.features.requestBuilder ? { handoffRule } : {}),
         safetyRequirements: SAFETY_REQUIREMENTS,
         notCollected: ['프로젝트 코드', 'Git diff', 'Prompt', 'AI 답변 원문', '파일 경로', '비밀정보'],
     };

package/assets/skill/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: beginner-bridge
-jutellSkillVersion: "0.3.0"
+jutellSkillVersion: "1.0.0"
 schemaVersion: 1
 description: JuTell by Ju0 creates concise, evidence-based work reports for non-developers, separating observed facts, code-based expectations, verification results, risks, and user actions. The legacy Skill ID is retained for compatibility.
 ---
@@ -41,9 +41,10 @@ Codex 작업 결과를 비개발자가 이해할 수 있는 하나의 보고서
 2. JSON, `version`, Profile, Feature ID, boolean 값과 limits를 검증한다.
 3. 선택한 Profile의 기본값을 적용한다. 파일이 없으면 `balanced`를 사용한다.
 4. 명시적으로 적힌 `features`와 `limits`를 Profile 기본값보다 우선 적용한다.
-5. 안전상 강제 보고 항목과 사용자가 현재 요청에서 요구한 형식을 적용한다.
-6. 이번 보고서에서 사용할 최종 활성 Feature와 limits를 확정한다.
-7. 활성 Feature만 사용해 보고서를 작성하되, 강제 보고 항목은 생략하지 않는다.
+5. `voice.preset`이 있으면 보고 문체에만 적용한다. 지원 값: `default`, `plain`, `learning`, `jutell`. 없거나 잘못된 값이면 `default`로 진행한다. 말투를 바꿔도 사실·검증·위험·사용자 행동은 줄이거나 과장하지 않는다.
+6. 안전상 강제 보고 항목과 사용자가 현재 요청에서 요구한 형식을 적용한다.
+7. 이번 보고서에서 사용할 최종 활성 Feature와 limits를 확정한다.
+8. 활성 Feature만 사용해 보고서를 작성하되, 강제 보고 항목은 생략하지 않는다.
 설정 오류가 있으면 전체 설정을 추측해 고치지 않고 `balanced`로 진행한다. 오류가 있는 경우에만 설정 문제를 짧게 알리며 설정 파일 전체는 출력하지 않는다.
@@ -78,14 +79,15 @@ JuTell MCP가 보이면 canonical `jutell` 서버를 사용한다. `jutell`과 `
    * 보고서 상태: 확인 완료, 추가 확인 필요, 일부 확인, 작업 보류, 범위 밖
 11. 위험도는 변경 영향도를 기준으로 판단한다. 검증 도구가 없다는 이유만으로 위험도를 판정 불가로 만들지 않는다. 여러 조건이 겹치면 가장 높은 위험도를 적용한다.
 12. 필요한 용어만 처음 등장할 때 설명한다. 기술 전용 용어는 해당 기술이 사용되는 것을 확인한 경우에만 설명한다. 기본 사전에 없는 용어는 추측하지 않는다.
-13. 활성 Feature와 `references/report-format.md`에 따라 하나의 비개발자용 최종 보고를 작성한다. `explainedDiff`가 활성이면 의미 있는 변경에 같은 근거로 설명형 변경 요약을 덧붙인다.
-14. `nextActionSuggestions`가 활성일 때 보고서 끝에 다음 행동 제안을 **최대 3개**만 추가한다. 다음 경우에만 제안한다.
+13. 활성 Feature와 `references/report-format.md`에 따라 하나의 비개발자용 최종 보고를 작성한다. `explainedDiff`가 활성이면 의미 있는 변경에 같은 근거로 설명형 변경 요약을 덧붙인다. 중요한 코드 블록이 이미 작업 과정에서 확인되었고 사용자 이해에 실제 도움이 될 때만 1~2개까지 보여준다. 이 섹션만을 위해 파일을 다시 읽거나 git diff를 다시 실행하지 않는다. `explainedDiff`가 꺼져 있으면 Readable Code도 생략한다(사용자가 코드 설명을 명시한 경우만 예외).
+14. `requestBuilder`가 활성이고 사용자가 다음 AI에게 넘기기·세션 마무리·이어서 할 일 정리를 요청하면, 현재 작업에서 이미 아는 근거만으로 `다음 AI에게 전달하기` 블록을 만든다. Request Builder의 `NEXT_AGENT_HANDOFF` 템플릿 또는 세션 `SESSION_SUMMARY`를 재사용해도 된다. 저장소 재탐색, 테스트 재실행, 자동 전송, HTML/클라우드 산출물은 만들지 않는다.
+15. `nextActionSuggestions`가 활성일 때 보고서 끝에 다음 행동 제안을 **최대 3개**만 추가한다. 다음 경우에만 제안한다.
      * 사용자가 직접 확인해야 할 항목이 남은 경우
      * 검증되지 않아 보류된 항목이 있는 경우
      * 설정이 필요한 경우
      * 데이터 손실·보안 위험이 확인된 경우
      제안은 보고서에서 이미 확인된 항목 중에서만 고르고, 추측이나 새 작업을 제안하지 않는다. 해당하지 않으면 생략한다.
-15. 제출 전 다음을 점검한다.
+16. 제출 전 다음을 점검한다.
    * 화면 변화와 내부 변화를 분리했는가
    * 예상과 실제 확인을 구분했는가
    * 근거가 중요한 주장과 일치하는가

package/assets/skill/references/explained-diff-format.md CHANGED Viewed

@@ -77,14 +77,39 @@
 * 인증, 권한, 결제, 데이터베이스 처리 같은 영역은 간단한 다듬기 대상으로 제시하지 않는다. 대신 "이 부분은 간단한 화면 수정 대상이 아니라 주의가 필요한 변경입니다."처럼 표시한다.
 * TypeScript 문법 강의, React 줄별 해설처럼 구현 세부를 가르치지 않는다.
-## 5. 묶기와 길이
+## 5. 중요한 코드 (Readable Code)
+중요한 코드 블록이 이미 작업 과정에서 확인되었고, 사용자 이해에 실제 도움이 될 때만 1~2개까지 보여준다. 한 보고에서 2개를 넘지 않는다.
+형식 예시:
+- `[중요한 코드]` 뒤에 짧은 코드 블록 1개
+- `[쉽게 보면]`에 비개발자용 한두 문장
+- `[영향]`에 사용자에게 달라지는 점 한두 문장
+예시 코드: `if (!query.trim()) return;`
+쉽게 보면: 빈칸이나 공백만 입력한 상태에서는 검색이 실행되지 않도록 막는 부분입니다.
+영향: 사용자가 공백만 입력했을 때 불필요한 검색 요청이 발생하지 않습니다.
+규칙:
+* 이미 읽거나 비교한 코드만 사용한다.
+* 이 섹션만을 위해 파일을 다시 읽지 않는다.
+* 이 섹션만을 위해 git diff를 다시 실행하지 않는다.
+* 코드 근거가 없으면 이 섹션을 만들지 않는다.
+* 긴 raw diff를 반복하지 않는다.
+* 줄별 프로그래밍 문법 강의를 하지 않는다.
+* 인증·권한·결제·데이터베이스처럼 민감한 영역은 보여주더라도 주의가 필요하다고 표시한다.
+* `explainedDiff`가 OFF이면 Readable Code도 생략한다. 사용자가 코드 설명을 명시적으로 요청한 경우만 예외다.
+## 6. 묶기와 길이
 * 관련된 변경은 기능 단위로 묶는다. 파일마다 다섯 항목을 반복하지 않는다.
 * 전체 Diff 원문을 다시 출력하지 않는다. 중요한 변경 블록만 요약한다.
 * [실제 중요한 변경]은 확인된 핵심 동작 위주로 작성하고, 같은 내용을 다른 보고 항목에서 반복하지 않는다.
 * 기존 보고서 길이 규칙(`compactReportMaxSentences`, 작업 규모별 길이)이 우선한다. 설명을 붙인다고 길이 제한을 무시하지 않는다.
-## 6. 예시
+## 7. 예시
 합성 예시이며 실제 프로젝트가 아니다.
@@ -101,6 +126,15 @@
 [실제 중요한 변경]
 - 검색어가 비어 있으면 검색 버튼이 실행되지 않음
 - 검색어를 다시 입력하면 버튼이 원래대로 활성화됨
+[중요한 코드]
+if (!query.trim()) return;
+[쉽게 보면]
+빈칸이나 공백만 입력한 상태에서는 검색이 실행되지 않도록 막는 부분입니다.
+[영향]
+사용자가 공백만 입력했을 때 불필요한 검색 요청이 발생하지 않습니다.
 ```
 코드에서 버튼 문구 위치를 직접 확인했다면 마지막에 다음을 추가한다.
@@ -112,6 +146,6 @@
 변경 이유를 확인할 근거가 없었다면 `[왜 바꿨나요?]`에는 "변경 이유는 Agent 결과에서 확인되지 않았습니다."라고만 쓴다.
-## 7. 용어 설명
+## 8. 용어 설명
 설명에 필요한 개발 용어는 `glossary` Feature와 `glossary-ko.md` 규칙을 그대로 사용한다. 이 형식을 위해 별도의 용어 체계를 만들지 않는다.

package/assets/skill/references/report-format.md CHANGED Viewed

@@ -142,10 +142,37 @@
 * 근거가 없는 변경 이유는 추측하지 않고 "변경 이유는 Agent 결과에서 확인되지 않았습니다."로 표시한다.
 * 문구·색상·경로처럼 직접 다듬을 수 있는 위치의 코드 근거가 있을 때만 "내가 직접 다듬고 싶다면?"을 덧붙인다.
+* 중요한 코드 블록이 이미 작업 과정에서 확인되었고 사용자 이해에 실제 도움이 될 때만 1~2개까지 `[중요한 코드]` / `[쉽게 보면]` / `[영향]` 형식으로 보여준다. 이 섹션만을 위해 파일을 다시 읽거나 git diff를 다시 실행하지 않는다.
+* `explainedDiff`가 OFF이면 Readable Code도 생략한다. 사용자가 코드 설명을 명시한 경우만 예외다.
 * 단순 작업에는 이 형식을 강제하지 않고 기존 6개 항목을 유지한다.
 형식과 예시는 `references/explained-diff-format.md`를 따른다.
+## 6.8 다음 AI에게 전달하기
+`requestBuilder`가 활성이고 사용자가 다음 AI에게 넘기기·세션 마무리·이어서 할 일 정리를 요청하면, 현재 작업에서 이미 아는 근거만으로 아래 형식을 만든다.
+* 지금 하던 일
+* 방금 끝난 것
+* 확인된 것
+* 아직 확인하지 못한 것
+* 다음에 해줬으면 하는 것
+* 먼저 보면 좋은 파일
+* (해당할 때만) 건드리면 안 되는 것 / 사용자 결정이 필요한 것
+Request Builder의 `NEXT_AGENT_HANDOFF` 템플릿 또는 세션 `SESSION_SUMMARY`를 재사용해도 된다. 저장소 재탐색, 테스트 재실행, 자동 전송, HTML/클라우드 산출물은 만들지 않는다.
+## 6.9 말투 프리셋 (`voice.preset`)
+`.jutell.json`의 `voice.preset`이 있으면 보고 문체에만 적용한다. MCP `voiceRule`이 보이면 그것을 우선한다.
+* `default` — 일반적이고 명확한 비개발자용 설명
+* `plain` — 짧고 직접적인 평이한 문장
+* `learning` — 필요한 용어를 조금 더 풀어 설명
+* `jutell` — 친절하고 자연스럽고 간결한 JuTell Style
+말투를 바꿔도 사실·검증·위험·사용자 행동은 줄이거나 과장하지 않는다. 스타일 학습·임베딩·자동 말투 추론은 하지 않는다.
 ## 7. 금지 표현
 근거가 없으면 다음 표현을 사용하지 않는다.

package/assets/templates/request-builder/NEXT_AGENT_HANDOFF.md CHANGED Viewed

@@ -1,106 +1,91 @@
-# 다음 Agent에게 작업 넘기기
-> 이 템플릿은 지금까지의 작업 내용을 다음 AI Agent(또는 새 대화)에 전달할 때 사용합니다.
-> 작성법: `[ ]`에 체크하고, 빈칸은 쉬운 말로 채웁니다. 모르는 항목은 비워 두세요.
-## 1. 지금 만드는 것
-프로젝트와 지금 만들고 있는 화면이나 기능을 한두 문장으로 설명해 주세요.
-```
-(예: 메모를 저장하고 목록으로 보여주는 앱의 검색 기능)
-```
-- [ ] 잘 모르겠음
-- [ ] AI가 먼저 확인 후 제안
-## 2. 지금까지의 작업 요약
-이미 무엇을 했는지, 지금 어디까지 되어 있는지 적어 주세요.
-```
-(예: 메모 저장과 목록 표시까지 완료했고, 검색 기능을 만들던 중이다)
-```
-- [ ] 잘 모르겠음 (AI가 현재 상태를 확인해 정리해 주세요)
-- [ ] AI가 먼저 확인 후 제안
-## 3. 지금 문제가 되는 것
-지금 막혀 있거나 잘 안 되는 것을 적어 주세요.
-```
-(예: 검색 결과가 최신 메모부터 나오지 않는다)
-```
-- [ ] 정확히 무엇이 문제인지 모르겠음
-- [ ] 요청하지 않음 (막힌 것 없음)
-## 4. 다음에 할 일
-다음에 이어서 해야 할 일을 순서대로 적어 주세요. 없으면 비워 두세요.
-```
-1. (예: 검색 결과 정렬을 수정)
-2. (예: 검색 기록 화면 추가)
-```
-- [ ] 요청하지 않음 (아직 정하지 못함)
-- [ ] AI가 먼저 확인 후 제안
-## 5. 반드시 유지할 부분
-이전 작업에서 지켜야 하는 방식이나 지우면 안 되는 것을 적어 주세요.
-```
-(예: 저장 방식과 파일 위치는 그대로 유지)
-```
-- [ ] 현재 상태 유지
-- [ ] 요청하지 않음
-## 6. 바꾸면 안 되는 부분
-다음 작업에서 건드리면 안 되는 것을 적어 주세요.
-```
-(예: 결제 관련 코드는 건드리지 않는다)
-```
-- [ ] 요청하지 않음
-## 7. 사용자가 직접 확인할 부분
-다음 작업 후 사용자가 직접 눌러 보거나 확인해야 하는 것을 적어 주세요.
-```
-(예: 검색 결과가 실제 저장된 메모와 맞는지)
-```
-- [ ] 요청하지 않음
-## 8. AI가 먼저 확인할 질문
-- [ ] AI가 먼저 현재 프로젝트 상태를 확인한 뒤 "지금 상황 요약"을 알려주세요.
-- [ ] 이전 작업에서 남은 미완료 항목을 확인해 목록으로 보여주세요.
-- [ ] 전달받은 내용 중 빠진 것이 있는지 질문해 주세요.
-- [ ] AI가 먼저 확인 후 제안 (위 항목 대신 AI 판단에 맡김)
-## 9. 최종 요청문
-아래를 복사해서 다음 AI Agent에 붙여넣으세요. `( )` 자리에 위 내용을 합쳐서 적어도 됩니다.
-```text
-이 프로젝트의 작업을 이어서 맡아주세요.
-[프로젝트] (1번 항목 내용)
-[지금까지 한 것] (2번 항목 내용)
-[지금 문제] (3번 항목 내용, 없으면 "없음")
-[다음에 할 일] (4번 항목 내용, 없으면 "없음")
-[유지할 부분] (5번 항목, 없으면 "없음")
-[건드리면 안 되는 부분] (6번 항목, 없으면 "없음")
-[사용자 확인] (7번 항목, 없으면 "없음")
-먼저 현재 상태를 확인하고 "지금 상황 요약"부터 알려주세요.
-확인하지 못한 내용은 추측하지 말고 질문해주세요.
-```
+# 다음 AI에게 전달하기
+> 지금까지의 작업을 다음 AI Agent(또는 새 대화)에 넘길 때 쓰는 가벼운 전달문입니다.
+> 현재 작업/세션에서 **이미 아는 근거만** 채웁니다. 저장소를 다시 읽거나, 테스트를 다시 돌리거나, 자동으로 다른 Agent에 보내지 않습니다.
+> 모르는 항목은 비워 두거나 "확인하지 못함"으로 적습니다. Markdown 텍스트만 복사해서 사용합니다.
+## 지금 하던 일
+```
+(예: 메모 앱 검색에서 빈 입력 검색을 막는 작업)
+```
+## 방금 끝난 것
+```
+(예: 빈 검색어 가드와 관련 테스트를 반영함)
+```
+## 확인된 것
+```
+(예: 단위 테스트 통과. 검색어가 공백이면 요청이 나가지 않음)
+```
+## 아직 확인하지 못한 것
+```
+(예: 실제 브라우저에서 검색 버튼 동작은 직접 확인하지 않음)
+```
+## 다음에 해줬으면 하는 것
+```
+1. (예: 검색 결과 정렬을 최신순으로 맞추기)
+2. (예: 빈 입력 UI 안내 문구 추가)
+```
+## 먼저 보면 좋은 파일
+```
+- (예: src/features/search/SearchBar.tsx)
+- (예: src/features/search/SearchBar.test.tsx)
+```
+## 건드리면 안 되는 것 (해당할 때만)
+```
+(예: 결제·인증 관련 코드는 건드리지 않는다)
+```
+## 사용자 결정이 필요한 것 (해당할 때만)
+```
+(예: 빈 검색 안내 문구를 어떤 말로 할지)
+```
+---
+## 복사해서 다음 AI에게 붙여넣기
+아래를 복사한 뒤 `( )`를 위 내용으로 채우세요.
+```text
+다음 AI에게 전달하기
+지금 하던 일
+( )
+방금 끝난 것
+( )
+확인된 것
+( )
+아직 확인하지 못한 것
+( )
+다음에 해줬으면 하는 것
+( )
+먼저 보면 좋은 파일
+( )
+건드리면 안 되는 것
+(없으면 "없음")
+사용자 결정이 필요한 것
+(없으면 "없음")
+이미 확인된 근거만 사용하고, 확인하지 못한 내용은 추측하지 말고 질문해주세요.
+```

package/assets/version.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "cli": "0.3.0",
+  "cli": "1.0.0",
   "skill": "확인 필요",
   "mcp": "0.1.0",
   "admin": "0.1.0"

package/dist/config/managed.js CHANGED Viewed

@@ -24,6 +24,7 @@ const fallbackConfig = {
     limits: { maxMainFiles: 5, maxGlossaryTerms: 3, compactReportMaxSentences: 12 },
     mcp: { enabled: false },
     usageMeasurement: { localCountersEnabled: false },
+    voice: { preset: 'default' },
 };
 export async function exists(file) {
     try {
@@ -94,6 +95,10 @@ export function normalizeConfig(value) {
     const inputMcp = input.mcp && typeof input.mcp === 'object' && !Array.isArray(input.mcp) ? input.mcp : {};
     const inputUsageMeasurement = input.usageMeasurement && typeof input.usageMeasurement === 'object' && !Array.isArray(input.usageMeasurement) ? input.usageMeasurement : {};
     const inputVoice = input.voice && typeof input.voice === 'object' && !Array.isArray(input.voice) ? input.voice : {};
+    const voicePresets = ['default', 'plain', 'learning', 'jutell'];
+    const voicePreset = typeof inputVoice.preset === 'string' && voicePresets.includes(inputVoice.preset)
+        ? inputVoice.preset
+        : 'default';
     return {
         version: 1,
         profile,
@@ -101,7 +106,7 @@ export function normalizeConfig(value) {
         limits: { maxMainFiles: numberOr('maxMainFiles', 5), maxGlossaryTerms: numberOr('maxGlossaryTerms', 3), compactReportMaxSentences: numberOr('compactReportMaxSentences', 12) },
         mcp: { enabled: inputMcp.enabled === true },
         usageMeasurement: { localCountersEnabled: inputUsageMeasurement.localCountersEnabled === true },
-        ...(typeof inputVoice.preset === 'string' ? { voice: { preset: inputVoice.preset } } : {}),
+        voice: { preset: voicePreset },
     };
 }
 export async function readBridgeConfig(paths) {

package/dist/output/format.js CHANGED Viewed

@@ -140,7 +140,7 @@ export function parseOptions(args) {
 }
 export function scopeLabel(scope) { return scope === 'global' ? '사용자 전역' : '현재 프로젝트'; }
 export function printHelp(io) {
-    io.write(`JuTell CLI 0.3.0
+    io.write(`JuTell CLI 1.0.0
 시작할 때는 jutell만 입력하면 됩니다.
 처음 연결하면 안내에 따라 AI Agent와 보고 방식을 고르고
@@ -182,6 +182,6 @@ JuTell은 AI Agent를 대신 실행하지 않고 연결과 보고만 도와줍
 이전 별칭: beginner-bridge
-실제 배포 전에는 로컬 패키지 검증만 지원합니다. 업데이트는 다음 명령을 사용하세요.
-  npm update -g jutell`);
+공개 설치: npm install -g jutell
+업데이트: npm update -g jutell`);
 }

package/dist/process/mcpProbe.js CHANGED Viewed

@@ -6,7 +6,7 @@ const INITIALIZE = JSON.stringify({
     jsonrpc: '2.0',
     id: 1,
     method: 'initialize',
-    params: { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: 'jutell-doctor', version: '0.3.0' } },
+    params: { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: 'jutell-doctor', version: '1.0.0' } },
 });
 const INITIALIZED = JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' });
 const TOOLS_LIST = JSON.stringify({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "jutell",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "description": "JuTell by Ju0 — non-developer harness for AI coding agents (Skill, MCP, local dashboard)",
   "license": "MIT",
   "repository": {