{"_id":"@arcridge/sundial","_rev":"7-27f583a5774fb73d87752233a3207bcc","name":"@arcridge/sundial","dist-tags":{"latest":"0.8.0"},"versions":{"0.0.1":{"name":"@arcridge/sundial","version":"0.0.1","keywords":["sundial","decision-records","cli","ai","agents"],"author":{"name":"arcridge"},"license":"Apache-2.0","_id":"@arcridge/sundial@0.0.1","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"bin":{"sundial":"dist/main.js"},"dist":{"shasum":"93e7c98a884d07492dc8e21ae92cbead6df00f83","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.0.1.tgz","fileCount":12,"integrity":"sha512-UCMF7TO6HPLy6dXyp0kQYroivqi9DgXOct0U+wb46dXPFvkc8TcovnrSLBtsGLfOV2eZy3YdUDdfSE+wprsMwA==","signatures":[{"sig":"MEYCIQCD50yKOyYefL25SvL8VznkGc/5M7hzYdcqaFVZ28rtrQIhAIDlBJqFjr8wqXqrTvovSL6lUxOrODhEATcVY+gDhWyc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":170204},"main":"dist/main.js","engines":{"node":">=20"},"gitHead":"6ece36a961f2c86e36bc7f39d4f6412491708238","scripts":{"cli":"node dist/main.js","compile":"npm run check-types && node esbuild.js","prepack":"npm run compile","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","check-types":"tsc --noEmit","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out"},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"repository":{"url":"git+https://github.com/bjackson-arcridge/sundial.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.12.1","description":"Sundial project-local CLI and Decision Record store logic.","directories":{},"_nodeVersion":"25.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sundial_0.0.1_1778414724564_0.9268120463534408","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@arcridge/sundial","version":"0.1.0","keywords":["sundial","decision-records","cli","ai","agents"],"author":{"name":"arcridge"},"license":"Apache-2.0","_id":"@arcridge/sundial@0.1.0","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"bin":{"sundial":"dist/main.js"},"dist":{"shasum":"29e672a7108d16fe9b780d73458119427f6f7d18","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.1.0.tgz","fileCount":12,"integrity":"sha512-NJYL/xGutlJlJ8OtpMYehpStN641thJ9CtBCMKOxncOy8uh5YftBpLYJu4uE837AHa0gmbIpb3G4xNI07b9kNA==","signatures":[{"sig":"MEUCIAHx+VrxSb0sofAKtdzNYbc7o9W++jMUvAE/mYoBB6OhAiEAi7aqj2YBGp0QgyqCdj9UgTGVF7Rhqv4xLEsL65Zssp4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157344},"main":"dist/main.js","engines":{"node":">=20"},"gitHead":"f85e71fea0cb0c929487f0f13c04d5445240a779","scripts":{"cli":"node dist/main.js","compile":"npm run check-types && node esbuild.js","prepack":"npm run compile","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","check-types":"tsc --noEmit","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out"},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"repository":{"url":"git+https://github.com/bjackson-arcridge/sundial.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.12.1","description":"Sundial project-local CLI and Decision Record store logic.","directories":{},"_nodeVersion":"25.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sundial_0.1.0_1779146515061_0.4463274255585732","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@arcridge/sundial","version":"0.1.1","keywords":["sundial","decision-records","cli","ai","agents"],"author":{"name":"arcridge"},"license":"Apache-2.0","_id":"@arcridge/sundial@0.1.1","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"bin":{"sundial":"dist/main.js"},"dist":{"shasum":"386da5791a62331d5fb4938bde5af4b7c3c310e4","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.1.1.tgz","fileCount":12,"integrity":"sha512-DdlVfO5yyNANQMpydHfBTiHNrgt4/S2XwMo24Fz05Ua0g5BER5pbUuqeXbvDituxneWuc+KIC7uN9q/SID5o2Q==","signatures":[{"sig":"MEUCIQC0ou7wUjK1RQ/ojQdI/BQUJ1bJ9nw4O5gTfDGm68NxHgIgcMlAQCZdscd7LT6feOzS5PCcTxyjsl1HnfxUBjPH1T0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":162216},"main":"dist/main.js","engines":{"node":">=20"},"gitHead":"fb70899488fa97cbf2540c7dfda9dc498ea19e62","scripts":{"cli":"node dist/main.js","compile":"npm run check-types && node esbuild.js","prepack":"npm run compile","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","check-types":"tsc --noEmit","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out"},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"repository":{"url":"git+https://github.com/bjackson-arcridge/sundial.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.12.1","description":"Sundial project-local CLI and Decision Record store logic.","directories":{},"_nodeVersion":"25.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sundial_0.1.1_1779286396990_0.7908562177641325","host":"s3://npm-registry-packages-npm-production"}},"0.1.12":{"name":"@arcridge/sundial","version":"0.1.12","keywords":["sundial","decision-records","cli","ai","agents"],"author":{"name":"arcridge"},"license":"Apache-2.0","_id":"@arcridge/sundial@0.1.12","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"bin":{"sundial":"dist/main.js"},"dist":{"shasum":"fce9fd447bd81275e91a1a67c04f629e75b7dfd8","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.1.12.tgz","fileCount":15,"integrity":"sha512-Gvhe01IpHLykN2p1OEaUg27+YxKi5qeJxA2uy3yk0eFYSDFYP20/p/sLMTEgylDBz4ecEFnJb2HAfl3v6aBfHw==","signatures":[{"sig":"MEYCIQDiVGaG2wiFB3GuVyLb3AtX+NkJD81aIIGy8bEdtJzdOwIhAKoVYzJ/smVOA900vznF6sygMt1vys3yPJyjcs1P1jyE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":218513},"main":"dist/main.js","engines":{"node":">=20"},"gitHead":"c37ec1b05e03204de8c659bca186c92b36d2362c","scripts":{"cli":"node dist/main.js","compile":"npm run check-types && node esbuild.js","prepack":"npm run compile","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","check-types":"tsc --noEmit","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out"},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"repository":{"url":"git+https://github.com/bjackson-arcridge/sundial.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.12.1","description":"Sundial project-local CLI and Decision Record store logic.","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sundial_0.1.12_1783465362136_0.9634888276363447","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@arcridge/sundial","version":"0.3.0","keywords":["sundial","decision-records","cli","ai","agents"],"author":{"name":"arcridge"},"license":"Apache-2.0","_id":"@arcridge/sundial@0.3.0","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"bin":{"sundial":"dist/main.js"},"dist":{"shasum":"b6c875d3f72a4752cc3a07bbbf358d1c41c24a11","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.3.0.tgz","fileCount":19,"integrity":"sha512-5GEtebtX9KkU1JX3NVOklCHrlFuyYUbmkEoSFCWpOsUR6mwsLm6qYlgkRsK5GhulOP860AF7IXAbX34e+PIiRw==","signatures":[{"sig":"MEUCIAtzurl7aydeBXEGNFlpeqpkteUmnvNl4Thy2lqbqA6eAiEAhJ0nb0vOaemQB4DjFSfufgHAOGt6+stxiOR12A/2fAM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":236906},"main":"dist/main.js","engines":{"node":">=20"},"gitHead":"8bc305249996678f837e7546ee624c8b30f66463","scripts":{"cli":"node dist/main.js","compile":"npm run check-types && node esbuild.js","prepack":"npm run compile","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","check-types":"tsc --noEmit","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out"},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"repository":{"url":"git+https://github.com/bjackson-arcridge/sundial.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.12.1","description":"Sundial project-local CLI and Decision Record store logic.","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sundial_0.3.0_1784244115477_0.10756719074790655","host":"s3://npm-registry-packages-npm-production"}},"0.7.2":{"name":"@arcridge/sundial","version":"0.7.2","keywords":["sundial","decision-records","cli","ai","agents"],"author":{"name":"arcridge"},"license":"Apache-2.0","_id":"@arcridge/sundial@0.7.2","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"bin":{"sundial":"dist/main.js"},"dist":{"shasum":"c8c3ebb79b2dde12973743641bcb507870441eef","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.7.2.tgz","fileCount":20,"integrity":"sha512-beXByOy6X7ZGR5V8Ko7hJUNYSq5AsgfjkXaeLwMX9MJrMiHS55UxKaSx7jj5oSOfuopZYJSSWit3i8rNmy77uA==","signatures":[{"sig":"MEYCIQDeeVIPteTAUstjIf7yH8YEnbXfghIWDoepwvZJ6vE36QIhANxZphSFTKNVJIUGXzd+2oKyll9sIe8glyO1Wq9hslDL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":274544},"main":"dist/main.js","engines":{"node":">=20"},"gitHead":"4705560e65ae3ad9bf18c7de044966f62264c8e4","scripts":{"cli":"node dist/main.js","compile":"npm run check-types && node esbuild.js","prepack":"npm run compile","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","check-types":"tsc --noEmit","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out"},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"repository":{"url":"git+https://github.com/bjackson-arcridge/sundial.git","type":"git","directory":"packages/cli"},"_npmVersion":"11.12.1","description":"Sundial project-local CLI and Decision Record store logic.","directories":{},"_nodeVersion":"26.0.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sundial_0.7.2_1785102402846_0.01653123066571549","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@arcridge/sundial","version":"0.8.0","description":"Sundial project-local CLI and Decision Record store logic.","license":"Apache-2.0","author":{"name":"arcridge"},"homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"repository":{"type":"git","url":"git+https://github.com/bjackson-arcridge/sundial.git","directory":"packages/cli"},"keywords":["sundial","decision-records","cli","ai","agents"],"engines":{"node":">=20"},"main":"dist/main.js","bin":{"sundial":"dist/main.js"},"publishConfig":{"access":"public"},"scripts":{"prepack":"npm run compile","check-types":"tsc --noEmit","compile":"npm run check-types && node esbuild.js","compile-tests":"node -e \"require('node:fs').rmSync('out', { recursive: true, force: true })\" && tsc -p . --outDir out","test:unit":"npm run compile-tests && node --test out/unit/*.test.js","cli":"node dist/main.js"},"gitHead":"f04a6e67e78b21a1b903e0edcadc61fcba6ea04b","_id":"@arcridge/sundial@0.8.0","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-9zzR0AcaTu7qf/JrkupjEogaEKEieCNlGIbEdDb7Z6Q8fOf2zQUxn/YYWI0avynoW/Wm9cVZD/nqtqUa2Jx3DQ==","shasum":"05dfe1efc18b6eba9152cc23f0b5d5d420c0d02c","tarball":"https://registry.npmjs.org/@arcridge/sundial/-/sundial-0.8.0.tgz","fileCount":20,"unpackedSize":292830,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD4XqSm5miyiTp1RfctzLdGkhMTn6T1V2d1NsjqHHj1ugIhAMuEaVqPVXcHg0Ika6kHBBfMF/UD9O8FiLJ3Wc1ENikq"}]},"_npmUser":{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"},"directories":{},"maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sundial_0.8.0_1785110565568_0.09071506670546214"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-10T12:05:24.434Z","modified":"2026-07-27T00:02:45.891Z","0.0.1":"2026-05-10T12:05:24.750Z","0.1.0":"2026-05-18T23:21:55.224Z","0.1.1":"2026-05-20T14:13:17.133Z","0.1.12":"2026-07-07T23:02:42.265Z","0.3.0":"2026-07-16T23:21:55.613Z","0.7.2":"2026-07-26T21:46:42.985Z","0.8.0":"2026-07-27T00:02:45.728Z"},"bugs":{"url":"https://github.com/bjackson-arcridge/sundial/issues"},"author":{"name":"arcridge"},"license":"Apache-2.0","homepage":"https://github.com/bjackson-arcridge/sundial/tree/main/packages/cli#readme","keywords":["sundial","decision-records","cli","ai","agents"],"repository":{"type":"git","url":"git+https://github.com/bjackson-arcridge/sundial.git","directory":"packages/cli"},"description":"Sundial project-local CLI and Decision Record store logic.","maintainers":[{"name":"arcridgeu","email":"bjackson@arcridgelabs.com"}],"readme":"# sundial\n\nDecision-aware coding autonomy for staff-engineer-supervised AI work. Sundial turns engineer judgment into reusable agent context by storing accepted decisions as plain markdown **Decision Records (DRs)** inside your project.\n\nWhen an agent encounters a consequential choice without precedent, it writes a **candidate DR** instead of silently inventing a new rule. You review candidates in a file-backed Candidate Inbox (or in the companion VS Code extension), accept or reject them, and retire older DRs as they age out. Accepted DRs become durable project memory that the next agent run consults before designing or coding.\n\n- Open source, file-backed, no vendor lock-in\n- One-line install\n- Works with Claude Code and Codex CLI off the shelf\n- Companion VS Code extension for the Candidate Inbox\n\n## Install\n\n```bash\nnpm install -g @arcridge/sundial\n```\n\nRequires Node.js >= 20.\n\n## Quickstart\n\nInitialize a project:\n\n```bash\nsundial init --root /path/to/project --claude --codex\n```\n\n`init` always creates `sundial/`, starter domains, and `sundial/SUNDIAL-INSTRUCTIONS.md`. Agent-specific skills are opt-in:\n\n- `--claude` writes missing Claude Code skills to `.claude/skills/` from CLI templates.\n- `--codex` writes missing Codex skills to `.agents/skills/` from CLI templates.\n- Pass both flags to install both agent integrations.\n- Pass `--folder docs` to keep the store at `/path/to/project/sundial` while installing runtime assets under `/path/to/project/docs`.\n\nRefresh installed skill files later without rerunning store init:\n\n```bash\nsundial update --claude --codex\n```\n\nThe update command discovers the nearest ancestor `sundial` store by default; pass `--root /path/to/project` to target a specific project. Pass `--folder docs` to change the configured target folder, with or without runtime flags. It refreshes the canonical `sundial/SUNDIAL-INSTRUCTIONS.md`; selected harness updates also remove legacy Sundial-managed blocks from `AGENTS.md` or `.claude/CLAUDE.md` while preserving user-authored content.\n\n## How it works\n\n1. **Retrieve precedent.** Before design or coding, the agent consults accepted DRs.\n2. **Create candidates.** When the agent hits a consequential choice with no precedent, it writes a candidate DR.\n3. **Review the inbox.** The engineer edits, accepts, or rejects candidates and retires DRs that no longer apply.\n4. **Improve future work.** Accepted DRs become durable project memory.\n\n```text\nproject/\n  sundial/\n    SUNDIAL-INSTRUCTIONS.md\n    domains.md\n    templates/\n      spec.md\n    decisions/\n      accepted/\n        adr-001-testing-strategy.md\n        dr-014-agent-permissions.md\n      candidates/\n        cand-027-error-boundaries.md\n      rejected/\n      retired/\n```\n\n## Commands\n\n```text\nsundial init --root <path> [--folder <relative-path>] [--claude] [--codex]\nsundial update [--root <path>] [--folder <relative-path>] [--claude] [--codex]\nsundial status\nsundial domains\nsundial domains --json\nsundial domains add --name <name> --description <description>\nsundial domains update <current-name> [--name <new-name>] [--description <description>]\nsundial domains remove <name>\n\nsundial dr list [--status accepted]\nsundial dr get DR-0001\nsundial dr retrieve [--domain <domain>]...\nsundial dr disable DR-0001\nsundial dr enable DR-0001\nsundial dr retire DR-0001 [--by DR-0002]\nsundial dr promote <candidate-id> --from rejected\n\nsundial candidate create --title \"Decision title\" --domain <domain> --decision \"Do the thing\"\nsundial candidate list\nsundial candidate show CAND-0001\nsundial candidate accept CAND-0001\nsundial candidate reject CAND-0001 --reason \"Covered by DR-0001\"\nsundial candidate retire CAND-0001 [--by DR-0001]\nsundial candidate dismiss CAND-0001\n\nsundial spec create --title \"Implementation title\" [--status Backlog]\nsundial spec template\nsundial spec list [--status Active]\nsundial spec status SPEC-0001 Active\nsundial spec show SPEC-0001\n\nsundial worktree list [--json]\nsundial worktree create SPEC-0001 [--json]\nsundial worktree preflight SPEC-0001 [--json]\nsundial worktree finish SPEC-0001 --expected-primary <sha> --expected-worktree <sha> [--primary-message <text>] [--worktree-message <text>] [--json]\n```\n\nNotes:\n\n- Enabled accepted DRs are the only precedent retrieved by `dr retrieve`.\n- Repeat `--domain` on one `dr retrieve` call to retrieve all relevant domain branches together.\n- Domain reads are sorted without rewriting the file. CLI-owned adds, updates, removals, and accepted candidate proposals rewrite the domain section in canonical lexical order.\n- Renaming or removing a domain is blocked while Decision Records or research notes reference it. The permanent `all` domain can only have its description updated.\n- `domains --json` returns the versioned domain, exact-reference-count, and filtered-suggestion contract used by editor adapters.\n- Candidate DRs can include a proposed domain with a description; accepting the DR adds that proposal to `sundial/domains.md`.\n- DRs can include a `## Appendix` section for human-facing explanatory context; short and medium retrieval omit it.\n- New specs render the customizable body in `sundial/templates/spec.md`; it can use `{{id}}`, `{{title}}`, `{{status}}`, `{{created}}`, `{{updated}}`, and `{{created_by}}`.\n- Managed spec worktrees use `.sundial-worktrees/<spec-file-basename>` below the primary checkout. Creation and finish are guarded by current topology and Git state; `--json` returns the versioned contract used by the VS Code extension.\n\n## VS Code\n\nA companion VS Code extension contributes a `Sundial` activity bar view with a Candidate Inbox and project initialization, Decision Record, research, and spec workflows. The extension expects the `sundial` CLI to be available on `PATH`.\n\n## Links\n\n- Source: https://github.com/bjackson-arcridge/sundial\n- Issues: https://github.com/bjackson-arcridge/sundial/issues\n- About: https://arcridgelabs.com/sundial.html\n\n## License\n\nApache 2.0\n","readmeFilename":"README.md"}