deuk-agent-flow 4.2.7 → 5.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deuk-agent-flow",
-  "version": "4.2.7",
+  "version": "5.0.2",
   "description": "Keep AI coding work from vanishing between chats: repo-owned tickets, scope, verification, and memory for AGENTS.md-powered agents.",
   "keywords": [
     "agents-md",
@@ -22,73 +22,67 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/joygram/DeukAgentFlow.git"
+    "url": "git+https://github.com/joygram/DeukAgentFlow.git"
   },
   "bugs": {
     "url": "https://github.com/joygram/DeukAgentFlow/issues"
   },
   "homepage": "https://github.com/joygram/DeukAgentFlow#readme",
   "files": [
+    "LICENSE",
     "bin/**/*",
     "core-rules/**/*",
     "docs/architecture.md",
     "docs/architecture.ko.md",
+    "docs/badges/**/*",
     "docs/how-it-works.md",
     "docs/how-it-works.ko.md",
     "docs/principles.md",
     "docs/principles.ko.md",
-    "docs/npm-publish-guide.ko.md",
     "docs/usage-guide.ko.md",
     "docs/assets/**/*",
-    "NOTICE.md",
+    "bundled/**/*",
     "templates/**/*",
-    "scripts/cli.mjs",
-    "scripts/cli-args.mjs",
-    "scripts/cli-usage-commands.mjs",
-    "scripts/cli-init-commands.mjs",
-    "scripts/cli-init-logic.mjs",
-    "scripts/cli-prompts.mjs",
-    "scripts/cli-rule-compiler.mjs",
-    "scripts/cli-skill-commands.mjs",
-    "scripts/cli-telemetry-commands.mjs",
-    "scripts/cli-ticket-command-shared.mjs",
-    "scripts/cli-ticket-commands.mjs",
-    "scripts/cli-ticket-index.mjs",
-    "scripts/cli-ticket-migration.mjs",
-    "scripts/cli-ticket-parser.mjs",
-    "scripts/cli-utils.mjs",
-    "scripts/lint-md.mjs",
-    "scripts/lint-rules.mjs",
-    "scripts/merge-logic.mjs",
-    "scripts/plan-parser.mjs",
-    "scripts/publish-dual-npm.mjs",
-    "scripts/smoke-npm-local.mjs",
-    "scripts/smoke-npm-docker.mjs",
-    "scripts/update-download-badge.mjs",
+    "scripts/bundle-vscode-vsix.ts",
+    "scripts/cli.ts",
+    "scripts/cli-args.ts",
+    "scripts/cli-usage-commands.ts",
+    "scripts/cli-init-commands.ts",
+    "scripts/cli-init-logic.ts",
+    "scripts/cli-prompts.ts",
+    "scripts/cli-rule-compiler.ts",
+    "scripts/cli-skill-commands.ts",
+    "scripts/cli-telemetry-commands.ts",
+    "scripts/cli-ticket-command-shared.ts",
+    "scripts/cli-ticket-commands.ts",
+    "scripts/cli-ticket-index.ts",
+    "scripts/cli-ticket-migration.ts",
+    "scripts/cli-ticket-parser.ts",
+    "scripts/cli-utils.ts",
+    "scripts/lint-md.ts",
+    "scripts/lint-rules.ts",
+    "scripts/merge-logic.ts",
+    "scripts/plan-parser.ts",
     "README.md",
     "README.ko.md",
     "CHANGELOG.md",
     "CHANGELOG.ko.md"
   ],
   "scripts": {
-    "bump": "commit-and-tag-version",
-    "bump:patch": "commit-and-tag-version -r patch",
-    "bump:minor": "commit-and-tag-version -r minor",
-    "bump:major": "commit-and-tag-version -r major",
-    "merge:dry": "node scripts/cli.mjs merge --dry-run --cwd .. --agents skip",
-    "lint:md": "node scripts/lint-md.mjs",
-    "test": "node --test scripts/tests/*.test.mjs",
-    "sync:oss": "node scripts/sync-oss.mjs",
-    "publish": "node scripts/publish-dual-npm.mjs",
-    "publish:dry": "node scripts/publish-dual-npm.mjs --dry-run",
-    "smoke:npm:local": "node scripts/smoke-npm-local.mjs",
-    "smoke:npm:docker": "node scripts/smoke-npm-docker.mjs",
-    "publish:bootstrap": "node scripts/publish-dual-npm.mjs --alias-only",
-    "publish:bootstrap:dry": "node scripts/publish-dual-npm.mjs --alias-only --dry-run",
-    "badge:downloads": "node scripts/update-download-badge.mjs"
+    "dev:install": "npx tsc -p tsconfig.scripts.json && node scripts/out/scripts/dev-install.js",
+    "dev:install:no-bump": "npx tsc -p tsconfig.scripts.json && node scripts/out/scripts/dev-install.js --no-bump",
+    "build:vscode": "npx tsc -p tsconfig.scripts.json && node scripts/out/scripts/bundle-vscode-vsix.js",
+    "install:vscode": "node scripts/out/scripts/install-vscode-vsix.js --all",
+    "install:vscode:desktop": "node scripts/out/scripts/install-vscode-vsix.js --desktop",
+    "install:vscode:server": "node scripts/out/scripts/install-vscode-vsix.js --server",
+    "lint:md": "node scripts/out/scripts/lint-md.js",
+    "publish": "npm publish --access public",
+    "publish:dry": "npm publish --access public --dry-run",
+    "smoke:npm:local": "node scripts/out/scripts/smoke-npm-local.js",
+    "smoke:npm:docker": "node scripts/out/scripts/smoke-npm-docker.js"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "bin": {
     "deuk-agent-flow": "./bin/deuk-agent-flow.js",
@@ -97,10 +91,13 @@
     "deukagentrule": "./bin/deuk-agent-rule.js"
   },
   "devDependencies": {
-    "commit-and-tag-version": "^12.7.1"
+    "typescript": "^6.0.3",
+    "@types/node": "^25.9.3"
   },
   "dependencies": {
     "ejs": "^5.0.2",
+    "xstate": "^5.32.1",
     "yaml": "^2.8.3"
-  }
+  },
+  "type": "module"
 }

