@kingkyylian/handoffkit 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.4.0
+
+- Added `handoffkit cache list` and `handoffkit cache show` for inspecting local `.handoffkit` artifacts.
+- Added `handoffkit resume --from-cache latest` and cache refs such as `resume/latest` for continuing from cached resume sources.
+- Added `handoffkit pack --include-cache` to include recent cache summaries in handoff packets.
+- Added cache-backed handoff workflow documentation and an end-to-end example.
+
+## 0.3.0
+
+- Added richer deterministic risk notes that map changed file groups to common failure modes across release, CI, tooling, CLI, resume, report rendering, docs, security, and generated artifact workflows.
+- Raised release and package publishing changes to high-severity risk guidance with explicit `pnpm pack:dry-run` and `pnpm smoke:release` verification prompts.
+- Added transcript parsing for Codex, Claude, Cursor, and Gemini-style exported or copied agent sessions.
+- Added opt-in local `.handoffkit` cache artifacts for `verify --cache`, `resume --cache`, and `pack --verify --cache`.
+- Documented the `.handoffkit` cache layout and kept cache/checkpoint artifacts out of changed-file reports by default.
+
 ## 0.2.0
 
 - Added meaningful target-specific Markdown profiles for Codex, Claude Code, Cursor, and generic handoffs.

package/README.md

@@ -134,6 +134,7 @@ Omit diff summaries and patches:
 
 ```sh
 handoffkit pack --goal "Summarize repo state" --no-diff
+handoffkit pack --goal "Continue from recent cache" --include-cache
 ```
 
 Set a rough Markdown token budget:
@@ -146,6 +147,7 @@ Run verification directly:
 
 ```sh
 handoffkit verify
+handoffkit verify --cache
 ```
 
 Inspect deterministic risk notes:
@@ -164,6 +166,15 @@ Resume from a previous handoff or transcript:
 
 ```sh
 handoffkit resume previous-handoff.md --goal "Continue from here"
+handoffkit resume previous-handoff.md --goal "Continue from here" --cache
+handoffkit resume --from-cache latest --goal "Continue cached session"
+```
+
+Inspect local cache artifacts:
+
+```sh
+handoffkit cache list
+handoffkit cache show resume latest
 ```
 
 ## CLI Options
@@ -178,9 +189,18 @@ handoffkit resume previous-handoff.md --goal "Continue from here"
 | `--since <ref>` | Focus committed branch delta on a base ref such as `main`. |
 | `--verify` | Run safe verification scripts and include results in the packet. |
 | `--scan-secrets` | Run optional local secret scanners and include bounded redacted results. |
+| `--cache` | Explicitly write local verification or resume artifacts under `.handoffkit/`. |
+| `--include-cache` | Include recent `.handoffkit` artifact summaries in `pack` output. |
+| `--from-cache <ref>` | Resume from a cached resume artifact such as `latest` or `resume/latest`. |
 | `--include-diff` | Include full tracked patches and bounded untracked previews. |
 | `--no-diff` | Omit diff summaries and full patches. |
 
+## Local Cache
+
+Cache writes are opt-in. `verify --cache`, `pack --verify --cache`, and `resume --cache` write redacted JSON artifacts under `.handoffkit/verification` or `.handoffkit/resume`. Use `cache list` and `cache show` to inspect artifacts, `resume --from-cache latest` to continue from the latest cached resume source, and `pack --include-cache` to include recent cache summaries in a new handoff packet. The cache directory is ignored by default so repeated handoffs do not pollute git status or generated reports.
+
+See [docs/CACHE.md](docs/CACHE.md) for the file layout.
+
 ## What Gets Collected
 
 HandoffKit reads local git and filesystem metadata from the current repository:
@@ -191,6 +211,7 @@ HandoffKit reads local git and filesystem metadata from the current repository:
 - compact previews of detected instruction files
 - package manager and verification scripts from the root `package.json`
 - optional verification results when `--verify` is used
+- optional local cache summaries when `--include-cache` is used
 - deterministic risk notes from changed file paths
 - optional secret scanner availability, local config files, and install guidance for `gitleaks` and `secretlint`
 - bounded, redacted secret scan results when `--scan-secrets` is used
@@ -200,7 +221,7 @@ HandoffKit reads local git and filesystem metadata from the current repository:
 - No LLM API calls.
 - No network requests from the CLI.
 - No git writes, commits, staging, or branch changes.
-- No files are written unless `--output` is provided.
+- No files are written unless `--output` or explicit `--cache` is provided.
 
 ## Development