worklogs 0.2.0__tar.gz → 0.3.0__tar.gz

{worklogs-0.2.0 → worklogs-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: worklogs
-Version: 0.2.0
+Version: 0.3.0
 Summary: Local markdown worklog helpers for developer workflows.
 Project-URL: Homepage, https://github.com/alik-git/worklogs
 Project-URL: Repository, https://github.com/alik-git/worklogs
@@ -99,6 +99,41 @@ Print created paths for scripts:
 worklogs new note--personal-site--theme-ideas --scope personal --print-path
 ```
 
+Create a dated project workset directory:
+
+```bash
+worklogs workset new backend-api-refactor --worksets-root ~/worksets
+```
+
+Create a dated workset under organizer folders:
+
+```bash
+worklogs workset new release-tools/python-packaging/worklogs-0.2.1 \
+  --worksets-root ~/worksets
+```
+
+Worksets are created under:
+
+```text
+<worksets-root>/YYYY/MM/DD/<workset-path>/
+```
+
+Preview a workset path without creating it:
+
+```bash
+worklogs workset new release-tools/python-packaging/worklogs-0.2.1 \
+  --worksets-root ~/worksets \
+  --dry-run
+```
+
+Print only the created path for scripts:
+
+```bash
+worklogs workset new backend-api-refactor \
+  --worksets-root ~/worksets \
+  --print-path
+```
+
 Supported kinds:
 
 ```text
@@ -122,13 +157,14 @@ Example:
 root = "~/worklog"
 default_scope = "work"
 timezone = "America/Toronto"
+worksets_root = "~/worksets"
 ```
 
 Resolution order:
 
 1. CLI flags
 2. environment variables: `WORKLOG_ROOT`, `WORKLOG_SCOPE`,
-   `WORKLOG_TIMEZONE`
+   `WORKLOG_TIMEZONE`, `WORKLOG_WORKSETS_ROOT`
 3. config file
 4. package defaults
 
@@ -138,6 +174,12 @@ With `default_scope` configured, the fast path can omit `--scope`:
 worklogs new plan--backend-api--improve-deploy-notes
 ```
 
+With `worksets_root` configured, the workset path can omit `--worksets-root`:
+
+```bash
+worklogs workset new backend-api-refactor
+```
+
 For shorter personal shell usage, add a local alias:
 
 ```bash
@@ -196,9 +238,9 @@ Environment name: pypi
 Create a GitHub Release for the version in [`pyproject.toml`](pyproject.toml):
 
 ```bash
-gh release create v0.2.0 \
-  --title "v0.2.0" \
-  --notes "Add worklog file creation commands."
+gh release create v0.2.1 \
+  --title "v0.2.1" \
+  --notes "Add dated workset directory creation."
 ```
 
 Publishing is release-driven on purpose: normal pushes and pull requests build

{worklogs-0.2.0 → worklogs-0.3.0}/README.md

@@ -72,6 +72,41 @@ Print created paths for scripts:
 worklogs new note--personal-site--theme-ideas --scope personal --print-path
 ```
 
+Create a dated project workset directory:
+
+```bash
+worklogs workset new backend-api-refactor --worksets-root ~/worksets
+```
+
+Create a dated workset under organizer folders:
+
+```bash
+worklogs workset new release-tools/python-packaging/worklogs-0.2.1 \
+  --worksets-root ~/worksets
+```
+
+Worksets are created under:
+
+```text
+<worksets-root>/YYYY/MM/DD/<workset-path>/
+```
+
+Preview a workset path without creating it:
+
+```bash
+worklogs workset new release-tools/python-packaging/worklogs-0.2.1 \
+  --worksets-root ~/worksets \
+  --dry-run
+```
+
+Print only the created path for scripts:
+
+```bash
+worklogs workset new backend-api-refactor \
+  --worksets-root ~/worksets \
+  --print-path
+```
+
 Supported kinds:
 
 ```text
@@ -95,13 +130,14 @@ Example:
 root = "~/worklog"
 default_scope = "work"
 timezone = "America/Toronto"
+worksets_root = "~/worksets"
 ```
 
 Resolution order:
 
 1. CLI flags
 2. environment variables: `WORKLOG_ROOT`, `WORKLOG_SCOPE`,
-   `WORKLOG_TIMEZONE`
+   `WORKLOG_TIMEZONE`, `WORKLOG_WORKSETS_ROOT`
 3. config file
 4. package defaults
 
@@ -111,6 +147,12 @@ With `default_scope` configured, the fast path can omit `--scope`:
 worklogs new plan--backend-api--improve-deploy-notes
 ```
 
+With `worksets_root` configured, the workset path can omit `--worksets-root`:
+
+```bash
+worklogs workset new backend-api-refactor
+```
+
 For shorter personal shell usage, add a local alias:
 
 ```bash
@@ -169,9 +211,9 @@ Environment name: pypi
 Create a GitHub Release for the version in [`pyproject.toml`](pyproject.toml):
 
 ```bash
-gh release create v0.2.0 \
-  --title "v0.2.0" \
-  --notes "Add worklog file creation commands."
+gh release create v0.2.1 \
+  --title "v0.2.1" \
+  --notes "Add dated workset directory creation."
 ```
 
 Publishing is release-driven on purpose: normal pushes and pull requests build

{worklogs-0.2.0 → worklogs-0.3.0}/docs/api.md

@@ -9,5 +9,11 @@ Use `worklogs new` to create dated markdown worklog files:
 worklogs new plan--backend-api--improve-deploy-notes --scope work
 ```
 
+Use `worklogs workset new` to create dated project workset directories:
+
+```bash
+worklogs workset new backend-api-refactor --worksets-root ~/worksets
+```
+
 Public Python helpers will be documented here if the package grows a stable API
 outside the CLI.

{worklogs-0.2.0 → worklogs-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "worklogs"
-version = "0.2.0"
+version = "0.3.0"
 description = "Local markdown worklog helpers for developer workflows."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -146,3 +146,7 @@ disable_error_code = ["import-untyped"]
 # Make local and CI output easier to read and easier to suppress precisely.
 show_error_codes = true
 pretty = true
+
+[[tool.mypy.overrides]]
+module = "workset.*"
+ignore_missing_imports = true

{worklogs-0.2.0 → worklogs-0.3.0}/src/worklogs/__init__.py

@@ -2,6 +2,6 @@
 
 from __future__ import annotations
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 __all__ = ["__version__"]