omp-worklog 0.14.3 → 0.14.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0cd822ff3347278ac769f7b0c1d7e672aa32398fc585fac7daee8a2c40d98fa
-  data.tar.gz: 03c08ef8472c91a41bab12dd9131a5ae274884959693dec684206afcb94a17c8
+  metadata.gz: e13d4863a853283acc2fbefdd433c6fa6dd38e5180f483fe647a29067621dfab
+  data.tar.gz: bdb0edda46245581f6ee7e68c71f3bac263eb6f78996f8dd3ccca7d135985f2a
 SHA512:
-  metadata.gz: 8927b5a1844e245daf5643f2c0e65eca8e591ecc8e406df43c5eb2e215c9e65d4a1c9fec7a1353609a20be9d03e105175855e4ccc405670bd3850ff14ac048be
-  data.tar.gz: 56cf4e87faa0936b4178d5a1a530c0e3d7fb57e467737a0757927f56fc5ac947a01514b34fa4a92063825bc6c6338883807fe08ccc4ba55910f036cc0e37c3a0
+  metadata.gz: e74327cb9ef7e26c41f34bbc4ffa59d6727373694885a527202d87b0bb2ed2bb36b09767f19d1069856a64770508d91d0430239a9fd9d3568e0ad2f875bdd62c
+  data.tar.gz: f1b50e45029fc37e59801742120a24608f413c2f78f7ae63a6526774692a6038f4479a05be2514a09165444e480bea34a1d31aa5e1e4f189b10ebab0faade03b

data/README.md

@@ -81,11 +81,15 @@ Type `/worklog ` in OMP to discover `timesheet`; date aliases appear after selec
 
 ## OMP settings
 