package/scripts/bundle-vscode-vsix.ts

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/**
+ * Packs vscode-extension into bundled/deuk-agent-flow.vsix for the npm tarball.
+ * Temporarily sets the extension package.json version to the root package version.
+ */
+import fs from "fs";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+import { CliOpts, makePath, resolvePackageRoot } from "./cli-utils.js";
+
+const root = resolvePackageRoot({ fromUrl: import.meta.url });
+const extDir = makePath(root, 'vscode-extension');
+const extPkgPath = makePath(extDir, 'package.json');
+const bundledDir = makePath(root, 'bundled');
+const vsixPath = makePath(bundledDir, 'deuk-agent-flow.vsix');
+const installAfterBundle = process.argv.includes('--install') || process.env.DEUK_AGENT_FLOW_INSTALL_VSIX === '1';
+const skipCompile = process.argv.includes('--skip-compile') || process.env.DEUK_AGENT_FLOW_SKIP_COMPILE === '1';
+
+const rootPkg = JSON.parse(fs.readFileSync(makePath(root, 'package.json'), 'utf8'));
+const extPkg = JSON.parse(fs.readFileSync(extPkgPath, 'utf8'));
+const savedPrepublish = extPkg.scripts?.['vscode:prepublish'];
+extPkg.version = rootPkg.version;
+extPkg.scripts = {
+  ...extPkg.scripts,
+  'vscode:prepublish': 'tsc -p ./',
+};
+fs.writeFileSync(extPkgPath, JSON.stringify(extPkg, null, 2) + '\n');
+
+try {
+  if (!fs.existsSync(bundledDir)) fs.mkdirSync(bundledDir, { recursive: true });
+  execSync('npm install --no-audit --no-fund --loglevel=silent', { cwd: extDir, stdio: 'inherit', shell: true } as any);
+  if (!skipCompile) {
+    execSync('npm run compile', { cwd: extDir, stdio: 'inherit' } as any);
+  }
+  const vsceBin = makePath(extDir, 'node_modules', '.bin', process.platform === 'win32' ? 'vsce.cmd' : 'vsce');
+  if (!fs.existsSync(vsceBin)) {
+    console.error('[deuk-agent-flow] @vscode/vsce missing. Run npm install in vscode-extension.');
+    process.exit(1);
+  }
+  const q = (s) => (s.includes(' ') ? `"${s.replace(/"/g, '\\"')}"` : s);
+  execSync(`${q(vsceBin)} package --no-dependencies --out ${q(vsixPath)}`, { cwd: extDir, stdio: 'inherit', shell: true } as any);
+  if (!fs.existsSync(vsixPath)) {
+    console.error('[deuk-agent-flow] bundle-vscode: expected VSIX missing:', vsixPath);
+    process.exit(1);
+  }
+  console.log('[deuk-agent-flow] bundled VS Code extension:', vsixPath);
+  if (installAfterBundle) {
+    if (process.platform === 'win32') {
+      // Windows node 컨텍스트: WSL bash 스크립트로 WSL 파일시스템에 직접 설치
+      const wslScript = execSync(`wsl.exe wslpath -u "${root.replace(/\\/g, '/')}/scripts/install-vsix-wsl.sh"`, { encoding: 'utf8', shell: true } as any).toString().trim();
+      execSync(`wsl.exe bash "${wslScript}"`, { stdio: 'inherit', shell: true } as any);
+    } else {
+      execSync('node scripts/out/scripts/install-vscode-vsix.js --all', { cwd: root, stdio: 'inherit', shell: true } as any);
+    }
+  }
+} finally {
+  // #version-sync: keep the extension package.json version pinned to the root version
+  // (do NOT restore savedVer) so vscode-extension/package.json auto-tracks the root on
+  // every bundle instead of drifting back to a stale value. Only prepublish is temporary.
+  extPkg.version = rootPkg.version;
+  if (savedPrepublish === undefined) {
+    delete extPkg.scripts['vscode:prepublish'];
+  } else {
+    extPkg.scripts['vscode:prepublish'] = savedPrepublish;
+  }
+  fs.writeFileSync(extPkgPath, JSON.stringify(extPkg, null, 2) + '\n');
+}

