@foggy-projects/deepseek-harness-plugin 0.4.0-beta.2 → 0.4.0-beta.3

package/README.md

@@ -8,7 +8,7 @@ only when the user selects **Initialize Foggy**.
 ## Local beta installation
 
 ```powershell
-dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-beta.2.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-beta.3.tgz
 ```
 
 Restart `dsh web`, open Settings → Plugins → Foggy Data Analysis, and initialize

package/experience/linux/prepare.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 DSH_VERSION="0.1.1-rc.2"
 PNPM_VERSION="11.7.0"
-PLUGIN_VERSION="0.4.0-beta.2"
+PLUGIN_VERSION="0.4.0-beta.3"
 PLUGIN_REF="v${PLUGIN_VERSION}"
 PLUGIN_REPOSITORY="https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
 

package/lib/client.js

@@ -52,6 +52,15 @@ window.__ModuleLoader__.load({
       start: '启动 Runtime',
       stop: '停止 Runtime',
       working: '操作进行中…',
+      progressWorking: '正在初始化 Foggy…',
+      progressPreflight: '检查运行环境',
+      progressCli: '准备 CLI',
+      progressLauncher: '准备 Launcher',
+      progressAnalysis: '准备分析 Skill',
+      progressSkills: '安装工作区 Skills',
+      progressState: '写入安装状态',
+      progressComplete: '初始化完成',
+      progressFiles: '文件',
       accepted: '操作已开始；页面会自动刷新状态。',
       actionFailed: '操作失败',
       roots: '本地目录',
@@ -90,6 +99,15 @@ window.__ModuleLoader__.load({
       start: 'Start Runtime',
       stop: 'Stop Runtime',
       working: 'Operation in progress…',
+      progressWorking: 'Initializing Foggy…',
+      progressPreflight: 'Checking prerequisites',
+      progressCli: 'Preparing CLI',
+      progressLauncher: 'Preparing Launcher',
+      progressAnalysis: 'Preparing analysis Skill',
+      progressSkills: 'Installing workspace Skills',
+      progressState: 'Writing install state',
+      progressComplete: 'Initialization complete',
+      progressFiles: 'files',
       accepted: 'The operation started; this page will refresh automatically.',
       actionFailed: 'Operation failed',
       roots: 'Local directories',
@@ -110,6 +128,7 @@ window.__ModuleLoader__.load({
       .foggy-state{display:flex;align-items:center;gap:8px;font-size:14px;font-weight:600}.foggy-dot{width:9px;height:9px;border-radius:50%;background:var(--dsw-alias-label-tertiary)}.foggy-dot[data-state=ready],.foggy-dot[data-state=running]{background:var(--dsw-alias-state-success-primary)}.foggy-dot[data-state=degraded]{background:var(--dsw-alias-state-error-primary)}
       .foggy-actions{display:flex;gap:8px;flex-wrap:wrap}.foggy-button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:7px 12px;cursor:pointer}.foggy-button:hover{background:var(--dsw-alias-interactive-bg-hover)}.foggy-button:disabled{opacity:.55;cursor:not-allowed}.foggy-button-primary{border-color:var(--dsw-alias-state-business-primary);background:var(--dsw-alias-state-business-primary);color:white}
       .foggy-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.foggy-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;padding:13px 14px}.foggy-card-head{display:flex;justify-content:space-between;gap:8px}.foggy-card strong{font-size:13px}.foggy-badge{font-size:11px;color:var(--dsw-alias-label-secondary)}.foggy-card code{display:block;margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:11px;overflow-wrap:anywhere}
+      .foggy-progress{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;padding:13px 14px}.foggy-progress-head{display:flex;align-items:center;justify-content:space-between;gap:12px;font-size:13px}.foggy-progress-head strong{font-weight:600}.foggy-progress-percent{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums}.foggy-progress-track{height:8px;margin-top:10px;border-radius:999px;background:var(--dsw-alias-bg-layer-1);overflow:hidden}.foggy-progress-fill{height:100%;border-radius:inherit;background:var(--dsw-alias-state-business-primary);transition:width .25s ease}.foggy-progress-meta{display:flex;justify-content:space-between;gap:12px;margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}.foggy-progress-file{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
       .foggy-message{margin:0;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary)}.foggy-message[data-error=true]{color:var(--dsw-alias-state-error-primary)}.foggy-paths,.foggy-next{border-top:1px solid var(--dsw-alias-border-l2);padding-top:14px}.foggy-paths h4,.foggy-next h4{margin:0 0 8px;font-size:13px}.foggy-paths dl{display:grid;grid-template-columns:100px minmax(0,1fr);gap:6px 10px;margin:0}.foggy-paths dt{color:var(--dsw-alias-label-tertiary);font-size:12px}.foggy-paths dd{margin:0;min-width:0;overflow-wrap:anywhere;font-family:var(--ds-font-family-code);font-size:11px}.foggy-next p{margin:0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}
       @media (width<=680px){.foggy-grid{grid-template-columns:minmax(0,1fr)}}
     `
@@ -146,6 +165,52 @@ window.__ModuleLoader__.load({
       })
     }
 
+    function progressPanel(progress, t) {
+      if (!progress) return null
+      const percent = Math.max(0, Math.min(100, Number(progress.percent) || 0))
+      const phaseKeys = {
+        preflight: 'progressPreflight',
+        cli: 'progressCli',
+        launcher: 'progressLauncher',
+        'analysis-skill': 'progressAnalysis',
+        'workspace-skills': 'progressSkills',
+        state: 'progressState',
+        complete: 'progressComplete',
+      }
+      const phase = t(phaseKeys[progress.phase] || 'progressWorking')
+      const step = progress.step?.index && progress.step?.total
+        ? `${progress.step.index}/${progress.step.total}`
+        : ''
+      const files = progress.files?.total
+        ? `${progress.files.completed || 0}/${progress.files.total} ${t('progressFiles')}`
+        : ''
+      return jsxs('div', {
+        className: 'foggy-progress',
+        role: 'status',
+        'aria-live': 'polite',
+        children: [
+          jsxs('div', { className: 'foggy-progress-head', children: [
+            jsx('strong', { children: progress.message || phase }),
+            jsx('span', { className: 'foggy-progress-percent', children: `${percent}%` }),
+          ] }),
+          jsx('div', {
+            className: 'foggy-progress-track',
+            role: 'progressbar',
+            'aria-valuemin': 0,
+            'aria-valuemax': 100,
+            'aria-valuenow': percent,
+            'aria-label': phase,
+            children: jsx('div', { className: 'foggy-progress-fill', style: { width: `${percent}%` } }),
+          }),
+          jsxs('div', { className: 'foggy-progress-meta', children: [
+            jsx('span', { children: phase }),
+            jsx('span', { children: [step, files].filter(Boolean).join(' · ') }),
+          ] }),
+          progress.currentFile ? jsx('div', { className: 'foggy-progress-meta foggy-progress-file', title: progress.currentFile, children: progress.currentFile }) : null,
+        ],
+      })
+    }
+
     function FoggySettingsTab({ api, t }) {
       const [view, setView] = useState({ phase: 'loading', status: null, message: '', error: false })
 
@@ -188,6 +253,7 @@ window.__ModuleLoader__.load({
       const operationError = status.operation?.state === 'failed'
         ? status.operation.error || status.operation.result?.error?.message || t('actionFailed')
         : ''
+      const progress = busy ? progressPanel(status.operation?.progress, t) : null
       const stateLabels = { 'not-installed': 'notInstalled', degraded: 'degraded', ready: 'ready', running: 'running' }
       return jsxs('section', { className: 'foggy-settings', children: [
         jsxs('div', { className: 'foggy-hero', children: [
@@ -204,6 +270,7 @@ window.__ModuleLoader__.load({
             status.running ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('runtimeStop'), children: t('stop') }) : null,
           ] }),
         ] }),
+        progress,
         busy || operationError || view.message ? jsx('p', { className: 'foggy-message', 'data-error': operationError || view.error ? 'true' : undefined, children: busy ? t('working') : operationError || view.message }) : null,
         jsxs('div', { className: 'foggy-grid', children: [
           componentCard(t('python'), status.components.python, 'tool', t),

package/lib/index.js

@@ -46,6 +46,14 @@ async function readJson(path) {
   return JSON.parse(await readFile(path, 'utf8'))
 }
 
+async function readOptionalJson(path) {
+  try {
+    return await readJson(path)
+  } catch {
+    return null
+  }
+}
+
 async function commandVersion(command, args) {
   try {
     const { stdout, stderr } = await execFileAsync(command, args, {
@@ -123,6 +131,7 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
     const roots = defaultRoots()
     const statePath = join(roots.installRoot, 'install-state.json')
     const runtimeStatePath = join(roots.dataRoot, 'runtime-state.json')
+    const progressPath = join(roots.dataRoot, 'operation-progress.json')
     const manifest = await readJson(versionsFile)
     let pythonProbe
     try {
@@ -156,6 +165,22 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
     }
     const installed = components.cli.installed && components.launcher.installed && components.analysisSkill.installed
     const running = Boolean(runtime && processRunning(Number(runtime.pid)))
+    const progress = await readOptionalJson(progressPath)
+    let operation = operationView(this.operation)
+    if (operation.state === 'running' && progress?.operationId === operation.id) {
+      operation = { ...operation, progress }
+    } else if (!this.operation && progress?.state === 'running' && progress.operationId) {
+      operation = {
+        id: progress.operationId,
+        kind: progress.kind || 'initialize',
+        state: 'running',
+        startedAt: progress.startedAt || null,
+        finishedAt: null,
+        result: null,
+        error: null,
+        progress,
+      }
+    }
     return {
       success: true,
       packageVersion: manifest.packageVersion,
@@ -166,7 +191,7 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       roots,
       projectRoot: process.env.FOGGY_PROJECT_ROOT || process.cwd(),
       components,
-      operation: operationView(this.operation),
+      operation,
       next: installed ? (running ? 'configure-database' : 'start-runtime') : 'initialize',
     }
   }
@@ -211,6 +236,10 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
     }
     const id = `${Date.now()}-${Math.random().toString(16).slice(2, 10)}`
     const args = explicitArgs ?? ['install', '--project-root', process.env.FOGGY_PROJECT_ROOT || process.cwd()]
+    if (!explicitArgs) {
+      const roots = defaultRoots()
+      args.push('--progress-file', join(roots.dataRoot, 'operation-progress.json'), '--operation-id', id, '--operation-kind', kind)
+    }
     if (replaceSkill) args.push('--replace-skill')
     for (const cacheDir of (process.env.FOGGY_ASSET_CACHE_DIRS || '').split(delimiter).filter(Boolean)) {
       args.push('--asset-cache-dir', cacheDir)
@@ -223,6 +252,17 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
       finishedAt: null,
       result: null,
       error: null,
+      progress: !explicitArgs ? {
+        schemaVersion: 'foggy-deepseek-onboarding-progress/v1',
+        operationId: id,
+        kind,
+        state: 'running',
+        phase: 'preflight',
+        message: 'Starting Foggy initialization',
+        currentFile: null,
+        percent: 0,
+        step: { index: 1, total: 6 },
+      } : null,
       promise: null,
     }
     operation.promise = runOnboarding(args)
@@ -230,11 +270,27 @@ export class FoggyIntegrationGateway extends TypertRemoteService {
         operation.state = result.success === false ? 'failed' : 'succeeded'
         operation.result = result
         operation.finishedAt = new Date().toISOString()
+        if (operation.progress) {
+          operation.progress = {
+            ...operation.progress,
+            state: operation.state,
+            phase: operation.state === 'succeeded' ? 'complete' : operation.progress.phase,
+            message: operation.state === 'succeeded' ? 'Foggy initialization completed' : 'Foggy initialization failed',
+            percent: operation.state === 'succeeded' ? 100 : operation.progress.percent,
+          }
+        }
       })
       .catch((error) => {
         operation.state = 'failed'
         operation.error = String(error.message ?? error)
         operation.finishedAt = new Date().toISOString()
+        if (operation.progress) {
+          operation.progress = {
+            ...operation.progress,
+            state: 'failed',
+            message: 'Foggy initialization failed',
+          }
+        }
       })
     this.operation = operation
     return { success: true, accepted: true, operation: operationView(operation) }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.0-beta.2",
+  "version": "0.4.0-beta.3",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",

package/skills/foggy-deepseek-onboarding/assets/versions.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "foggy-deepseek-onboarding-versions/v1",
-  "packageVersion": "0.4.0-beta.2",
+  "packageVersion": "0.4.0-beta.3",
   "validatedAt": "2026-08-28",
   "components": {
     "deepseekHarness": {

package/skills/foggy-deepseek-onboarding/scripts/onboarding.py

@@ -38,6 +38,93 @@ class OnboardingError(RuntimeError):
     pass
 
 
+PROGRESS_SCHEMA = "foggy-deepseek-onboarding-progress/v1"
+ACTIVE_PROGRESS: "ProgressReporter | None" = None
+
+
+class ProgressReporter:
+    total_steps = 6
+
+    def __init__(self, path: str | None, operation_id: str | None, kind: str) -> None:
+        self.path = Path(path).expanduser() if path else None
+        self.operation_id = operation_id
+        self.kind = kind
+        self.started_at = now_utc()
+        self.phase = "preflight"
+        self.step_index = 0
+        self.fraction = 0.0
+        self.message = ""
+        self.current_file: str | None = None
+        self.completed_files: int | None = None
+        self.total_files: int | None = None
+
+    @property
+    def enabled(self) -> bool:
+        return self.path is not None
+
+    def _write(self, state: str, *, finished_at: str | None = None, error: str | None = None) -> None:
+        if not self.path:
+            return
+        bounded_step = max(0, min(self.step_index, self.total_steps))
+        bounded_fraction = max(0.0, min(float(self.fraction), 1.0))
+        percent = 100 if state == "succeeded" else round(((bounded_step + bounded_fraction) / self.total_steps) * 100)
+        payload = {
+            "schemaVersion": PROGRESS_SCHEMA,
+            "operationId": self.operation_id,
+            "kind": self.kind,
+            "state": state,
+            "phase": self.phase,
+            "message": self.message,
+            "currentFile": self.current_file,
+            "percent": percent,
+            "step": {"index": min(bounded_step + 1, self.total_steps), "total": self.total_steps},
+            "startedAt": self.started_at,
+            "updatedAt": now_utc(),
+        }
+        if self.completed_files is not None and self.total_files is not None:
+            payload["files"] = {"completed": self.completed_files, "total": self.total_files}
+        if finished_at:
+            payload["finishedAt"] = finished_at
+        if error:
+            payload["error"] = error
+        self.path.parent.mkdir(parents=True, exist_ok=True)
+        atomic_json(self.path, payload)
+
+    def update(
+        self,
+        phase: str,
+        step_index: int,
+        message: str,
+        *,
+        fraction: float = 0.0,
+        current_file: str | None = None,
+        completed_files: int | None = None,
+        total_files: int | None = None,
+    ) -> None:
+        self.phase = phase
+        self.step_index = step_index
+        self.fraction = fraction
+        self.message = message
+        self.current_file = current_file
+        self.completed_files = completed_files
+        self.total_files = total_files
+        self._write("running")
+
+    def finish(self) -> None:
+        self.phase = "complete"
+        self.step_index = self.total_steps
+        self.fraction = 0.0
+        self.message = "Foggy initialization completed"
+        self.current_file = None
+        self.completed_files = None
+        self.total_files = None
+        self._write("succeeded", finished_at=now_utc())
+
+    def fail(self, error: object) -> None:
+        self.message = "Foggy initialization failed"
+        self._write("failed", finished_at=now_utc(), error=str(error))
+
+
 def now_utc() -> str:
     return dt.datetime.now(dt.timezone.utc).isoformat()
 
@@ -182,7 +269,18 @@ def cached_asset(name: str, expected: str, cache_dirs: list[Path]) -> Path | Non
     return None
 
 
-def materialize(asset: dict, destination: Path, cache_dirs: list[Path]) -> dict:
+def materialize(
+    asset: dict,
+    destination: Path,
+    cache_dirs: list[Path],
+    *,
+    progress: ProgressReporter | None = None,
+    progress_phase: str = "",
+    progress_step: int = 0,
+    progress_index: int = 0,
+    progress_total: int = 1,
+    progress_message: str = "Downloading and verifying asset",
+) -> dict:
     destination.parent.mkdir(parents=True, exist_ok=True)
     if destination.is_file():
         verify_asset(destination, asset["sha256"])
@@ -196,7 +294,18 @@ def materialize(asset: dict, destination: Path, cache_dirs: list[Path]) -> dict:
         if temporary.exists():
             temporary.unlink()
         try:
-            urllib.request.urlretrieve(asset["url"], temporary)
+            def reporthook(block_count: int, block_size: int, total_size: int) -> None:
+                if progress is None or not progress_phase or total_size <= 0:
+                    return
+                downloaded = min(block_count * block_size, total_size)
+                fraction = (progress_index + downloaded / total_size) / max(progress_total, 1)
+                progress.update(
+                    progress_phase, progress_step, progress_message,
+                    fraction=fraction, current_file=asset["file"],
+                    completed_files=progress_index, total_files=progress_total,
+                )
+
+            urllib.request.urlretrieve(asset["url"], temporary, reporthook=reporthook)
             verify_asset(temporary, asset["sha256"])
             os.replace(temporary, destination)
         finally:
@@ -574,6 +683,7 @@ def java_probe() -> dict:
 
 
 def install_command(args: argparse.Namespace) -> dict:
+    global ACTIVE_PROGRESS
     versions = load_versions()
     install_root = normalized(args.install_root or default_install_root())
     data_root = normalized(args.data_root or default_data_root())
@@ -595,6 +705,13 @@ def install_command(args: argparse.Namespace) -> dict:
     }
     if args.dry_run:
         return {"success": True, "dryRun": True, "plan": plan}
+    progress = ProgressReporter(
+        getattr(args, "progress_file", None),
+        getattr(args, "operation_id", None),
+        getattr(args, "operation_kind", "initialize"),
+    )
+    ACTIVE_PROGRESS = progress
+    progress.update("preflight", 0, "Checking prerequisites")
     if sys.version_info < (3, 11):
         raise OnboardingError(f"Python 3.11+ required, got {sys.version.split()[0]}")
     if not project_root.is_dir():
@@ -605,20 +722,37 @@ def install_command(args: argparse.Namespace) -> dict:
     verified: list[dict] = []
 
     cli_component = components["cli"]
-    for role in ("wheel", "checksums"):
-        asset = cli_component[role]
-        verified.append(materialize(asset, downloads / "cli" / asset["file"], cache_dirs))
+    cli_assets = [cli_component[role] for role in ("wheel", "checksums")]
+    for index, asset in enumerate(cli_assets):
+        progress.update(
+            "cli", 1, "Downloading and verifying CLI",
+            fraction=index / len(cli_assets), current_file=asset["file"],
+            completed_files=index, total_files=len(cli_assets),
+        )
+        verified.append(materialize(
+            asset, downloads / "cli" / asset["file"], cache_dirs,
+            progress=progress, progress_phase="cli", progress_step=1,
+            progress_index=index, progress_total=len(cli_assets),
+            progress_message="Downloading and verifying CLI",
+        ))
+        progress.update(
+            "cli", 1, "Downloading and verifying CLI",
+            fraction=(index + 1) / len(cli_assets), current_file=asset["file"],
+            completed_files=index + 1, total_files=len(cli_assets),
+        )
     checksum_lines = (downloads / "cli" / cli_component["checksums"]["file"]).read_text(encoding="utf-8").splitlines()
     checksum_entries = {line.split(maxsplit=1)[1].strip(): line.split(maxsplit=1)[0].lower() for line in checksum_lines if len(line.split(maxsplit=1)) == 2}
     wheel_asset = cli_component["wheel"]
     if checksum_entries.get(wheel_asset["file"]) != wheel_asset["sha256"]:
         raise OnboardingError("Pinned CLI SHA256SUMS does not match the pinned wheel hash")
     if args.skip_cli_install:
+        progress.update("cli", 1, "Using existing CLI", fraction=0.65, current_file="foggy-runtime")
         cli_command = normalized(args.cli_command or shutil.which("foggy-runtime") or "")
         if not cli_command.is_file():
             raise OnboardingError("--skip-cli-install requires --cli-command or foggy-runtime on PATH")
         cli_mode = "external"
     else:
+        progress.update("cli", 1, "Installing CLI", fraction=0.65, current_file="Python virtual environment")
         python_path = venv_python(install_root)
         if not python_path.is_file():
             venv.EnvBuilder(with_pip=True).create(install_root / "venv")
@@ -633,27 +767,65 @@ def install_command(args: argparse.Namespace) -> dict:
         )
         cli_command = venv_cli(install_root)
         cli_mode = "managed-venv"
+    progress.update("cli", 1, "Verifying CLI version", fraction=0.9, current_file="foggy-runtime")
     cli_version = command_result([str(cli_command), "--version"], check=True)
     actual_cli_version = version_tuple(cli_version["stdout"])[:3]
     pinned_cli_version = version_tuple(cli_component["version"])[:3]
     version_matches = actual_cli_version >= pinned_cli_version if cli_mode == "external" else actual_cli_version == pinned_cli_version
     if not version_matches:
         raise OnboardingError(f"Unexpected CLI version: {cli_version['stdout']}")
+    progress.update("cli", 1, "CLI ready", fraction=1.0)
 
     launcher_dir = install_root / "launcher"
-    for asset in components["launcher"]["assets"]:
-        verified.append(materialize(asset, launcher_dir / asset["file"], cache_dirs))
+    launcher_assets = components["launcher"]["assets"]
+    for index, asset in enumerate(launcher_assets):
+        progress.update(
+            "launcher", 2, "Downloading and verifying Launcher",
+            fraction=index / len(launcher_assets), current_file=asset["file"],
+            completed_files=index, total_files=len(launcher_assets),
+        )
+        verified.append(materialize(
+            asset, launcher_dir / asset["file"], cache_dirs,
+            progress=progress, progress_phase="launcher", progress_step=2,
+            progress_index=index, progress_total=len(launcher_assets),
+            progress_message="Downloading and verifying Launcher",
+        ))
+        progress.update(
+            "launcher", 2, "Downloading and verifying Launcher",
+            fraction=(index + 1) / len(launcher_assets), current_file=asset["file"],
+            completed_files=index + 1, total_files=len(launcher_assets),
+        )
     if os.name != "nt":
         (launcher_dir / "start-foggy-runtime.sh").chmod(0o755)
+    progress.update("launcher", 2, "Launcher ready", fraction=1.0)
 
     analysis_assets = components["analysisSkill"]["assets"]
-    for asset in analysis_assets:
-        verified.append(materialize(asset, downloads / "skill" / asset["file"], cache_dirs))
+    for index, asset in enumerate(analysis_assets):
+        progress.update(
+            "analysis-skill", 3, "Downloading and verifying analysis Skill",
+            fraction=index / len(analysis_assets), current_file=asset["file"],
+            completed_files=index, total_files=len(analysis_assets),
+        )
+        verified.append(materialize(
+            asset, downloads / "skill" / asset["file"], cache_dirs,
+            progress=progress, progress_phase="analysis-skill", progress_step=3,
+            progress_index=index, progress_total=len(analysis_assets),
+            progress_message="Downloading and verifying analysis Skill",
+        ))
+        progress.update(
+            "analysis-skill", 3, "Downloading and verifying analysis Skill",
+            fraction=(index + 1) / len(analysis_assets), current_file=asset["file"],
+            completed_files=index + 1, total_files=len(analysis_assets),
+        )
     zip_asset = next(item for item in analysis_assets if item["role"] == "zip")
+    progress.update("analysis-skill", 3, "Installing analysis Skill", fraction=0.9, current_file=zip_asset["file"])
     analysis_skill = install_analysis_skill(
         downloads / "skill" / zip_asset["file"], project_root, components["analysisSkill"]["version"], zip_asset["sha256"], args.replace_skill
     )
+    progress.update("analysis-skill", 3, "Analysis Skill ready", fraction=1.0)
+    progress.update("workspace-skills", 4, "Installing onboarding Skill", fraction=0.1)
     onboarding_skill = install_onboarding_skill(project_root)
+    progress.update("workspace-skills", 4, "Workspace Skills ready", fraction=1.0)
     state = {
         "schemaVersion": STATE_SCHEMA,
         "installedAt": now_utc(),
@@ -668,7 +840,10 @@ def install_command(args: argparse.Namespace) -> dict:
         "securityMode": versions["defaults"]["securityMode"],
         "productionReady": False,
     }
+    progress.update("state", 5, "Writing install state", fraction=0.2, current_file="install-state.json")
     atomic_json(install_root / "install-state.json", state)
+    progress.finish()
+    ACTIVE_PROGRESS = None
     return {
         "success": True,
         "schemaVersion": "foggy-deepseek-onboarding-install-result/v1",
@@ -1945,6 +2120,9 @@ def build_parser() -> argparse.ArgumentParser:
     install.add_argument("--replace-skill", action="store_true")
     install.add_argument("--skip-cli-install", action="store_true")
     install.add_argument("--cli-command")
+    install.add_argument("--progress-file")
+    install.add_argument("--operation-id")
+    install.add_argument("--operation-kind", default="initialize")
     install.add_argument("--dry-run", action="store_true")
     install.set_defaults(handler=install_command)
 
@@ -2104,8 +2282,12 @@ def main() -> None:
             exit_code = 1
         emit(result, exit_code)
     except OnboardingError as exc:
+        if ACTIVE_PROGRESS is not None:
+            ACTIVE_PROGRESS.fail(exc)
         emit({"success": False, "error": {"code": "ONBOARDING_ERROR", "message": str(exc)}, "productionReady": False}, 1)
     except Exception as exc:
+        if ACTIVE_PROGRESS is not None:
+            ACTIVE_PROGRESS.fail(exc)
         emit({"success": False, "error": {"code": "UNEXPECTED_ERROR", "message": str(exc)}, "productionReady": False}, 1)