+The manifest declares the following settings. **Persisted settings are currently inactive in the extension**: OMP does not expose resolved user-plus-project plugin settings at factory initialization. Explicit factory options work for programmatic callers and tests. [Issue #134](https://github.com/klondikemarlen/omp-worklog/issues/134) tracks the host dependency; do not assume a successful `omp plugin config set` changed runtime behavior.
+
 - `defaultHours`: hours per business day when a time-off tool call omits `hours`; defaults to `7`.
 - `holidayRegions`: comma-separated Holidays regions; defaults to `ca_yt`.
 - `command`: direct path to the `omp-worklog` executable.
 - `projectTimeLogPath`: optional path to Project Time v1 evidence; defaults to `~/.omp/project-time/time-log.sqlite`. A legacy versioned JSON snapshot is also supported.
+- `projectTimeMappings`: optional JSON mapping of exact local projects to Harvest project/task names; defaults to `{}`.
 
+The host stores user plugin settings in `~/.omp/plugins/omp-plugins.lock.json` and project overrides in `.omp/plugin-overrides.json`. Back up private configuration outside Git before uninstalling/reinstalling a plugin. Worklog deliberately does not parse these files itself or bypass project precedence.
 
 ## OMP Project Time integration
 
@@ -101,6 +105,10 @@ OMP Worklog reads Project Time's persisted `omp-project-time/evidence` v1 entrie
 
 `omp_worklog_preview_project_time_drafts` produces deterministic, copyable Date/Project/Task/Duration blocks from all local `human_active` evidence in an inclusive date range. Mapped evidence uses its configured Harvest destination; unmapped, ambiguous, and unassigned evidence remains an explicit local-project draft. It preserves source entry IDs, intervals, source kind, repository identity, narratives, work items, and task-attribution provenance. Generated narratives are review evidence, never task identity or a factual Harvest note. The tool reads the local log only; it never calls or mutates Harvest.
 
+Drafts preserve every positive interval using raw milliseconds, even when rounded decimal `hours` are zero. Exact displayed duration is review evidence, not a Harvest rounding or billable-time policy. Both range endpoints must be real calendar dates.
+
+For independent comparison with manually recorded Harvest entries, follow the [private calibration workflow](/docs/calibration.md). Do not tune from incomplete baselines or commit personal evidence.
+
 ### Activity transforms
 
 `omp_worklog_preview_project_time_transforms` emits deterministic JSON for local raw intervals. It accepts an inclusive date range and optional exact `repositoryId`, `project`, and `sourceKind` filters; each matching interval is split by local date and grouped by activity, with missing labels reported as `unlabelled`. It defaults to `human_active` and returns the effective top-level `sourceKind`; selecting `agent_turn_elapsed` requires an explicit source-kind request. Set `applyMappings` to create configured Harvest destinations or review-required local destinations for every included group. The output reports groups and draft entries; it never writes Harvest.
@@ -109,7 +117,21 @@ OMP Worklog reads Project Time's persisted `omp-project-time/evidence` v1 entrie
 
 ## Migration from Harvest Worklog
 
-Version `0.14.0` is a clean identity cutover. Uninstall the retired `harvest-worklog` gem and OMP plugin, then install `omp-worklog`; replace former `harvest-worklog` CLI and `/harvest-worklog` command invocations with `omp-worklog` and `/worklog`. The retired package, executable, command, tools, module, and settings aliases are not retained.
+Version `0.14.0` is a clean identity cutover. Uninstall the retired `harvest-worklog` gem and OMP plugin, then install `omp-worklog`; replace former `harvest-worklog` CLI and `/harvest-worklog` command invocations with `omp-worklog` and `/omp-worklog`. The retired package, executable, command, tools, module, and settings aliases are not retained.
+
+Version `0.14.3` renames the OMP slash command from `/omp-worklog` to `/worklog`; the `omp-worklog` package identity and CLI executable are unchanged.
+
+## Changes in 0.14.5
+
+- Preserve saved user settings across the required clean plugin reinstall, without copying project overrides or manifest defaults into user configuration.
+- Retain an owner-only recovery snapshot and report its path; abort before uninstalling when settings cannot be exported.
+
+## Changes in 0.14.4
+
+- Preserve short positive durations in mapped and review-required drafts.
+- Refresh project-name completion when SQLite commits evidence through its write-ahead log.
+- Reject impossible calendar dates in transform ranges.
+- Document configuration activation limits, runtime ownership, and private calibration.
 
 ## Release
 
@@ -118,20 +140,19 @@ Before merging a release PR, self-review its complete diff, address every action
 ```bash
 ruby test_omp_worklog.rb
 npm run test:omp
-omp-worklog time-off 2026-08-17 2026-08-28 \
-  --project 'Time Off - Marlen' \
-  --task 'Vacation / PTO' \
-  --holiday-region ca_yt \
-  --dry-run
+bin/omp-worklog --help
 VERSION="$(ruby -Ilib -romp_worklog/version -e 'puts OmpWorklog::VERSION')"
 gem build omp-worklog.gemspec
 gem push "omp-worklog-${VERSION}.gem"
-gem uninstall harvest-worklog --all --executables --ignore-dependencies
+gem uninstall omp-worklog --all --executables --ignore-dependencies
 gem install --clear-sources --source https://rubygems.org omp-worklog --version "$VERSION" --no-document
-omp plugin uninstall harvest-worklog
 npm run release
 npm run verify:release
 omp-worklog --help
 ```
 
-`npm run release` owns the uninstall/force-install mutation. `npm run verify:release` never changes the installation: it checks the installed package version, resolved Git revision, and plugin path before running a deterministic slash-command smoke test against the installed plugin. It exits after verification. Existing OMP sessions retain startup-loaded extension code; restart them before optional manual autocomplete and slash-command QA.
+`npm run release` owns the plugin uninstall/force-install mutation, including removal of the retired plugin when present. `npm run verify:release` never changes the installation: it checks the installed package version, resolved Git revision, and plugin path, then runs the installed JavaScript test suite. It exits after verification; tests alone do not exercise a fresh OMP host.
+
+The release wrapper exports explicit user settings through OMP's configuration CLI from an isolated temporary directory before uninstalling. It saves `settings.json` in an owner-only recovery directory, prints that path without values, restores settings through the CLI, and verifies equality after installation. Project overrides remain project-scoped; unset defaults stay unset. Keep the reported backup until the release is confirmed. If installation or restoration fails, recover from that private snapshot after resolving the reported phase; do not paste its contents into an issue.
+
+After installation, start a new OMP process and exercise `/worklog` completion and a timesheet against synthetic local evidence. Verify that a newly committed SQLite project appears without restarting that process. Existing sessions retain startup-loaded extension code and cannot prove the released artifact. Use explicit factory options for a mapped smoke until #134 is resolved; do not claim persisted-setting activation from that smoke.

data/bin/release-plugin

@@ -1,19 +1,68 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-installed_plugin() {
-  omp plugin list --json | node -e '
-    const plugins = JSON.parse(require("fs").readFileSync(0, "utf8")).npm ?? []
-    process.exit(plugins.some(plugin => plugin.name === process.argv[1]) ? 0 : 1)
-  ' "$1"
+#!/usr/bin/env node
+import { execFileSync } from "node:child_process"
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+import { isDeepStrictEqual } from "node:util"
+
+// The CLI resolves settings against cwd; an isolated directory excludes project overrides.
+const directory = mkdtempSync(join(tmpdir(), "omp-worklog-release-"))
+let phase = "listing installed plugins"
+let snapshotPath
+
+function run(description, args) {
+  phase = description
+  return execFileSync("omp", args, {
+    cwd: directory,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+  })
 }
 
-if installed_plugin omp-worklog; then
-  omp plugin uninstall omp-worklog
-fi
+function userSettings() {
+  const { settings } = JSON.parse(run("exporting user settings", ["plugin", "config", "list", "omp-worklog", "--json"]))
+  if (!settings || typeof settings !== "object" || Array.isArray(settings)) {
+    throw new Error("Invalid settings export")
+  }
+
+  return settings
+}
 
-if installed_plugin harvest-worklog; then
-  omp plugin uninstall harvest-worklog
-fi
+try {
+  const plugins = JSON.parse(run("listing installed plugins", ["plugin", "list", "--json"])).npm ?? []
+  const installed = new Set(plugins.map(plugin => plugin.name))
+  let settings
+  if (installed.has("omp-worklog")) {
+    settings = userSettings()
+    const backupPath = join(directory, "settings.json")
+    phase = "saving the private settings snapshot"
+    writeFileSync(backupPath, JSON.stringify(settings), { mode: 0o600, flag: "wx" })
+    snapshotPath = backupPath
+    console.log(`Saved private Worklog settings backup: ${snapshotPath}`)
+    run("uninstalling omp-worklog", ["plugin", "uninstall", "omp-worklog"])
+  }
 
-omp plugin install --force github:klondikemarlen/omp-worklog
+  if (installed.has("harvest-worklog")) {
+    run("uninstalling harvest-worklog", ["plugin", "uninstall", "harvest-worklog"])
+  }
+
+  run("installing omp-worklog", ["plugin", "install", "--force", "github:klondikemarlen/omp-worklog"])
+  if (settings) {
+    for (const [key, value] of Object.entries(settings)) {
+      const argument = typeof value === "string" ? value : JSON.stringify(value)
+      run("restoring user settings", ["plugin", "config", "set", "omp-worklog", key, argument])
+    }
+    if (!isDeepStrictEqual(userSettings(), settings)) {
+      phase = "verifying restored user settings"
+      throw new Error("Settings changed")
+    }
+  }
+
+  console.log("Installed omp-worklog; user settings preserved.")
+} catch {
+  console.error(`Worklog release failed while ${phase}.`)
+  if (snapshotPath) console.error(`Recover saved user settings from ${snapshotPath}.`)
+  process.exitCode = 1
+} finally {
+  if (!snapshotPath) rmSync(directory, { recursive: true, force: true })
+}

data/lib/omp_worklog/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OmpWorklog
-  VERSION = "0.14.3"
+  VERSION = "0.14.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: omp-worklog
 version: !ruby/object:Gem::Version
-  version: 0.14.3
+  version: 0.14.5
 platform: ruby
 authors:
 - Marlen Brunner
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-06 00:00:00.000000000 Z
+date: 2026-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: marlens-harvest-api-v2