package/scripts/{cli-args.mjs → cli-args.ts}

@@ -1,12 +1,35 @@
+// Parse a phase token from --phase/--to. Accepts "2", "phase2", "phase 2", "end", "start".
+// Returns NaN when no digit is present and not a known named state so callers can detect
+// a malformed value (e.g. "--to phaseX") instead of silently advancing. (#635)
+const NAMED_PHASE_MAP = { start: 1, phase1: 1, phase2: 2, phase3: 3, phase4: 4, end: 4 };
+function parsePhaseToken(raw) {
+  const s = String(raw ?? "").trim().toLowerCase();
+  if (NAMED_PHASE_MAP[s] !== undefined) return NAMED_PHASE_MAP[s];
+  const m = s.match(/\d+/);
+  return m ? Number(m[0]) : NaN;
+}
+
 export function parseTicketArgs(argv) {
-  const out = { cwd: process.cwd(), dryRun: false, nonInteractive: false, limit: 20 };
+  const invocationCwd = process.cwd();
+  const out: Record<string, any> = { cwd: invocationCwd, invocationCwd, dryRun: false, nonInteractive: false, limit: 20 };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
-    if (a === "--cwd") out.cwd = argv[++i];
+    if (a === "--cwd") {
+      out.cwd = argv[++i];
+      out.cwdExplicit = true;
+    }
     else if (a === "--dry-run") out.dryRun = true;
+    else if (a === "--apply") out.apply = true;
     else if (a === "--non-interactive") out.nonInteractive = true;
-    else if (a === "--topic" || a === "--id") out.topic = argv[++i];
+    else if (a === "--id" || a === "--ticket") out.ticketId = argv[++i];
+    else if (a === "--title") out.title = argv[++i];
+    else if (a === "--platform") out.platform = argv[++i];
     else if (a === "--group") out.group = argv[++i];
+    else if (a === "--parent" || a === "--main-ticket") out.parent = argv[++i];
+    else if (a === "--workspace") out.workspace = argv[++i];
+    else if (a === "--allow-cwd-target") {
+      throw new Error("ticket commands no longer support cwd-based target selection. Use --workspace <id>.");
+    }
     else if (a === "--project") out.project = argv[++i];
     else if (a === "--content") out.content = argv[++i];
     else if (a === "--content-file") out.contentFile = argv[++i];
@@ -19,7 +42,10 @@ export function parseTicketArgs(argv) {
     else if (a === "--latest" || a === "-l") out.latest = true;
     else if (a === "--path-only") out.pathOnly = true;
     else if (a === "--print-content") out.printContent = true;
+    else if (a === "--with-total") out.withTotal = true;
+    else if (a === "--takeover") out.takeover = true;
     else if (a === "--all") out.all = true;
+    else if (a === "--active") out.active = true;
     else if (a === "--status") out.status = argv[++i];
     else if (a === "--archived") out.archived = true;
     else if (a === "--priority") out.priority = argv[++i];
@@ -33,13 +59,12 @@ export function parseTicketArgs(argv) {
     else if (a === "--docs-language") out.docsLanguage = argv[++i];
     else if (a === "--workflow") out.workflowMode = argv[++i];
     else if (a === "--approval") out.approval = argv[++i];
-    else if (a === "--ticket-started") out.ticketStarted = true;
-    else if (a === "--ticket-reviewed") out.ticketReviewed = true;
     else if (a === "--evidence") out.evidence = argv[++i];
     else if (a === "--skip-phase0") out.skipPhase0 = true;
     else if (a === "--summary") out.summary = argv[++i];
+    else if (a === "--type") out.ticketType = argv[++i];
     else if (a === "--tags") out.tags = argv[++i];
-    else if (a === "--phase") out.phase = Number(argv[++i]);
+    else if (a === "--phase" || a === "--to") { out.phase = parsePhaseToken(argv[++i]); out.phaseRequested = true; }
     else if (a === "--next") out.next = true;
     else if (a === "--handoff") out.handoff = true;
     else if (a === "--reason") out.reason = argv[++i];
@@ -48,30 +73,41 @@ export function parseTicketArgs(argv) {
     else if (a === "--allow-placeholder") out.allowPlaceholder = true;
     else if (a === "--compact") out.compact = true;
     else if (a === "--status-detail") out.statusDetail = true;
+    else if (a === "--verbose") out.verbose = true;
     else if (a === "-h" || a === "--help") out.help = true;
+    else if (a === "--session-id") out.sessionId = argv[++i];
+    else if (!a.startsWith("-")) out.ticketId = out.ticketId || a;
   }
   return out;
 }
 
 export function parseArgs(argv) {
-  const out = { cwd: process.cwd(), dryRun: false, backup: false };
+  const out: Record<string, any> = { cwd: process.cwd(), dryRun: false, backup: false };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
-    if (a === "--cwd") out.cwd = argv[++i];
+    if (a === "--cwd") {
+      out.cwd = argv[++i];
+      out.cwdExplicit = true;
+    }
     else if (a === "--dry-run") out.dryRun = true;
     else if (a === "--backup") out.backup = true;
     else if (a === "--non-interactive") out.nonInteractive = true;
     else if (a === "--interactive") out.interactive = true;
     else if (a === "--clean") out.clean = true;
     else if (a === "--tag") out.tag = argv[++i];
+    else if (a === "--platform") out.platform = argv[++i];
     else if (a === "--marker-begin") out.markerBegin = argv[++i];
     else if (a === "--marker-end") out.markerEnd = argv[++i];
-    else if (a === "--agents") out.agents = argv[++i];
     else if (a === "--cursorrules") out.cursorrules = argv[++i];
     else if (a === "--append-if-no-markers") out.appendIfNoMarkers = true;
     else if (a === "--workflow") out.workflowMode = argv[++i];
     else if (a === "--approval") out.approval = argv[++i];
+    else if (a === "--workspace") out.workspace = argv[++i];
+    else if (a === "--prompt") out.prompt = argv[++i];
+    else if (a === "--project") out.project = argv[++i];
+    else if (a === "--section") out.section = argv[++i];
     else if (a === "--json") out.json = true;
+    else if (a === "--path-only") out.pathOnly = true;
     else if (a === "--remote") out.remote = argv[++i];
     else if (a === "--kind" || a === "--workspace-kind") out.workspaceKind = argv[++i];
     else if (a === "--stack" || a === "--technical-surface") out.stack = argv[++i];
@@ -80,13 +116,14 @@ export function parseArgs(argv) {
     else if (a === "--no-sync") out.sync = false;
     else if (a === "--docs-language") out.docsLanguage = argv[++i];
     else if (a === "--compact") out.compact = true;
+    else if (a === "--session-id") out.sessionId = argv[++i];
     else if (a === "-h" || a === "--help") out.help = true;
   }
   return out;
 }
 
 export function parseSkillArgs(argv) {
-  const out = { cwd: process.cwd(), dryRun: false, nonInteractive: false };
+  const out: Record<string, any> = { cwd: process.cwd(), dryRun: false, nonInteractive: false };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--cwd") out.cwd = argv[++i];
@@ -100,7 +137,7 @@ export function parseSkillArgs(argv) {
 }
 
 export function parseUsageArgs(argv) {
-  const out = {
+  const out: Record<string, any> = {
     cwd: process.cwd(),
     json: false,
     platform: "",
@@ -137,7 +174,7 @@ export function parseUsageArgs(argv) {
 }
 
 export function parseTelemetryArgs(argv) {
-  const out = {
+  const out: Record<string, any> = {
     cwd: process.cwd(),
     tokens: 0,
     tdw: 0,

package/scripts/cli-init-commands.ts

@@ -0,0 +1,99 @@
+import { removeClaudeUserPromptSubmitHook, upsertClaudeUserPromptSubmitHook } from "./cli-init-claude.js";
+import { CANONICAL_INIT_CLEANUP_PATHS, CLAUDE_SETTINGS_PATH, CLAUDE_USERPROMPT_SUBMIT_COMMAND, CLAUDE_USERPROMPT_SUBMIT_MATCHER, GLOBAL_POINTER_BEGIN_PREFIX, GLOBAL_POINTER_END, MANAGED_BLOCK_BEGIN, MANAGED_BLOCK_END, hashManagedContent, mergeManagedBlock, safeReadText, splitManagedBlock, wrapManagedBlock } from "./cli-init-core.js";
+// #638: updateSiblingWorkspaceRegistry (B / ~/.agent-flow) retired — no longer called.
+import { dirname, basename, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readdirSync, unlinkSync, rmSync, renameSync, chmodSync, statSync, symlinkSync } from "fs";
+import { createHash } from "crypto";
+
+import { ensureTicketDirAndGitignore } from "./cli-init-logic.js";
+import { normalizeTicketPaths } from "./cli-ticket-migration.js";
+import { rebuildTicketIndexFromTopicFilesIfNeeded } from "./cli-ticket-parser.js";
+import { readTicketIndexJson, syncActiveTicketId, writeTicketIndexJson } from "./cli-ticket-index.js";
+import { ensureWorkspaceMigrated } from "./cli-ticket-home.js";
+import { syncExposedNativeSkills } from "./cli-skill-commands.js";
+
+// #623/#622-D: init-time migration of a workspace's tickets to ~/.deuk-agent/tickets/
+// and sync of native skills from the SSOT. Idempotent and best-effort — a failure
+// here must not abort workspace setup.
+function ensureTicketsMigratedOnInit(cwd, dryRun) {
+  try {
+    // #645: init is the ONLY entry point allowed to mint a brand-new workspace
+    // (marker + workspace.json). allowCreate gates that — without it, reconcile
+    // self-heals an already-registered workspace but never registers a new one.
+    ensureWorkspaceMigrated(cwd, { dryRun, allowCreate: true });
+  } catch (err) {
+    console.warn(`[INIT] ticket home migration skipped for ${basename(cwd)}: ${err.message}`);
+  }
+  try {
+    syncExposedNativeSkills(cwd, { dryRun });
+  } catch (err) {
+    console.warn(`[INIT] skill sync skipped for ${basename(cwd)}: ${err.message}`);
+  }
+}
+import { cliText, resolveCliLocale } from "./cli-locales.js";
+
+import { DEUK_ROOT_DIR, CliOpts, SPOKE_REGISTRY, TICKET_INDEX_FILENAME, TICKET_LIST_FILENAME, TICKET_SUBDIR, buildWorkspaceAliases, discoverAllWorkspaces, getWorkspaceInitConfigPath, isWorkflowExecute, loadInitConfig, makePath, normalizeRegistryPath, normalizeTicketGroup, normalizeWorkflowMode, parseFrontMatter, pruneRuleModules, resolveDocsLanguage, resolvePackageRoot, resolveUserHome, resolveWorkflowMode, stringifyFrontMatter, toPosixPath, toRepoRelativePath, writeFileLF } from "./cli-utils.js";
+
+import { removeFragmentedLocalAgentSurfaces, removeLegacyWorkspaceConfig, removeLocalSkillCopies, removeNestedLegacyWorkspaceConfigs, removeRuntimeTemplateCopies } from "./cli-init-migrate.js";
+import { buildGlobalClaudeInstructions, buildGlobalCodexInstructions, canonicalizeGeneratedCommandReferences, generateSpokeContent, mergeManagedRuleContent, removeDuplicateRuleCopies, runGlobalAgentInstructionSync, runSingleWorkspaceMaintenance, syncCodexMcpEndpointFromWorkspace } from "./cli-init-instructions.js";
+
+export function runWorkspaceMaintenance(cwd = process.cwd(), dryRun = false, bundleRoot = resolvePackageRoot({ fromUrl: import.meta.url }), opts: CliOpts = {}) {
+  dryRun = Boolean(dryRun);
+  if (!cwd || !existsSync(cwd)) return { removed: 0 };
+  if (opts.silent) {
+    const originalLog = console.log;
+    console.log = () => {};
+    try {
+      return runWorkspaceMaintenance(cwd, dryRun, bundleRoot, { ...opts, silent: false });
+    } finally {
+      console.log = originalLog;
+    }
+  }
+  const ignoreDirs = [];
+  const recursive = Boolean(opts.recursive);
+
+  const homeDir = resolveUserHome(opts);
+  const saved = loadInitConfig(cwd, { ...opts, homeDir }) || {};
+  const maintenanceOptions = { ...saved, ...opts };
+  runGlobalAgentInstructionSync(dryRun, bundleRoot, homeDir);
+  const codexMcpResult = syncCodexMcpEndpointFromWorkspace(cwd, { dryRun, homeDir });
+  const claudeSettingsResult = upsertClaudeUserPromptSubmitHook({ dryRun, homeDir });
+  // #638: the ~/.agent-flow sibling registry (B) is retired. Workspace candidates now
+  // come solely from ~/.deuk-agent/tickets/{uuid}/workspace.json (written by reconcile),
+  // so we no longer write B here — it only went stale and spawned ambiguous ghosts.
+  removeNestedLegacyWorkspaceConfigs(cwd, dryRun, ignoreDirs);
+  removeRuntimeTemplateCopies(cwd, dryRun);
+  removeLocalSkillCopies(cwd, dryRun);
+  removeDuplicateRuleCopies(cwd, dryRun);
+  canonicalizeGeneratedCommandReferences(cwd, bundleRoot, dryRun);
+  const removed = removeFragmentedLocalAgentSurfaces(cwd, dryRun);
+
+  const submodules = recursive ? discoverAllWorkspaces(cwd, ignoreDirs) : [cwd];
+  if (recursive && !submodules.includes(cwd)) submodules.push(cwd);
+
+  for (const subCwd of submodules) {
+    try {
+      runSingleWorkspaceMaintenance(subCwd, dryRun, bundleRoot, maintenanceOptions);
+      // #623: init is one of the two migration entry points (the other is ticket
+      // command entry). Move this workspace's tickets to home as part of setup.
+      ensureTicketsMigratedOnInit(subCwd, dryRun);
+    } catch (err) {
+      console.error(`[ERROR] Failed to initialize workspace ${basename(subCwd)}: ${(err as Error).message}`);
+    }
+  }
+
+  return {
+    removed,
+    codexMcpChanged: Boolean(codexMcpResult?.changed),
+    codexMcpUrl: codexMcpResult?.url || null,
+    claudeSettingsChanged: Boolean(claudeSettingsResult?.changed),
+    claudeSettingsHash: claudeSettingsResult?.hash || null
+  };
+}
+
+export function formatInitCompletionMessage(cwd, dryRun = false) {
+  const label = dryRun ? "Dry-run complete" : "Init complete";
+  return `[DONE] ${label} for ${basename(cwd)}. Rules and pointers are ready. \`이슈분석 티켓\`이라고 해보세요.`;
+}
+

package/scripts/cli-init-logic.ts

@@ -0,0 +1,46 @@
+import { existsSync, appendFileSync, writeFileSync, mkdirSync, readFileSync } from "fs";
+import { LEGACY_DEUK, DEUK_ROOT_DIR, CliOpts, isInsideGitWorkTree, makePath } from "./cli-utils.js";
+
+const GITIGNORE_AGENT_MARKER = "# deuk-agent-flow: agent hub directory (local, not committed by default)";
+const LEGACY_GITIGNORE_AGENT_MARKER = "# deuk-agent-rule: agent hub directory (local, not committed by default)";
+
+function hasExactGitignoreLine(content, line) {
+  return content
+    .split(/\r?\n/)
+    .map(s => s.trim())
+    .includes(line);
+}
+
+function removeExactGitignoreLines(content, lines) {
+  const remove = new Set(lines);
+  return content
+    .split(/\r?\n/)
+    .filter(line => !remove.has(line.trim()))
+    .join("\n");
+}
+
+export function ensureTicketDirAndGitignore(opts) {
+  const gitignorePath = makePath(opts.cwd, ".gitignore");
+
+  if (opts.dryRun) return;
+
+  if (!isInsideGitWorkTree(opts.cwd)) return;
+
+  let gi = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf8") : "";
+
+  // Remove all legacy/old deuk ignore lines. The new .deuk-workspace-id file is committed
+  // (not ignored), so no new ignore entry is added. Legacy dir names come from the single
+  // LEGACY_DEUK.dirs SSOT — for each we strip both "<dir>/" and "<dir>/tickets/". DEUK_ROOT_DIR
+  // ("<.deuk>/") is also stripped in case an older flow ever added it.
+  const legacyIgnoreLines = LEGACY_DEUK.dirs.flatMap(dir => [`${dir}/`, `${dir}/tickets/`]);
+  const cleanedGi = removeExactGitignoreLines(gi, [
+    ...legacyIgnoreLines,
+    GITIGNORE_AGENT_MARKER,
+    LEGACY_GITIGNORE_AGENT_MARKER,
+    `${DEUK_ROOT_DIR}/`,  // new .deuk/ root line (if ever added)
+  ]);
+  if (cleanedGi !== gi) {
+    writeFileSync(gitignorePath, cleanedGi.replace(/\n*$/, "\n"), "utf8");
+    console.log("[INIT] Removed legacy .deuk-agent/ .gitignore entries");
+  }
+}

package/scripts/{cli-prompts.mjs → cli-prompts.ts}

@@ -1,10 +1,10 @@
 import { createInterface } from "readline";
 import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-import { WORKSPACE_KINDS, AGENT_TOOLS, resolveDocsLanguage, normalizeWorkflowMode, WORKFLOW_MODE_EXECUTE } from "./cli-utils.mjs";
+import { AGENT_TOOLS, CliOpts, WORKFLOW_MODE_EXECUTE, WORKSPACE_KINDS, makePath, normalizeWorkflowMode, resolveDocsLanguage } from "./cli-utils.js";
+import { cliText } from "./cli-locales.js";
 
-export async function ask(rl, question) {
-  return new Promise((resolve) => rl.question(question, resolve));
+export async function ask(rl, question): Promise<string> {
+  return new Promise<string>((resolve) => rl.question(question, resolve));
 }
 
 export async function askYesNo(question, defaultYes = true) {
@@ -40,11 +40,11 @@ export async function selectMany(rl, prompt, choices) {
 }
 
 function hasAny(cwd, names) {
-  return names.some((name) => existsSync(join(cwd, name)));
+  return names.some((name) => existsSync(makePath(cwd, name)));
 }
 
-export function inferInitDefaults(cwd, opts = {}) {
-  const packageJsonPath = join(cwd, "package.json");
+export function inferInitDefaults(cwd, opts: CliOpts = {}) {
+  const packageJsonPath = makePath(cwd, "package.json");
   const packageJson = existsSync(packageJsonPath)
     ? readFileSync(packageJsonPath, "utf8")
     : "";
@@ -74,26 +74,12 @@ export function inferInitDefaults(cwd, opts = {}) {
 export async function runInteractive(opts) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {
-    console.log("\nDeukAgentFlow init — let's configure your workspace.\n");
+    const locale = resolveDocsLanguage(opts.docsLanguage ?? "auto");
+    console.log(`\n${cliText("prompts.init.heading", { locale })}\n`);
 
-    const workspaceKind = await selectOne(rl, "What kind of workspace is this?", WORKSPACE_KINDS);
+    const workspaceKind = await selectOne(rl, cliText("prompts.init.workspaceKind", { locale }), WORKSPACE_KINDS);
     const defaults = inferInitDefaults(opts.cwd, opts);
 
-    const targetAgents = join(opts.cwd, "AGENTS.md");
-    let agentsDefault = "inject";
-    if (!existsSync(targetAgents)) {
-      agentsDefault = "inject"; // will append markers
-      console.log("\n  No AGENTS.md found — will create with markers.");
-    } else {
-      const content = readFileSync(targetAgents, "utf8");
-      const hasMarkers = content.includes("deuk-agent-rule:begin") || content.includes("## DeukAgentFlow");
-      if (!hasMarkers) {
-        agentsDefault = "inject";
-        console.log("\n  AGENTS.md exists without managed markers — will append a managed block.");
-      }
-    }
-
-    opts.agents = opts.agents ?? agentsDefault;
     opts.workspaceKind = workspaceKind;
     opts.kind = workspaceKind;
     opts.stack = defaults.stack;
@@ -105,16 +91,15 @@ export async function runInteractive(opts) {
     opts.remoteSync = defaults.remoteSync;
     opts.pipelineUrl = defaults.pipelineUrl;
 
-    console.log("\n  Workspace Kind: " + workspaceKind);
-    console.log("  Technical Surface: " + opts.stack);
-    console.log("  AI Clients: " + (opts.agentTools.join(", ") || "all supported clients"));
-    console.log("  Docs Language: " + opts.docsLanguage);
-    console.log("  Workflow Mode: " + opts.workflowMode);
-    console.log("  Share Tickets: " + (opts.shareTickets ? "Yes (Shared)" : "No (Private)"));
-    console.log("  Deuk AgentContext MCP: hidden during init");
-    console.log("  External Sync: " + (opts.remoteSync ? "Enabled" : "Disabled"));
-    if (opts.remoteSync) console.log("  Sync URL: " + opts.pipelineUrl);
-    console.log("  AGENTS: " + opts.agents + "\n");
+    console.log(`\n  ${cliText("prompts.init.summary.workspaceKind", { locale, vars: { value: workspaceKind } })}`);
+    console.log(`  ${cliText("prompts.init.summary.technicalSurface", { locale, vars: { value: opts.stack } })}`);
+    console.log(`  ${cliText("prompts.init.summary.aiClients", { locale, vars: { value: opts.agentTools.join(", ") || cliText("prompts.init.summary.allSupportedClients", { locale }) } })}`);
+    console.log(`  ${cliText("prompts.init.summary.docsLanguage", { locale, vars: { value: opts.docsLanguage } })}`);
+    console.log(`  ${cliText("prompts.init.summary.workflowMode", { locale, vars: { value: opts.workflowMode } })}`);
+    console.log(`  ${cliText("prompts.init.summary.shareTickets", { locale, vars: { value: opts.shareTickets ? cliText("prompts.init.summary.shareYes", { locale }) : cliText("prompts.init.summary.shareNo", { locale }) } })}`);
+    console.log(`  ${cliText("prompts.init.summary.contextMcp", { locale })}`);
+    console.log(`  ${cliText("prompts.init.summary.externalSync", { locale, vars: { value: opts.remoteSync ? cliText("prompts.init.summary.enabled", { locale }) : cliText("prompts.init.summary.disabled", { locale }) } })}`);
+    if (opts.remoteSync) console.log(`  ${cliText("prompts.init.summary.syncUrl", { locale, vars: { value: opts.pipelineUrl } })}\n`);
   } finally {
     rl.close();
   }