@dusky-bluehour/agent-service 0.6.5 → 0.6.7

package/scripts/init.mjs

@@ -16,6 +16,21 @@ const CLI_NAME = 'tri-agent-manager';
 const STATE_DIR_NAME = '.tri-agent-manager';
 const LEGACY_STATE_DIR_NAME = '.tri-agent-os';
 const GUIDE_FILE_NAME = 'USAGE.ko.md';
+const PROJECT_RULE_MODE_VALUES = new Set(['always', 'if-instructions', 'if-present', 'never']);
+const PROJECT_RULE_BOOTSTRAP = {
+  'claude-code': {
+    sourceRelativePath: path.join('claude-code', 'instructions', 'CLAUDE.template.md'),
+    destinationRelativePath: 'CLAUDE.md'
+  },
+  codex: {
+    sourceRelativePath: path.join('codex', 'instructions', 'AGENTS.template.md'),
+    destinationRelativePath: 'AGENTS.md'
+  },
+  antigravity: {
+    sourceRelativePath: path.join('antigravity', 'instructions', 'WORKSPACE-RULES.template.md'),
+    destinationRelativePath: '{installRoot}/rules/workspace-core-rules.md'
+  }
+};
 
 const HELP_TEXT = [
   `${CLI_NAME} 사용법`,
@@ -24,8 +39,8 @@ const HELP_TEXT = [
   `  ${CLI_NAME} list`,
   `  ${CLI_NAME} setup   (install + interactive 별칭)`,
   `  ${CLI_NAME} wizard  (install + interactive 별칭)`,
-  `  ${CLI_NAME} install [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--force] [--dry-run] [--yes]`,
-  `  ${CLI_NAME} update  [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--dry-run] [--yes]`,
+  `  ${CLI_NAME} install [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--install-root <map>] [--project-rules <mode>] [--force] [--dry-run] [--yes]`,
+  `  ${CLI_NAME} update  [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--install-root <map>] [--project-rules <mode>] [--dry-run] [--yes]`,
   `  ${CLI_NAME} init    (install의 별칭)`,
   '',
   '옵션:',
@@ -34,6 +49,7 @@ const HELP_TEXT = [
   '  --components  구성요소 선택 (예: skills,workflows,commands) / all',
   '  --target      설치 경로 (기본: .)',
   '  --install-root 도구별 설치 루트 오버라이드 (예: codex=.codex,antigravity=.agent)',
+  '  --project-rules 프로젝트 규칙 파일 정책 (always|if-instructions|if-present|never)',
   '  --force       install 시 기존 파일 덮어쓰기',
   '  --dry-run     복사하지 않고 작업 계획만 출력',
   '  --yes         확인 프롬프트 생략',
@@ -41,11 +57,10 @@ const HELP_TEXT = [
   '  --non-interactive 비대화형 모드 강제',
   '  (중복 선택 입력은 자동으로 1회로 정리됨)',
   '',
-  'pnpm 예시:',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --interactive',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager update --interactive',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager setup',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager list'
+  'npx 예시:',
+  '  npx --yes --package @dusky-bluehour/agent-service tri-agent-manager --interactive',
+  '  npx --yes --package @dusky-bluehour/agent-service tri-agent-manager update --interactive',
+  '  npx --yes --package @dusky-bluehour/agent-service tri-agent-manager list'
 ].join('\n');
 
 function parseArgs(argv) {
@@ -73,6 +88,7 @@ function parseArgs(argv) {
     componentFlag: getFlag('--components'),
     targetFlag: getFlag('--target') ?? '.',
     installRootFlag: getFlag('--install-root'),
+    projectRulesFlag: getFlag('--project-rules'),
     force: hasFlag('--force'),
     dryRun: hasFlag('--dry-run'),
     yes: hasFlag('--yes'),
@@ -207,6 +223,15 @@ function getComponentInstallPath(component) {
   return installPath || component.path;
 }
 
+function getComponentDescription(toolId, component) {
+  const base = component?.description ?? '';
+  if (component?.id !== 'instructions' || !PROJECT_RULE_BOOTSTRAP[toolId]) {
+    return base;
+  }
+  const suffix = '규칙 파일 정책: always | if-instructions | if-present | never';
+  return base ? `${base} (${suffix})` : suffix;
+}
+
 function normalizeInstallRoot(rawRoot, toolId) {
   const trimmed = String(rawRoot ?? '').trim();
   if (!trimmed) {
@@ -227,6 +252,57 @@ function normalizeInstallRoot(rawRoot, toolId) {
   return normalized.replace(/\/+$/, '');
 }
 
+function normalizeProjectRulesMode(rawMode) {
+  const mode = String(rawMode ?? '')
+    .trim()
+    .toLowerCase();
+
+  if (!mode) {
+    return 'always';
+  }
+
+  const alias = {
+    on: 'always',
+    all: 'always',
+    instructions: 'if-instructions',
+    selected: 'if-instructions',
+    present: 'if-present',
+    existing: 'if-present',
+    off: 'never',
+    none: 'never'
+  };
+
+  const normalized = alias[mode] ?? mode;
+  if (!PROJECT_RULE_MODE_VALUES.has(normalized)) {
+    throw new Error(
+      `--project-rules 값이 올바르지 않습니다: ${rawMode} (always|if-instructions|if-present|never)`
+    );
+  }
+
+  return normalized;
+}
+
+function describeProjectRulesMode(mode) {
+  switch (mode) {
+    case 'always':
+      return '항상 생성/업데이트';
+    case 'if-instructions':
+      return '`instructions` 구성요소를 선택한 경우에만 생성/업데이트';
+    case 'if-present':
+      return '대상 규칙 파일이 이미 존재할 때만 업데이트';
+    case 'never':
+      return '생성/업데이트하지 않음';
+    default:
+      return mode;
+  }
+}
+
+function resolveProjectRuleDestination(toolId, installRoot) {
+  const meta = PROJECT_RULE_BOOTSTRAP[toolId];
+  if (!meta) return null;
+  return meta.destinationRelativePath.replace('{installRoot}', installRoot || '');
+}
+
 function parseInstallRootFlag(installRootFlag, catalog) {
   if (!installRootFlag) {
     return {};
@@ -399,11 +475,7 @@ async function loadToolWorkflowSummary(tool, selection) {
 function getToolExecutionGuide(tool, installRoot) {
   if (tool.id === 'codex') {
     return [
-      `프로젝트 루트에 \`AGENTS.md\`를 만들고 \`${path.join(
-        installRoot,
-        'instructions',
-        'AGENTS.template.md'
-      )}\`를 기반으로 팀 규칙을 확정합니다.`,
+      '프로젝트 루트의 `AGENTS.md`(자동 생성됨)를 열고 팀 규칙으로 보완합니다.',
       `\`${path.join(
         installRoot,
         'workflows',
@@ -415,6 +487,7 @@ function getToolExecutionGuide(tool, installRoot) {
 
   if (tool.id === 'claude-code') {
     return [
+      '프로젝트 루트의 `CLAUDE.md`(자동 생성됨)를 열고 팀 컨텍스트를 채웁니다.',
       `\`${path.join(
         installRoot,
         'workflows',
@@ -430,11 +503,21 @@ function getToolExecutionGuide(tool, installRoot) {
 
   if (tool.id === 'antigravity') {
     return [
+      `\`${path.join(
+        installRoot,
+        'rules',
+        'workspace-core-rules.md'
+      )}\`(자동 생성됨)를 열고 운영 규칙을 확정합니다.`,
       `\`${path.join(
         installRoot,
         'workflows',
         'workflow-catalog.json'
       )}\`에서 workflow ID를 선택합니다.`,
+      `선택한 workflow ID와 같은 이름의 정의 파일을 \`${path.join(
+        installRoot,
+        'workflows',
+        'definitions'
+      )}\`에서 확인합니다.`,
       `각 stage의 \`input_artifact\`를 \`${path.join(
         installRoot,
         'artifacts'
@@ -449,6 +532,7 @@ function getToolExecutionGuide(tool, installRoot) {
 function getToolInteractionTips(tool, installRoot) {
   if (tool.id === 'codex') {
     return [
+      '프로젝트 루트의 `AGENTS.md`를 팀 규칙 단일 진입점으로 유지하세요.',
       'Codex 대화 입력창에서 `$`를 누르면 사용 가능한 스킬 목록을 바로 열 수 있습니다.',
       `프로젝트 루트에서 스킬 파일을 직접 확인하려면 \`ls ${path.join(
         installRoot,
@@ -464,6 +548,7 @@ function getToolInteractionTips(tool, installRoot) {
 
   if (tool.id === 'claude-code') {
     return [
+      '프로젝트 루트 `CLAUDE.md`를 최신 상태로 유지하면 세션마다 동일한 기준으로 동작합니다.',
       `서브에이전트 이름은 \`${path.join(installRoot, 'agents')}\` 경로의 파일명 기준입니다.`,
       `프로젝트 루트에서 \`ls ${path.join(
         installRoot,
@@ -475,11 +560,21 @@ function getToolInteractionTips(tool, installRoot) {
 
   if (tool.id === 'antigravity') {
     return [
+      `\`${path.join(
+        installRoot,
+        'rules',
+        'workspace-core-rules.md'
+      )}\`를 Manager 단계의 승인 규칙 문서로 사용하세요.`,
       `워크플로우 선택은 \`${path.join(
         installRoot,
         'workflows',
         'workflow-catalog.json'
       )}\` 에서 WF ID를 먼저 고르는 방식으로 진행하세요.`,
+      `실행용 정의 파일은 \`${path.join(
+        installRoot,
+        'workflows',
+        'definitions'
+      )}\` 의 \`*.workflow.yaml\`을 사용하세요.`,
       `에이전트 역할은 \`${path.join(installRoot, 'agents', 'agent-catalog.json')}\` 에서 확인하세요.`,
       `입출력 아티팩트 스키마는 \`${path.join(
         installRoot,
@@ -510,6 +605,11 @@ async function writeUsageGuide({ catalog, selection, targetDir, mode }) {
   lines.push(`- 생성 시각: ${new Date().toISOString()}`);
   lines.push(`- 모드: ${mode}`);
   lines.push(`- 프리셋: ${selection.presetId ?? '수동/없음'}`);
+  lines.push(
+    `- 프로젝트 규칙 파일 정책: ${selection.projectRulesMode} (${describeProjectRulesMode(
+      selection.projectRulesMode
+    )})`
+  );
   lines.push(`- 대상 경로: ${targetDir}`);
   lines.push('');
   lines.push('이 문서는 현재 설치 선택값 기준으로 생성되었습니다.');
@@ -528,6 +628,10 @@ async function writeUsageGuide({ catalog, selection, targetDir, mode }) {
     lines.push(`## ${tool.title} (${tool.id})`);
     lines.push('');
     lines.push(`- 설치 루트: \`${path.join(targetDir, installRoot)}\``);
+    const projectRuleDestination = resolveProjectRuleDestination(tool.id, installRoot);
+    if (projectRuleDestination) {
+      lines.push(`- 프로젝트 규칙 파일: \`${path.join(targetDir, projectRuleDestination)}\``);
+    }
     if (tool.install_root_basis) {
       lines.push(`- 경로 기준: ${tool.install_root_basis}`);
     }
@@ -644,7 +748,7 @@ function clearTuiScreen() {
 }
 
 function formatTuiLine(prefix, label, selected = false) {
-  const marker = selected ? '✅' : '⬜';
+  const marker = selected ? '🟢' : '⚪';
   return `${prefix} ${marker} ${label}`;
 }
 
@@ -690,7 +794,7 @@ async function runSingleSelectMenu({ title, help, options, defaultIndex = 0 }) {
   while (true) {
     renderTuiHeader(title, help);
     options.forEach((option, index) => {
-      const pointer = index === cursor ? '👉' : '  ';
+      const pointer = index === cursor ? '◉' : '○';
       output.write(`${pointer} ${option.label}\n`);
       if (option.description) {
         output.write(`    ${option.description}\n`);
@@ -729,8 +833,8 @@ async function runMultiSelectMenu({
   const selected = new Set(preselectedIds);
   const optionRows = [
     ...choices.map((choice) => ({ kind: 'choice', ...choice })),
-    { kind: 'action', action: 'toggle-all', label: '🧩 전체 선택/해제' },
-    { kind: 'action', action: 'done', label: '🚀 선택 완료' }
+    { kind: 'action', action: 'toggle-all', label: '🟣 전체 선택/해제' },
+    { kind: 'action', action: 'done', label: '🔵 선택 완료' }
   ];
   let cursor = 0;
   let notice = '';
@@ -744,7 +848,7 @@ async function runMultiSelectMenu({
     output.write('\n');
 
     optionRows.forEach((row, index) => {
-      const pointer = index === cursor ? '👉' : '  ';
+      const pointer = index === cursor ? '◉' : '○';
       if (row.kind === 'choice') {
         output.write(`${formatTuiLine(pointer, row.label, selected.has(row.id))}\n`);
         if (row.description) {
@@ -813,7 +917,8 @@ async function promptInteractiveTui({
   mode,
   defaultTarget,
   presetFlag,
-  installRootOverridesFromFlag
+  installRootOverridesFromFlag,
+  projectRulesModeFromFlag
 }) {
   readline.emitKeypressEvents(input);
   const wasRawMode = Boolean(input.isRaw);
@@ -846,6 +951,9 @@ async function promptInteractiveTui({
 
     const targetDir = path.resolve(process.cwd(), targetInput);
     const state = await readState(targetDir);
+    const defaultProjectRulesMode = normalizeProjectRulesMode(
+      projectRulesModeFromFlag ?? (mode === 'update' ? state?.project_rules_mode : 'always')
+    );
     const presets = Array.isArray(catalog.presets) ? catalog.presets : [];
 
     const defaultPresetId =
@@ -928,7 +1036,7 @@ async function promptInteractiveTui({
         choices: tool.components.map((component) => ({
           id: component.id,
           label: `${component.title} (${component.id})`,
-          description: component.description
+          description: getComponentDescription(tool.id, component)
         })),
         preselectedIds: defaultComponents,
         minSelected: 1
@@ -943,12 +1051,47 @@ async function promptInteractiveTui({
       cliOverrides: installRootOverridesFromFlag
     });
 
+    let projectRulesMode = defaultProjectRulesMode;
+    if (!projectRulesModeFromFlag) {
+      const modeOption = await runSingleSelectMenu({
+        title: '🧭 프로젝트 규칙 파일 정책',
+        help: '조작: 위/아래/좌/우 이동, Enter 선택, q 종료',
+        options: [
+          {
+            id: 'always',
+            label: '🟢 always',
+            description: describeProjectRulesMode('always')
+          },
+          {
+            id: 'if-instructions',
+            label: '🟡 if-instructions',
+            description: describeProjectRulesMode('if-instructions')
+          },
+          {
+            id: 'if-present',
+            label: '🔵 if-present',
+            description: describeProjectRulesMode('if-present')
+          },
+          {
+            id: 'never',
+            label: '⚪ never',
+            description: describeProjectRulesMode('never')
+          }
+        ],
+        defaultIndex: ['always', 'if-instructions', 'if-present', 'never'].indexOf(
+          defaultProjectRulesMode
+        )
+      });
+      projectRulesMode = normalizeProjectRulesMode(modeOption.id);
+    }
+
     return {
       targetDir,
       selectedToolIds,
       componentSelection,
       presetId: selectedPreset?.id ?? null,
-      installRootOverrides
+      installRootOverrides,
+      projectRulesMode
     };
   } finally {
     setRawMode(wasRawMode);
@@ -961,7 +1104,8 @@ async function promptInteractiveText({
   mode,
   defaultTarget,
   presetFlag,
-  installRootOverridesFromFlag
+  installRootOverridesFromFlag,
+  projectRulesModeFromFlag
 }) {
   const rl = createInterface({ input, output });
 
@@ -996,6 +1140,9 @@ async function promptInteractiveText({
     }
     const targetDir = path.resolve(process.cwd(), targetInput);
     const state = await readState(targetDir);
+    const defaultProjectRulesMode = normalizeProjectRulesMode(
+      projectRulesModeFromFlag ?? (mode === 'update' ? state?.project_rules_mode : 'always')
+    );
 
     const presets = Array.isArray(catalog.presets) ? catalog.presets : [];
     let selectedPreset = findPreset(catalog, presetFlag);
@@ -1049,7 +1196,7 @@ async function promptInteractiveText({
       console.log(`📦 [${tool.title}] 구성요소 목록`);
       tool.components.forEach((component, index) => {
         console.log(`${index + 1}. ${component.title} (${component.id})`);
-        console.log(`   - ${component.description}`);
+        console.log(`   - ${getComponentDescription(tool.id, component)}`);
       });
 
       let defaultComponents = tool.components.map((c) => c.id);
@@ -1084,12 +1231,32 @@ async function promptInteractiveText({
       cliOverrides: installRootOverridesFromFlag
     });
 
+    let projectRulesMode = defaultProjectRulesMode;
+    if (!projectRulesModeFromFlag) {
+      console.log('');
+      console.log('🧭 프로젝트 규칙 파일 정책');
+      console.log(`1. always           - ${describeProjectRulesMode('always')}`);
+      console.log(`2. if-instructions  - ${describeProjectRulesMode('if-instructions')}`);
+      console.log(`3. if-present       - ${describeProjectRulesMode('if-present')}`);
+      console.log(`4. never            - ${describeProjectRulesMode('never')}`);
+      const modeAnswer = await ask('정책을 선택하세요. (번호/ID)', defaultProjectRulesMode);
+      const normalizedModeAnswer = modeAnswer.trim().toLowerCase();
+      const modeByNumber = {
+        '1': 'always',
+        '2': 'if-instructions',
+        '3': 'if-present',
+        '4': 'never'
+      };
+      projectRulesMode = normalizeProjectRulesMode(modeByNumber[normalizedModeAnswer] ?? modeAnswer);
+    }
+
     return {
       targetDir,
       selectedToolIds,
       componentSelection,
       presetId: selectedPreset?.id ?? null,
-      installRootOverrides
+      installRootOverrides,
+      projectRulesMode
     };
   } finally {
     rl.close();
@@ -1110,7 +1277,8 @@ function buildSelectionFromFlags({
   toolFlag,
   componentFlag,
   targetFlag,
-  installRootOverridesFromFlag
+  installRootOverridesFromFlag,
+  projectRulesModeFromFlag
 }) {
   const preset = findPreset(catalog, presetFlag);
   const presetToolIds = resolveToolsFromPreset(preset, catalog);
@@ -1153,7 +1321,8 @@ function buildSelectionFromFlags({
     selectedToolIds,
     componentSelection,
     presetId: preset?.id ?? null,
-    installRootOverrides
+    installRootOverrides,
+    projectRulesMode: normalizeProjectRulesMode(projectRulesModeFromFlag ?? 'always')
   };
 }
 
@@ -1179,6 +1348,54 @@ async function copyEntry(srcPath, destPath, { overwrite, dryRun }) {
   return { status: destExists ? 'overwritten' : 'copied' };
 }
 
+async function copyProjectRuleBootstrap({
+  toolId,
+  targetDir,
+  installRoot,
+  overwrite,
+  dryRun,
+  selectedComponentIds,
+  projectRulesMode
+}) {
+  const ruleMeta = PROJECT_RULE_BOOTSTRAP[toolId];
+  if (!ruleMeta) {
+    return null;
+  }
+
+  const normalizedMode = normalizeProjectRulesMode(projectRulesMode ?? 'always');
+  if (normalizedMode === 'never') {
+    return null;
+  }
+
+  const componentIds = new Set(selectedComponentIds ?? []);
+  if (normalizedMode === 'if-instructions' && !componentIds.has('instructions')) {
+    return null;
+  }
+
+  const srcPath = path.join(rootDir, ruleMeta.sourceRelativePath);
+  if (!(await exists(srcPath))) {
+    throw new Error(`[${toolId}] 프로젝트 규칙 템플릿 누락: ${ruleMeta.sourceRelativePath}`);
+  }
+
+  const destinationRelativePath = ruleMeta.destinationRelativePath.replace(
+    '{installRoot}',
+    installRoot || ''
+  );
+  const dstPath = path.join(targetDir, destinationRelativePath);
+
+  if (normalizedMode === 'if-present' && !(await exists(dstPath))) {
+    return null;
+  }
+
+  const result = await copyEntry(srcPath, dstPath, { overwrite, dryRun });
+  return {
+    toolId,
+    source: ruleMeta.sourceRelativePath,
+    destination: destinationRelativePath,
+    status: result.status
+  };
+}
+
 function statusLabel(status) {
   switch (status) {
     case 'copied':
@@ -1199,17 +1416,17 @@ function statusLabel(status) {
 function statusIcon(status) {
   switch (status) {
     case 'copied':
-      return '✅';
+      return '🟢';
     case 'overwritten':
-      return '♻️';
+      return '🔵';
     case 'skipped':
-      return '⏭️';
+      return '⚪';
     case 'would-copy':
-      return '📝';
+      return '🟡';
     case 'would-overwrite':
-      return '🛠️';
+      return '🟣';
     default:
-      return '•';
+      return '○';
   }
 }
 
@@ -1231,6 +1448,11 @@ function printPlan(catalog, selection, mode, targetDir, dryRun = false) {
   console.log(`실행 타입  : ${dryRun ? 'dry-run (실제 파일 변경 없음)' : '실행 (파일 변경 반영)'}`);
   console.log(`프리셋     : ${selection.presetId ?? '수동/없음'}`);
   console.log(`대상 경로  : ${targetDir}`);
+  console.log(
+    `규칙 파일  : ${selection.projectRulesMode} (${describeProjectRulesMode(
+      selection.projectRulesMode
+    )})`
+  );
   console.log(`선택 도구  : ${selection.selectedToolIds.length}개`);
 
   selection.selectedToolIds.forEach((toolId, index) => {
@@ -1262,6 +1484,20 @@ function printPlan(catalog, selection, mode, targetDir, dryRun = false) {
       }
     }
 
+    const projectRuleDestination = resolveProjectRuleDestination(tool.id, installRoot);
+    if (projectRuleDestination) {
+      let applyHint = '적용됨';
+      if (selection.projectRulesMode === 'if-instructions' && !componentIds.includes('instructions')) {
+        applyHint = '`instructions` 미선택으로 이번 실행에서는 생성/업데이트 안 함';
+      } else if (selection.projectRulesMode === 'if-present') {
+        applyHint = '대상 파일이 이미 있을 때만 업데이트';
+      } else if (selection.projectRulesMode === 'never') {
+        applyHint = '생성/업데이트 안 함';
+      }
+      console.log(`   규칙 파일 : ${projectRuleDestination}`);
+      console.log(`   적용 정책 : ${applyHint}`);
+    }
+
     if (tool.install_root_basis) {
       console.log(`   경로 기준 : ${tool.install_root_basis}`);
     }
@@ -1347,6 +1583,7 @@ async function writeState({ catalog, targetDir, packageData, mode, selection })
     package_version: packageData.version,
     updated_at: new Date().toISOString(),
     preset_id: selection.presetId ?? null,
+    project_rules_mode: normalizeProjectRulesMode(selection.projectRulesMode ?? 'always'),
     install_roots: installRoots,
     tools
   };
@@ -1409,6 +1646,19 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
         status: result.status
       });
     }
+
+    const ruleResult = await copyProjectRuleBootstrap({
+      toolId,
+      targetDir,
+      installRoot,
+      overwrite,
+      dryRun,
+      selectedComponentIds: componentIds,
+      projectRulesMode: selection.projectRulesMode
+    });
+    if (ruleResult) {
+      results.push(ruleResult);
+    }
   }
 
   console.log('');
@@ -1495,8 +1745,9 @@ function printList(catalog) {
           getComponentInstallPath(component)
         )}`
       );
-      if (component.description) {
-        console.log(`      ${component.description}`);
+      const description = getComponentDescription(tool.id, component);
+      if (description) {
+        console.log(`      ${description}`);
       }
     });
   });
@@ -1520,7 +1771,7 @@ function printList(catalog) {
   }
 
   console.log('━━━━━━━━ 권장 흐름 ━━━━━━━━');
-  console.log(`1) pnpm dlx ${CLI_NAME} --interactive`);
+  console.log(`1) npx --yes --package @dusky-bluehour/agent-service ${CLI_NAME} --interactive`);
   console.log('2) 설치 후 .tri-agent-manager/state.json 기준으로 update');
   console.log('3) update 시 필요한 도구만 부분 갱신');
 }
@@ -1563,6 +1814,9 @@ async function main() {
   }
 
   const installRootOverridesFromFlag = parseInstallRootFlag(options.installRootFlag, catalog);
+  const projectRulesModeFromFlag = options.projectRulesFlag
+    ? normalizeProjectRulesMode(options.projectRulesFlag)
+    : null;
 
   const shouldUseInteractive =
     !options.nonInteractive &&
@@ -1574,7 +1828,8 @@ async function main() {
         mode: command,
         defaultTarget: options.targetFlag,
         presetFlag: options.presetFlag,
-        installRootOverridesFromFlag
+        installRootOverridesFromFlag,
+        projectRulesModeFromFlag
       })
     : buildSelectionFromFlags({
         catalog,
@@ -1583,12 +1838,16 @@ async function main() {
         toolFlag: options.toolFlag,
         componentFlag: options.componentFlag,
         targetFlag: options.targetFlag,
-        installRootOverridesFromFlag
+        installRootOverridesFromFlag,
+        projectRulesModeFromFlag
       });
 
   const stateForTarget = await readState(rawSelection.targetDir);
   const selection = {
     ...rawSelection,
+    projectRulesMode: normalizeProjectRulesMode(
+      projectRulesModeFromFlag ?? stateForTarget?.project_rules_mode ?? rawSelection.projectRulesMode
+    ),
     installRootOverrides: buildInstallRootOverrides({
       catalog,
       selectedToolIds: rawSelection.selectedToolIds,