feat: add portable archive export and restore

.github/workflows/build-artifacts.yml

@@ -385,6 +385,9 @@ jobs:
             # Requested historical refs may predate the role smoke harness.
             build/cli-smoke-venv/bin/powercontext skill remote-sync --help
           fi
+          if [ -f src/powercontext/cli/archive.py ]; then
+            build/cli-smoke-venv/bin/powercontext archive --help
+          fi
 
           plugin_root="$BUNDLE_ROOT/integrations/plugins/powercontext"
           (

.github/workflows/master.yml

@@ -435,6 +435,13 @@ jobs:
         run: |
           Set-ItemProperty -LiteralPath 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled -Value 0
 
+      - name: Verify portable archive restoration and SQLite URI targets on Windows
+        run: >-
+          uv run --locked --no-sync pytest -q
+          tests/builtin/portability/test_bundle.py
+          tests/test_archive_cli.py
+          tests/e2e/test_portable_archive.py
+
       # Keep pytest's default temporary root: a short --basetemp would hide
       # regressions in the nested checkout fixtures covered by issue #1501.
       - name: Run Windows portability regressions

docs/en/docs/operate/index.md

@@ -12,6 +12,7 @@ Start with the operational task you need:
 | Keep a personal Server running, deploy a container, or enable authentication | [Deploy the Server](deploy-server.md) |
 | Understand unified database upgrades, backups, and service lifecycle | [Database migration design](database-migrations.md) |
 | Upgrade or switch background supervision mode | [Migrate Artifact processing state](artifact-processing-migration.md) |
+| Export a local SQLite archive or restore one | [Portable archive](portable-archive.md) |
 | Inspect logs, metrics, and traces | [Observability](observability.md) |
 | Send traces to an analysis service | [Phoenix](trace-with-phoenix.md), [Langfuse](trace-with-langfuse.md) |
 | Diagnose failures and restore service or data | [Troubleshoot](troubleshoot.md) |

docs/en/docs/operate/meta.json

@@ -6,6 +6,7 @@
     "connect-remote-server",
     "database-migrations",
     "artifact-processing-migration",
+    "portable-archive",
     "atomic-memory-migration",
     "observability",
     "trace-with-phoenix",

docs/en/docs/operate/troubleshoot.md

@@ -269,7 +269,7 @@ so the previous database remains available for recovery:
 
    ```bash
    obloader <connection-options> -D <new-database> --csv \
-      --table 'pc_scopes,pc_source_journal_heads,pc_sources,pc_artifacts,pc_source_cursors,pc_memory_source_windows,pc_artifact_processing_leases,pc_artifact_processing_binding_states,pc_artifact_processing_pending,pc_artifact_processing_auto_wave_targets,pc_artifact_processing_sequences,pc_artifact_processing_intents,pc_topic_memory_processing_targets,pc_artifact_processing_schema,pc_artifact_processing_migration_receipts,pc_topic_memory_work_budgets,pc_topic_memory_work_blocks,pc_topic_memory_retrieval_shape,pc_connector_checkpoints,pc_source_definition_manifests,pc_external_skill_registrations,pc_skill_packages,pc_agent_skill_targets,pc_skill_publications,pc_model_usage_daily,pc_recall_token_daily,pc_recall_effort_daily,pc_receipt_migration_review,pc_decision_observations,pc_lexical_projection_versions' \
+      --table 'pc_scopes,pc_source_journal_heads,pc_sources,pc_artifacts,pc_portable_restore_receipts,pc_source_cursors,pc_memory_source_windows,pc_artifact_processing_leases,pc_artifact_processing_binding_states,pc_artifact_processing_pending,pc_artifact_processing_auto_wave_targets,pc_artifact_processing_sequences,pc_artifact_processing_intents,pc_topic_memory_processing_targets,pc_artifact_processing_schema,pc_artifact_processing_migration_receipts,pc_topic_memory_work_budgets,pc_topic_memory_work_blocks,pc_topic_memory_retrieval_shape,pc_connector_checkpoints,pc_source_definition_manifests,pc_external_skill_registrations,pc_skill_packages,pc_agent_skill_targets,pc_skill_publications,pc_model_usage_daily,pc_recall_token_daily,pc_recall_effort_daily,pc_receipt_migration_review,pc_decision_observations,pc_lexical_projection_versions' \
      -f <export-directory>
    ```
 

docs/zh/docs/operate/index.md

@@ -12,6 +12,7 @@ description: 持续运行 Server，查找部署、监控与恢复步骤。
 | 持续运行个人 Server、部署容器或启用认证 | [部署 Server](deploy-server.md) |
 | 了解统一数据库升级、备份与服务启停设计 | [数据库迁移设计](database-migrations.md) |
 | 升级或切换后台监督模式 | [迁移 Artifact 处理状态](artifact-processing-migration.md) |
+| 导出本地 SQLite 归档或恢复归档 | [可移植归档](portable-archive.md) |
 | 查看日志、指标和 Trace | [可观测性](observability.md) |
 | 将 Trace 发送到分析服务 | [Phoenix](trace-with-phoenix.md)、[Langfuse](trace-with-langfuse.md) |
 | 诊断失败并恢复服务或数据 | [诊断与恢复](troubleshoot.md) |

docs/zh/docs/operate/meta.json

@@ -6,6 +6,7 @@
     "connect-remote-server",
     "database-migrations",
     "artifact-processing-migration",
+    "portable-archive",
     "atomic-memory-migration",
     "observability",
     "trace-with-phoenix",