Skip to content

Releases

v2.1.0

Choose a tag to compare

@camadkins camadkins released this 09 Nov 04:23
16467bd

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/promptcite is 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:... honours package.json files exactly 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 | bash

See 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 camadkins

What'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

Read more

v2.0.0

Choose a tag to compare

@camadkins camadkins released this 28 Sep 01:16
b248a3f

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 | bash

See INSTALL.md for per-agent install paths.

Verify the release

gh attestation verify promptcite-v2.0.0.tar.gz \
  --repo camadkins/promptcite

Full Changelog: v1.1.0...v2.0.0

v1.1.0

Choose a tag to compare

@camadkins camadkins released this 28 Sep 01:16
fa669a1

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 | bash

See INSTALL.md for per-agent install paths.

Verify the release

gh attestation verify promptcite-v1.1.0.tar.gz \
  --repo camadkins/promptcite

Full Changelog: v1.0.0...v1.1.0

v1.0.0

Choose a tag to compare

@camadkins camadkins released this 28 Sep 01:16
b07fa21

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

  • /receipt slash 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 against src/schema.yaml
  • Seven use_category values: brainstorm, outline, draft, edit,
    debug, explain, search
  • Step 0 provenance gate with metadata_source field
    (agent_reported when the AI fills its own tool/model/date,
    student_claimed when the student types them in)
  • Token-clumped interview flow: brainstorm path drops from 11 turns
    to ~5 with no information loss
  • content_hash field (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-verify CLI (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-init per-project rule-file drops: Cursor, Windsurf,
    Cline, Continue, Roo Code
  • --with-init surgical-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
  • --all filters by detect(): only installs for agents actually
    present on the user's machine
  • Post-install message guides the user to a fresh agent session and
    the /receipt command, 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 summary
  • INSTALL.md — per-agent install matrix with concrete commands
  • NOTICE.md — plain-English dual-license summary
  • SECURITY.md — vulnerability reporting + threat model
  • MAINTAINERS.md — chain of custody
  • CONTRIBUTING.md — contributor guide, CLA flow, scope
  • CODE_OF_CONDUCT.md — Contributor Covenant 2.1 (reference)
  • docs/for-instructors.md — instructor-facing receipt-reading guide
  • examples/brainstorm-receipt.{json,md} — sample receipt artifact

Known limits (intentional)

  • The receipt JSON is locally editable after generation.
    metadata_source is 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 | bash

See INSTALL.md for per-agent install paths.

Verify the release

gh attestation verify promptcite-v1.0.0.tar.gz \
  --repo camadkins/promptcite

Full Changelog: https://github.com/camadkins/promptcite/commits/v1.0.0