{"_id":"@adainthelab/universal-ledger-cli","_rev":"4-72f7471870095b2a72a003612916ca73","name":"@adainthelab/universal-ledger-cli","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@adainthelab/universal-ledger-cli","version":"0.1.0","keywords":["cli","context","ledger","provenance","continuity"],"license":"MIT","_id":"@adainthelab/universal-ledger-cli@0.1.0","maintainers":[{"name":"adainthelab","email":"nontoxthicc@gmail.com"}],"homepage":"https://github.com/AdaInTheLab/universal-ledger#readme","bugs":{"url":"https://github.com/AdaInTheLab/universal-ledger/issues"},"bin":{"ulc":"bin/ulc.js"},"dist":{"shasum":"8e3299e346784827619b4d82ea1bbbda9482bd44","tarball":"https://registry.npmjs.org/@adainthelab/universal-ledger-cli/-/universal-ledger-cli-0.1.0.tgz","fileCount":3,"integrity":"sha512-FUP2W8UV/xOAXRhzHoo+Nwg7mK3mIUucag3b5cSpdVBuH2LTMnGhR/9t+j0PN5DNBEUe1oSumIIJY9eiujPrjw==","signatures":[{"sig":"MEQCIHqvpEh5rMa8oDigLsdBMwYa+LGRQZe7m0tcQ2HXIwzcAiA6hOMIXhL4B3RMNUFjlvopgytHZ4tcF9BDp2pXcLiYUQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23730},"type":"module","engines":{"node":">=18"},"gitHead":"f5e20ffb8357abbf528c9e4e8b23cdc42a451f96","_npmUser":{"name":"adainthelab","email":"nontoxthicc@gmail.com"},"repository":{"url":"git+https://github.com/AdaInTheLab/universal-ledger.git","type":"git"},"_npmVersion":"11.6.2","description":"Client-side context continuity tooling for stateless AI sessions.","directories":{},"_nodeVersion":"24.11.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/universal-ledger-cli_0.1.0_1767311530875_0.4952511494111005","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@adainthelab/universal-ledger-cli","version":"0.1.2","description":"Client-side context continuity tooling for stateless AI sessions.","type":"module","bin":{"ulc":"bin/ulc.js"},"repository":{"type":"git","url":"git+https://github.com/AdaInTheLab/universal-ledger.git"},"keywords":["cli","context","ledger","provenance","continuity"],"license":"MIT","engines":{"node":">=18"},"devDependencies":{"@types/node":"^25.0.3","typescript":"^5.9.3"},"scripts":{"build":"tsc"},"gitHead":"6ddd85ca5b852e42d5a1cb8defa9a48bbc34afb6","_id":"@adainthelab/universal-ledger-cli@0.1.2","bugs":{"url":"https://github.com/AdaInTheLab/universal-ledger/issues"},"homepage":"https://github.com/AdaInTheLab/universal-ledger#readme","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-D2ofTMSHWKpVF9aTDEix8+NDhLYLlQRArX3mlQ9Yx2pNnajDnuknykKUvMHVJ4ssDUyji1nhowmKSVk9SSPhlw==","shasum":"e924bf09ddfe9aea950caa6d5aa931c9eb1c137d","tarball":"https://registry.npmjs.org/@adainthelab/universal-ledger-cli/-/universal-ledger-cli-0.1.2.tgz","fileCount":17,"unpackedSize":37262,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDKTke189F/JqKfFYtJ8PgPdUM4BS8xvRUNDZlY1EpSbgIhAMkYr5MOkGyFydYtkS6q4Pjo/AfsINz+Y0Fu5Te93LzI"}]},"_npmUser":{"name":"adainthelab","email":"nontoxthicc@gmail.com"},"directories":{},"maintainers":[{"name":"adainthelab","email":"nontoxthicc@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/universal-ledger-cli_0.1.2_1768849913997_0.7476255974191484"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-01T23:52:10.785Z","modified":"2026-01-19T19:11:54.242Z","0.1.0":"2026-01-01T23:52:11.023Z","0.1.1":"2026-01-19T18:49:06.765Z","0.1.2":"2026-01-19T19:11:54.124Z"},"bugs":{"url":"https://github.com/AdaInTheLab/universal-ledger/issues"},"license":"MIT","homepage":"https://github.com/AdaInTheLab/universal-ledger#readme","keywords":["cli","context","ledger","provenance","continuity"],"repository":{"type":"git","url":"git+https://github.com/AdaInTheLab/universal-ledger.git"},"description":"Client-side context continuity tooling for stateless AI sessions.","maintainers":[{"name":"adainthelab","email":"nontoxthicc@gmail.com"}],"readme":"# Universal Ledger CLI (ULC)\r\n\r\n**Universal Ledger CLI (ULC)** is a small, intentional command‑line tool\r\nfor maintaining **context continuity** across otherwise stateless\r\ninteractions.\r\n\r\nIt does **not** attempt to store or restore AI memory.\\\r\nInstead, it gives *you* a clean, user‑owned way to re‑establish shared\r\ncontext at the start of any session.\r\n\r\nThink of it as a **portable preamble generator** backed by simple,\r\nhuman‑editable records.\r\n\r\n------------------------------------------------------------------------\r\n\r\n## What ULC Is (and Is Not)\r\n\r\n### ✅ What it *is*\r\n\r\n-   A **user‑owned ledger** of context records (plain JSON)\r\n-   A way to generate a **Pre‑Conversation Context Block (PCCB)** on\r\n    demand\r\n-   A notes‑like system for tracking intent, constraints, and state\r\n-   Offline‑first, deterministic, boring‑in‑a‑good‑way\r\n\r\n### 🚫 What it is *not*\r\n\r\n-   Persistent AI memory\r\n-   A bypass for safeguards\r\n-   A networked service\r\n-   A database or cloud product\r\n\r\nULC assumes the model is stateless and treats all context as **explicit\r\ninput**.\r\n\r\n------------------------------------------------------------------------\r\n\r\n## Installation (Local / Dev)\r\n\r\n``` bash\r\ngit clone https://github.com/AdaInTheLab/universal-ledger\r\ncd universal-ledger\r\nnpm install\r\nnpm link\r\n```\r\n\r\nThis installs the `ulc` command globally for your user.\r\n\r\n------------------------------------------------------------------------\r\n\r\n## Ledger Storage\r\n\r\nBy default, ledger entries are stored **outside your repo**:\r\n\r\n    ~/.ulc/ledger/\r\n\r\nEach entry is a single JSON file:\r\n\r\n    2026-01-01-TEST.json\r\n    2026-01-02-REAL.json\r\n    ...\r\n\r\nThis keeps: - personal context out of source control - ledgers usable\r\nacross projects - state fully user‑owned\r\n\r\nYou can override this with `--ledger-dir` if needed.\r\n\r\n------------------------------------------------------------------------\r\n\r\n## Core Commands\r\n\r\n### `ulc init`\r\n\r\nCreate a new ledger entry.\r\n\r\n``` bash\r\nulc init   --lid 2026-01-01-TEST   --project \"Universal Ledger CLI\"   --summary \"Context continuity across stateless AI sessions\"\r\n```\r\n\r\nOptional flags: - `--goal \"text\"` (repeatable) - `--constraint \"text\"`\r\n(repeatable) - `--force` (overwrite existing entry)\r\n\r\n------------------------------------------------------------------------\r\n\r\n### `ulc list`\r\n\r\nList known ledger entries.\r\n\r\n``` bash\r\nulc list\r\n```\r\n\r\nOutputs a readable summary of all entries in the ledger directory.\r\n\r\n------------------------------------------------------------------------\r\n\r\n### `ulc update`\r\n\r\nPatch an existing ledger entry in place.\r\n\r\n``` bash\r\nulc update   --lid 2026-01-01-TEST   --add-goal \"Restore collaboration context deterministically\"   --remove-goal \"TODO\"   --add-note \"Refined MVP scope\"\r\n```\r\n\r\nNotes: - Only fields you specify are changed - Unknown fields are\r\npreserved - Notes are append‑only (with dedupe protection) - Updates\r\nbump `last_state.as_of` and `modified_at`\r\n\r\n------------------------------------------------------------------------\r\n\r\n### `ulc wake`\r\n\r\nEmit a **Pre‑Conversation Context Block (PCCB)**.\r\n\r\n``` bash\r\nulc wake --lid 2026-01-01-TEST\r\n```\r\n\r\nThis prints a structured context block suitable for pasting directly\r\ninto a new session.\r\n\r\n#### Soft validation\r\n\r\n-   Missing required fields → error\r\n-   Incomplete or placeholder content → warnings\r\n-   Output is never blocked unless correctness is compromised\r\n\r\n------------------------------------------------------------------------\r\n\r\n## Example Output\r\n\r\n    [CONTEXT_BLOCK_START]\r\n    Source: Universal Ledger CLI v0.1.1\r\n    Ledger ID: 2026-01-01-TEST\r\n    Project: Universal Ledger CLI\r\n\r\n    Summary:\r\n    - Context continuity across stateless AI sessions\r\n\r\n    Goals:\r\n    - Restore collaboration context deterministically\r\n    - Make resets observable\r\n\r\n    Constraints:\r\n    - No claims of persistent AI memory\r\n    - No bypassing safeguards\r\n\r\n    Last Known State:\r\n    - As of: 2026-01-01T18:08:55\r\n    - Refined MVP scope\r\n    [CONTEXT_BLOCK_END]\r\n\r\n------------------------------------------------------------------------\r\n\r\n## Design Principles\r\n\r\n-   **Explicit over implicit**\r\n-   **Files over databases**\r\n-   **Warnings over enforcement**\r\n-   **User agency first**\r\n-   **No metaphysical claims**\r\n\r\nULC is intentionally small. If something feels magical, it's probably\r\nwrong.\r\n\r\n------------------------------------------------------------------------\r\n\r\n## Versioning\r\n\r\nCurrent version: **v0.1.1**\r\n\r\nThe CLI surface is intentionally conservative.\\\r\nBreaking changes should be rare and explicit.\r\n\r\n------------------------------------------------------------------------\r\n\r\n## License\r\n\r\nMIT\r\n\r\nYou own your data. Always.\r\n","readmeFilename":"README.md"}