plastic-intent-locking

Solid

Inspect, repair, release, or reclaim an intent's delivery lock. Use when a lock-gate deny names /plastic-lock, when resuming interrupted work after a crash, reboot, or /tmp wipe, when a lock reads held or stale, or when the user says "fix the lock", "who holds the lock", or "reclaim the lock".

AI & Automation 9 stars 0 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
33
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Plastic Lock Command-only wrapper around `~/.plastic/scripts/plastic-lock`. The durable delivery lock is a `delivery.lock` file in the intent directory: ownership is session-keyed, liveness is a lease (the owner's hooks refresh the file mtime; stale means the heartbeat is older than the TTL). The /tmp bridge is only a cache; the lock file wins every disagreement. ## Verbs Run from the project (the intent resolves from this session's bridge), or pass `--intent-dir` explicitly: | Verb | What it does | When | |---|---|---| | `who` | Print a compact owner, heartbeat, claim, and delegate view from durable files only | Safe human inspection; requires `--intent-dir` | | `status` | Report the lock file, bridge cache, freshness, agreement | Always safe; run first | | `fix` | Idempotent repair: rebuild lock + bridge from disk truth for THIS session. Never touches a fresh foreign lock | Interrupted work, corrupted state, /tmp wiped, legacy pid locks | | `release` | Owner clears the lock | Ending or abandoning a boarding | | `reclaim` | Explicit takeover of a STALE lock; appends an audit line to savepoint.md | The owner is gone and the lease expired | | `delegate` | Owner registers a subagent session and optional provenance, or marks it `finished`/`failed` | Auto-mode orchestration | ``` ruby ~/.plastic/scripts/plastic-lock status ruby ~/.plastic/scripts/plastic-lock who --intent-dir <store>/<id>--<slug> ruby ~/.plastic/scripts/plastic-lock fix --intent-dir <store>/<id>--<slug> ru...

Details

Author
zalom
Repository
zalom/plastic
Created
2 months ago
Last Updated
1 weeks ago
Language
Ruby
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category