Repository navigation
Releases
v2.1.0
PromptCite v2.1.0
Added
- ai levels per assignment (05dc4fd)
- attest mode, check gate, ledger picker, discipline profiles (3b2fb79)
- cite the course rule in the disclosure (e54592f)
- course policies, session hook (#35) (cbaebcf)
- disclosure strings in per-language locale files (#4) (f15f116)
- flag unconfirmed sources (c7da5f4)
- more agents, offline help (#32) (d29e3fc)
- per-file ai table for code (1956c8d)
- policy init for instructors (24c4fb4)
- process timeline (549e51f)
- promptcite help for students and instructors (f218921)
- reflection questions (d5a6b30)
- short, journal and no-ai statements (b86ac13)
- stage and extent per session (c9286ef)
- verify for instructors (#34) (1c3d703)
Fixed
- citation styles (#33) (f2df884)
- file modes, policy init write race, timeline table escaping (492c4f5)
- hashing recipe matches verify on non-ascii receipts (#43) (f5f5708)
- policy init reads the policy file instead of checking it first (f2b8722)
- timeline and policy check edge cases (0b4fb25)
- timeline never runs git diff drivers (4f1914b)
- timeline skips ledger session pointers (0b04484)
- warn on uses outside allowed_categories instead of narrowing them (57aca4a)
Docs
- add edit and explain example receipts (#30) (9cf585f)
- add instructor policy examples for writing, CS, and lab courses (#41) (fb81af9)
- fix install, verify and flag docs (543cafd)
- readme for 2.1.0 (2e78032)
- refresh edit and explain examples (e7781f6)
- schema 2.2 in the rule, ledger and timeline wording (547937b)
- update example citations (#39) (b1a1020)
- update threat model (0333115)
Removed
-
npm publishing. The publish workflow is gone and PromptCite is not on the
npm registry. It never published successfully — npm refused the credential
because publishing from CI needs an Automation-type token to bypass 2FA — and
the human review gate did not work as designed, since release-please creates
its own GitHub Release and that fired the publish on merge rather than on a
deliberate click. Installing from GitHub needs no registry account and no
long-lived token sitting in repo secrets, so the trade was not worth it.Nothing about how anyone installs PromptCite changes:
npx -y github:camadkins/promptciteis what the docs have always said.Kept from that work, because none of it was npm-specific: the CLI
entry-point fix (below), the smaller published tree —npm install github:...honourspackage.jsonfilesexactly as the registry would, so
a GitHub install is 12 files rather than 18 — and the signed provenance
bundle attached to each GitHub Release.
Install
curl -fsSL https://raw.githubusercontent.com/camadkins/promptcite/v2.1.0/install.sh | bashSee INSTALL.md for per-agent install paths.
Verify the release
# download the tarball and its .intoto.jsonl, then:
gh attestation verify promptcite-v2.1.0.tar.gz \
--bundle promptcite-v2.1.0.tar.gz.intoto.jsonl \
--owner camadkinsWhat's Changed
- dependabot: use bun by @camadkins in #3
- feat: disclosure strings in per-language locale files by @camadkins in #4
- chore(actions): bump the codeql-action group across 1 directory with 2 updates by @dependabot[bot] in #1
- chore(actions): bump softprops/action-gh-release from 3.0.2 to 3.0.3 by @dependabot[bot] in #2
- chore(deps): bump typescript from 6.0.3 to 7.0.2 by @dependabot[bot] in #5
- chore(deps): bump @types/node from 26.6.3 to 26.6.4 by @dependabot[bot] in #7
- chore(deps): bump @types/node from 26.6.4 to 26.6.5 by @dependabot[bot] in #8
- chore(actions): bump the codeql-action group with 2 updates by @dependabot[bot] in #9
- chore(actions): bump actions/upload-artifact from 7.0.1 to 7.0.2 by @dependabot[bot] in #10
- chore(actions): bump actions/setup-node from 7.0.0 to 7.1.0 by @dependabot[bot] in #11
- chore(actions): bump ossf/scorecard-action from 2.4.4 to 2.5.0 by @dependabot[bot] in #12
- chore(actions): bump the codeql-action group with 2 updates by @dependabot[bot] in #13
- chore(actions): bump the codeql-action group with 2 updates by @dependabot[bot] in #14
- chore(deps): bump @types/node from 26.6.5 to 26.6.6 by @dependabot[bot] in #15
- ci: hardening, changelog cleanup by @camadkins in #31
- feat: more agents, offline help by @camadkins in #32
- fix: citation styles by @camadkins in #33
- feat: verify for instructors by @camadkins in #34
- feat: course policies, session hook by @camadkins in #35
- chore: drop the cla and commercial license by @camadkins in #36
- Add edit and explain example receipts by @Saikat556 in #30
- docs: update example citations by @camadkins in #39
- ci: more pr checks by @camadkins in #40
- docs: add instructor policy examples for writing, CS, and lab courses by @nextammy in #41
- feat: 2.1.0 features by @camadkins in #42
- chore(actions): bump the codeql-action group with 2 updates by @dependabot[bot] in #37
- chore(actions): bump softprops/action-gh-release from 3.0.3 to 3.0.4 by @dependabot[bot] in #38
- test: property-based fuzzing by @camadkins in #43
- chore(main): release 2.1.0 by @camadkins in #16
New Contributors
- @camadkins made their first contribution in #3
- @dependabot[bot] made their first contribution in #1
- @Saikat556 made...
v2.0.0
PromptCite v2.0.0
Originally released 2026-08-01.
One receipt now covers a whole assignment. ai_use is an ordered array of
sessions, so an assignment worked across several days is one honest record
instead of several that overwrite each other. Existing 1.x receipts stay valid —
promptcite-verify reads both, and /receipt upgrades an older receipt in place
the first time you add a session to it.
Field-by-field mapping: docs/SCHEMA-CHANGELOG.md.
Reasoning: ADR 0007.
⚠ BREAKING CHANGES
- ai_use is re-typed from an object to a non-empty array. metadata_source, the citation strings, and appendix move onto each session; outputs keeps only disclosure_statement. Consumers must branch on schema_version. bin/verify.js reads both 1.x and 2.0, and /receipt upgrades older receipts in place, so nothing is lost.
Added
- add hook-register install strategy for Claude Code and Codex (017eb78)
- add optional AI-use ledger and /receipt recall (e10e89a)
- add promptcite-hook, the observe-only ledger recorder (04cda98)
- receipt schema 2.0 — one receipt covers a whole assignment (2ce04d7)
- verify both schema generations and add a 2.0 example (4f5d183)
Fixed
- make the npm package correct and lightweight (e1f8b44)
- remove file-system races in the hook's ledger and marker writes (439e408)
Docs
- add instructor guidance on the ledger and a software-review table (2d29f41)
- instructor guidance for multi-session receipts (996c7ff)
Install
curl -fsSL https://raw.githubusercontent.com/camadkins/promptcite/v2.0.0/install.sh | bashSee INSTALL.md for per-agent install paths.
Verify the release
gh attestation verify promptcite-v2.0.0.tar.gz \
--repo camadkins/promptciteFull Changelog: v1.1.0...v2.0.0
v1.1.0
PromptCite v1.1.0
Originally released 2026-06-10.
Added
- next build — 24 agents, schema 1.1, /receipt modes, verify + policy (ea5b8c8)
Docs
- readme rewrite for clearer install + marketing scan (9574492)
Install
curl -fsSL https://raw.githubusercontent.com/camadkins/promptcite/v1.1.0/install.sh | bashSee INSTALL.md for per-agent install paths.
Verify the release
gh attestation verify promptcite-v1.1.0.tar.gz \
--repo camadkins/promptciteFull Changelog: v1.0.0...v1.1.0
v1.0.0
PromptCite v1.0.0
Originally released 2026-05-29.
The MVP. Cross-agent /receipt skill + dual-license + CLA
infrastructure + supply-chain hardening, all shipped together.
Added
The product
/receiptslash command available across 10 AI coding/writing
agents via native install paths (no registry dependency for v1.0)- Receipt outputs: MLA 9 / APA 7 / Chicago 17 citation strings,
plain-language disclosure paragraph, structured JSON receipt
validated againstsrc/schema.yaml - Seven
use_categoryvalues: brainstorm, outline, draft, edit,
debug, explain, search - Step 0 provenance gate with
metadata_sourcefield
(agent_reportedwhen the AI fills its own tool/model/date,
student_claimedwhen the student types them in) - Token-clumped interview flow: brainstorm path drops from 11 turns
to ~5 with no information loss content_hashfield (sha256 of canonical other-fields) for
tamper-evident receipts. Agent computes it at generation time if it
has a code-execution tool, sets null otherwise. Honest framing:
speed bump, not signature.promptcite-verifyCLI (bin/verify.js) for instructors:
recomputes the hash and reports match / mismatch / null / user error
with distinct exit codes (0 / 1 / 2 / 3).
Install matrix (10 native adapters)
- Global install: Claude Code (
~/.claude/skills/promptcite/SKILL.md),
Gemini CLI (gemini extensions install <repo>) --with-initper-project rule-file drops: Cursor, Windsurf,
Cline, Continue, Roo Code--with-initsurgical-block append: GitHub Copilot
(.github/copilot-instructions.md), Codex CLI (AGENTS.md),
Aider (CONVENTIONS.md)- One-liner install for macOS / Linux / WSL / Git Bash
(curl … | bash) and Windows PowerShell (irm … | iex) - Installer flags:
--dry-run,--only <id>,--all,--with-init,
--uninstall,--non-interactive,--no-color,--config-dir,
--force,--list,--version,--help --allfilters bydetect(): only installs for agents actually
present on the user's machine- Post-install message guides the user to a fresh agent session and
the/receiptcommand, with a docs link.
Licensing & contributor governance
- AGPL-3.0-only community license + commercial license available
(LICENSE-COMMERCIAL) - Harmony Agreement HA-CLA-I-LIST 1.0 for individual contributors
(CLA.md) - Harmony Agreement HA-CLA-E stub for entity contributors
(CLA-ENTITY.md) - CLA Assistant bot live and enforced via required status check
- Maintainer chain of custody in
MAINTAINERS.md
CI/CD pipeline
- 7 GitHub Actions workflows:
ci.yml,pr-checks.yml,release.yml,
scorecard.yml,codeql.yml,dependabot.yml,CODEOWNERS - PR-checks bot — project-specific checklist; sticky comment shows only
failures/warnings (or "looks good"), never exposes passed checklist - 8 required status checks on
main(license/cla, Typecheck,
Install dry-run × 2 OS, Gemini extension manifest valid,
GEMINI.md synced, PR checklist, Analyze JavaScript) - Release workflow auto-creates GitHub Release on
v*tag push with
sigstore build-provenance attestation (verifiable via
gh attestation verify) - OSSF Scorecard runs weekly + on push for supply-chain hygiene
- CodeQL static analysis on every PR + weekly
- Dependabot weekly updates for npm devDeps + GitHub Actions versions
- All TypeScript / @types/node / GitHub Action major versions on
current (TS 6.0.3, @types/node 25.x, actions/checkout v6, etc.)
Documentation
README.md— project overview, status, install, license summaryINSTALL.md— per-agent install matrix with concrete commandsNOTICE.md— plain-English dual-license summarySECURITY.md— vulnerability reporting + threat modelMAINTAINERS.md— chain of custodyCONTRIBUTING.md— contributor guide, CLA flow, scopeCODE_OF_CONDUCT.md— Contributor Covenant 2.1 (reference)docs/for-instructors.md— instructor-facing receipt-reading guideexamples/brainstorm-receipt.{json,md}— sample receipt artifact
Known limits (intentional)
- The receipt JSON is locally editable after generation.
metadata_sourceis a transparency marker, not a tamper-proof
signature. PromptCite v1.0 has no server-side signing, transparency
log, or instructor-side verification — that's future-direction
integration work, out of scope for v1.0. - Long-tail agents beyond the 10 in the matrix are not yet supported.
The vercel-labs/skills registry submission is deferred until the
project has earned the maintainer time of other devs. - English-only receipt output. Non-English disclosure templates are
post-v1.0. - Multi-session receipt aggregation is not supported — students
needing to disclose AI use across multiple sessions run/receipt
per session and combine manually.
Security
- Repo branch protection:
enforce_admins=true, no force-pushes,
no deletions,dismiss_stale_reviews=true, all 8 required checks - Solo collaborator (maintainer); CLA bot blocks merges from any
external contributor without a signed CLA - Sigstore build-provenance attestation on tagged releases — users
can verify the release tarball wasn't tampered with via
gh attestation verify - Zero runtime dependencies in the installer (Node built-ins only)
- No telemetry, no analytics, no install IDs, no phone-home
Install
curl -fsSL https://raw.githubusercontent.com/camadkins/promptcite/v1.0.0/install.sh | bashSee INSTALL.md for per-agent install paths.
Verify the release
gh attestation verify promptcite-v1.0.0.tar.gz \
--repo camadkins/promptciteFull Changelog: https://github.com/camadkins/promptcite/commits/v1.0.0