diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml index cd182133..e3adda3f 100644 --- a/.github/ISSUE_TEMPLATE/bug.yml +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -1,10 +1,10 @@ name: Bug report -description: Report a reproducible problem with current Tabellio behavior. +description: Report a reproducible problem with current WritSet behavior. title: "[Bug]: " body: - type: markdown attributes: - value: "For vulnerabilities, use https://github.com/IntelIP/Tabellio/security/advisories/new. Do not include credentials, private sessions, provider bodies, or account data." + value: "For vulnerabilities, use https://github.com/IntelIP/WritSet/security/advisories/new. Do not include credentials, private sessions, provider bodies, or account data." - type: input id: version attributes: diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 6a821bdd..aa159134 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,5 +1,5 @@ blank_issues_enabled: false contact_links: - name: Private vulnerability report - url: https://github.com/IntelIP/Tabellio/security/advisories/new + url: https://github.com/IntelIP/WritSet/security/advisories/new about: Report security issues privately. Do not post vulnerability details in public issues. diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 6ae3c938..889c2257 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -3,7 +3,7 @@ Who benefits, what problem this solves, and the observable before/after behavior. List changed files, scope limits, and any unfinished work. -## Tabellio Evidence +## WritSet evidence - [ ] Evidence envelope generated - [ ] Evidence envelope validated diff --git a/AGENTS.md b/AGENTS.md index 4ad20336..aa916530 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,7 +1,8 @@ # Agent entry point -Tabellio helps teams review AI-assisted code with evidence tied to the exact code -version. Serve teams trying and connecting Tabellio before adding operator detail. +WritSet helps teams understand and track context across coding-agent work. +Serve teams trying and connecting WritSet before adding operator detail. +The published package, CLI commands, and stored formats retain their Tabellio names. ## Find the right guide diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 80897f9d..641fbc0c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Contributing -Help teams try Tabellio, connect one repository, and review code with clear evidence. +Help teams try WritSet, connect one repository, and understand their coding agents' context. Keep changes Git-native, agent-agnostic, dependency-light, deterministic before AI-assisted, and default-deny for protected external actions. @@ -10,11 +10,12 @@ Use Node.js 20 or later, npm, Git 2.38 or later, and Entire 0.7.7 or later. CI uses Node.js 22.23.1. PostgreSQL client/server binaries are required for the provenance integration suite; git-spice 0.18 or later is needed for stack work. The package has no runtime npm dependencies. Named npm scripts below belong to -this checkout; installed users start at [Try Tabellio](docs/try-tabellio.md). +this checkout; installed users start at [Try WritSet](docs/try-tabellio.md). +The published package and CLI commands still use the earlier Tabellio name. ```bash -git clone https://github.com/IntelIP/Tabellio.git -cd Tabellio +git clone https://github.com/IntelIP/WritSet.git +cd WritSet entire enable --agent codex --project --skip-push-sessions node scripts/tabellio-preflight.mjs --profile agent ``` diff --git a/NOTICE b/NOTICE index 3ad28cf4..5fb2f436 100644 --- a/NOTICE +++ b/NOTICE @@ -1,4 +1,4 @@ -Tabellio +WritSet (formerly Tabellio) Copyright 2026 IntelIP -This product includes software developed for the Tabellio project. +This product includes software developed for the WritSet project (formerly Tabellio). diff --git a/README.md b/README.md index 92f53014..4ba090f9 100644 --- a/README.md +++ b/README.md @@ -1,28 +1,39 @@ -# Tabellio +

+ + + WritSet + +

-Tabellio helps teams review AI-assisted code by collecting what changed, what was checked, and which actions were approved for the exact code version. +

Context engineering for coding agents.

-![Tabellio product overview](docs/assets/tabellio-hero.svg) +

Understand what your agent worked from, what changed, and where to pick up next.

-**Published: [@intelip/tabellio 0.7.0](https://www.npmjs.com/package/@intelip/tabellio/v/0.7.0).** -This is an early project for evaluation on trusted workers. -Its local demo is repeatable; production adoption and performance are not established by that demo. +

+ Documentation · + Try the demo · + Releases · + Help +

-[Documentation](docs/README.md) · [Examples](examples/) · [Releases](https://github.com/IntelIP/Tabellio/releases) · [Help](https://github.com/IntelIP/Tabellio/issues) +WritSet keeps task context, code versions, checkpoints, and results connected across +coding-agent work. Start with a clear task, follow the changes, and keep a record +that the next session can use. -## Try the published package +## Keep the context connected -Start in a new directory. The demo needs: +- **Capture the starting point.** Record the task, Git base, changed files, and checkpoints. +- **Track what changed.** Tie results to the code version they describe; surface stale or missing evidence. +- **Carry work forward.** Keep run state, findings, and next actions available after an interruption. -- macOS or Linux, running as a regular user. -- Node.js 20 or later and npm. Repository CI uses Node.js 22.23.1. -- Git 2.38 or later. -- PostgreSQL client and server binaries on `PATH`: `psql`, `createdb`, `initdb`, and `pg_ctl`. - PostgreSQL 14.15 was used for the documented macOS run. +[Agent workflow](docs/agent-run-lifecycle.md) · [How context is stored](docs/native-git-foundation.md) -The demo creates its own temporary Git repository and private PostgreSQL cluster. -You do not need an existing database, provider account, token, Entire installation, -or git-spice installation for this sample. Internet access is needed to install the package. +## Try it locally + +**Requirements:** macOS or Linux, Node.js 20+, Git 2.38+, and PostgreSQL client/server +tools on `PATH`. See the [setup guide](docs/try-tabellio.md#requirements). + +In a new directory: ```bash npm install --save-dev @intelip/tabellio@0.7.0 @@ -30,103 +41,24 @@ npx tabellio-version --expect-version 0.7.0 npx tabellio-provenance-demo ``` -The version command checks the installed runner. The demo imports observations, -restarts the database, rebuilds its derived records, and checks review decisions. -It then stops its PostgreSQL server and removes its temporary files. -See [Try Tabellio](docs/try-tabellio.md) for setup, troubleshooting, and a saved receipt. - -## What you should see - -Both commands print JSON. Successful receipts include `ok: true` for the version -check and `status: "passed"` for the demo. Expected failure cases remain blocked. - -Actual terminal-output excerpt from a clean installed-package run on macOS: - -```json -{ - "status": "passed", - "checks": { - "sourceReplay": "passed", - "changedSourceReplay": "blocked", - "missingSecurity": "blocked", - "postgresServerRestart": "passed", - "deleteAndReplay": "passed", - "movedBase": "blocked" - }, - "cost": { "usd": 0, "modelCalls": 0, "cloudCalls": 0 }, - "cleanup": "passed" -} -``` - -This is an excerpt, not the full receipt; commit IDs and timing vary per run. -Git and PostgreSQL operations are real. Plane, Entire, GitHub, Buildkite, and -security observations are **synthetic fixtures**. GitHub status delivery uses a -local fake transport. Nothing in this sample is published to a provider. -The sample proves the local workflow, not live provider access or scanner effectiveness. - -## What Tabellio can do - -| Capability | Practical result | -| --- | --- | -| Capture exact Git context | A packet names the base, head, changed files, and checkpoint evidence. | -| Run committed validation commands | Results apply to one code version; later edits can invalidate readiness. | -| Keep durable review and run state | Work can resume with its checks, findings, and next action preserved. | -| Import safe source observations | Local PostgreSQL records keep source identity and replayable relationships. | -| Build candidate-scoped review packets | Missing, stale, conflicting, or failed evidence remains visible and blocking. | -| Record independent security evidence | Bounded scanner receipts remain separate from an agent's review claim. | -| Prepare approved status publication | Review results can be shared through an explicit, short-lived approval. | -| Join delivery evidence | Reports distinguish code, releases, deployments, and missing relationships. | - -The package also includes optional git-spice stack operations and a **legacy Plane -import capability**. IntelIP uses AgentShift for current project tracking; -Tabellio does not include an AgentShift adapter. - -## Connect a real repository - -Repository integration has extra requirements: a trusted Git checkout, genuine -Entire 0.7.7 or later checkpoints, and the committed platform and validation contracts. -Use git-spice 0.18 or later when working with stacked branches. PostgreSQL is -needed for the local provenance store; it is not needed for every Git-ref workflow. - -Start with [Connect a repository](docs/getting-started.md). -That guide separates installed CLI commands from source-checkout development. -Exported provider snapshots need explicit access and safe input handling. -Publishing statuses or sharing private control refs needs separate approval. - -## How the pieces fit - -```mermaid -flowchart LR - A[Git and safe source snapshots] --> B[Tabellio capture and checks] - B --> C[Local PostgreSQL projection] - C --> D[Review packet] - B --> E[Local Git evidence refs] - D --> F[Human review and decision] - E --> F -``` - -GitHub stores code and pull requests. Private checkpoint, validation, and review -state stays on customer-owned local storage by default. PostgreSQL stores a -derived evidence view; source observations and Git remain the recovery inputs. -See [Native Git foundation](docs/native-git-foundation.md) and -[Provenance operations](docs/provenance.md) for the detailed boundaries. +The demo records source observations, restarts its temporary database, and rebuilds +the stored context. A successful receipt ends with `status: "passed"` and +`cleanup: "passed"`. -## Material limits +**Naming transition:** WritSet was previously Tabellio. The published package and +commands still use the earlier name; the commands above are the supported install. -- Passing checks do not grant merge, release, deployment, or credential authority. -- Missing access is a blocker, not a successful or empty observation. -- Security checks cover their declared rules, not every possible vulnerability. -- Hosted exact-head validation needs genuine, privately provisioned checkpoint evidence. -- No autonomous production service, cloud provisioning, or automatic learning is included. +## Current scope -## Contribute, operate, and get help +WritSet is an early CLI toolkit for trusted local workers. Git and database operations +in the demo are real; external-service and security records are synthetic. +It does not prove production adoption, benchmark gains, or live-provider security. +Private context stays on customer-owned storage by default. External actions require +their own approval. -[Contributing](CONTRIBUTING.md) explains source setup, checks, and handoffs. -[Agent instructions](AGENTS.md) route coding agents to the same standards. -[Operate and release](docs/operate-and-release.md) covers protected operator procedures. +## Go further -Ask questions or report ordinary bugs through [GitHub Issues](https://github.com/IntelIP/Tabellio/issues). -Use [private vulnerability reporting](https://github.com/IntelIP/Tabellio/security/advisories/new) -for security reports; read the [security policy](SECURITY.md) first. +[Connect a repository](docs/getting-started.md) · [Examples](examples/) · +[Contribute](CONTRIBUTING.md) · [Security](SECURITY.md) · [Brand assets](docs/brand.md) -Tabellio is licensed under **Apache-2.0**. See [LICENSE](LICENSE) and [NOTICE](NOTICE). +Built by **IntelIP**. Licensed under [Apache-2.0](LICENSE). diff --git a/SECURITY.md b/SECURITY.md index 51e37e0b..09cc7785 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -8,10 +8,10 @@ version and source commit when available. ## Private vulnerability reporting -Use [GitHub's private report form](https://github.com/IntelIP/Tabellio/security/advisories/new). +Use [GitHub's private report form](https://github.com/IntelIP/WritSet/security/advisories/new). Do not file vulnerability details in a public issue. The private form is the project's reporting route; ordinary bugs and questions use -[GitHub Issues](https://github.com/IntelIP/Tabellio/issues). +[GitHub Issues](https://github.com/IntelIP/WritSet/issues). Include the affected version/file, minimal reproduction, expected and actual behavior, likely impact, and safe evidence references. Explain whether the issue @@ -41,7 +41,7 @@ configuration, disabled TLS verification, dynamic `eval`, and declared dependenc policy. Candidate ignore files cannot grant a pass. Remaining declared dependencies need vulnerability evidence. Read [scanner operations](docs/provenance.md) for limits. -Tabellio does not claim complete vulnerability detection, SLSA certification, +WritSet does not claim complete vulnerability detection, SLSA certification, in-toto verification, cryptographic evidence signing, complete supply-chain protection, or autonomous production safety. Synthetic security observations in the demo do not prove scanner effectiveness or live-provider security. diff --git a/docs/README.md b/docs/README.md index 82f701f4..7d54c105 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,11 +1,14 @@ -# Tabellio documentation +# WritSet documentation -Choose the outcome you need. Current guides describe behavior; validation and -review records establish passing evidence for a specific code version. +Understand and track the context behind coding-agent work: tasks, source versions, +checkpoints, results, and handoffs. Choose the outcome you need below. + +WritSet was previously Tabellio. The published package, CLI commands, configuration +files, and stored formats keep their existing names during this transition. | Route | Start here | Result | | --- | --- | --- | -| **Try Tabellio** | [Published-package demo](try-tabellio.md) | Run a local sample and understand which observations are synthetic. | +| **Try WritSet** | [Published-package demo](try-tabellio.md) | Run a local sample and understand which observations are synthetic. | | **Connect a repository** | [Integration setup](getting-started.md) | Add genuine checkpoints and repository-specific contracts. | | **Contribute** | [Contributor setup and handoffs](../CONTRIBUTING.md) | Finish one scoped change with the applicable checks. | | **Operate and release** | [Operator guide](operate-and-release.md) | Review protected sharing, validation, and release procedures. | @@ -34,7 +37,7 @@ review records establish passing evidence for a specific code version. - [Operations hardening](operations-hardening.md) and [checkpoint proof handoff](checkpoint-proof-handoff.md). - [Pilot acceptance](pilot/acceptance-plan.md) and [architecture and recovery](pilot/architecture-and-recovery.md). - [Release notes](releases/), [changelog](../CHANGELOG.md), and [v0.7.0 launch scope](gtm/v0.7.0-launch.md). -- [Security policy](../SECURITY.md) and [private reporting](https://github.com/IntelIP/Tabellio/security/advisories/new). +- [Security policy](../SECURITY.md) and [private reporting](https://github.com/IntelIP/WritSet/security/advisories/new). ## Previous work diff --git a/docs/agent-run-lifecycle.md b/docs/agent-run-lifecycle.md index 18646bd1..443ae25a 100644 --- a/docs/agent-run-lifecycle.md +++ b/docs/agent-run-lifecycle.md @@ -1,6 +1,6 @@ # Agent Run Lifecycle -Tabellio can run a complete local agent workflow without a GitHub API or proprietary code-storage service. State lives under a local run root; Git remains the code substrate. +WritSet can run a complete local agent workflow without a GitHub API or proprietary code-storage service. State lives under a local run root; Git remains the code substrate. ## State Machine diff --git a/docs/assets/fonts/space-grotesk-LICENSE.txt b/docs/assets/fonts/space-grotesk-LICENSE.txt new file mode 100644 index 00000000..d5666d70 --- /dev/null +++ b/docs/assets/fonts/space-grotesk-LICENSE.txt @@ -0,0 +1,93 @@ +Copyright 2020 The Space Grotesk Project Authors (https://github.com/floriankarsten/space-grotesk) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +http://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/docs/assets/fonts/space-grotesk.woff2 b/docs/assets/fonts/space-grotesk.woff2 new file mode 100644 index 00000000..7b0e76a5 Binary files /dev/null and b/docs/assets/fonts/space-grotesk.woff2 differ diff --git a/docs/assets/writset-icon-dark.svg b/docs/assets/writset-icon-dark.svg new file mode 100644 index 00000000..fd14dff7 --- /dev/null +++ b/docs/assets/writset-icon-dark.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/assets/writset-icon-inverse.svg b/docs/assets/writset-icon-inverse.svg new file mode 100644 index 00000000..17999562 --- /dev/null +++ b/docs/assets/writset-icon-inverse.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/assets/writset-icon.svg b/docs/assets/writset-icon.svg new file mode 100644 index 00000000..b04233ee --- /dev/null +++ b/docs/assets/writset-icon.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/assets/writset-logo-dark.svg b/docs/assets/writset-logo-dark.svg new file mode 100644 index 00000000..2dd20777 --- /dev/null +++ b/docs/assets/writset-logo-dark.svg @@ -0,0 +1,6 @@ + +WritSet +The Cursor W icon beside WritSet in Space Grotesk. Context engineering for coding agents. + + + diff --git a/docs/assets/writset-logo-light.svg b/docs/assets/writset-logo-light.svg new file mode 100644 index 00000000..3ea9e0c9 --- /dev/null +++ b/docs/assets/writset-logo-light.svg @@ -0,0 +1,6 @@ + +WritSet +The Cursor W icon beside WritSet in Space Grotesk. Context engineering for coding agents. + + + diff --git a/docs/brand.md b/docs/brand.md index 1c562dc5..3ee8e2b5 100644 --- a/docs/brand.md +++ b/docs/brand.md @@ -1,38 +1,44 @@ -# Brand System +# WritSet brand -Tabellio uses a notary-orange visual system: near-black surfaces, off-white text, and one warm accent for attestation, provenance, and approval states. +WritSet makes context engineering for coding agents easier to understand and track. +The identity pairs the Cursor W icon with a plain, single-color WritSet title. -## Logo +## Assets | Asset | Use | | --- | --- | -| `docs/assets/tabellio-mark.svg` | Square mark, favicon, social avatar, compact UI | -| `docs/assets/tabellio-logo.svg` | Full horizontal logo lockup | -| `docs/assets/tabellio-hero.svg` | README and product overview hero | +| [Cursor W](assets/writset-icon.svg) | Cobalt icon for light backgrounds | +| [Cursor W, dark surface](assets/writset-icon-dark.svg) | Light blue icon for dark backgrounds | +| [Cursor W, inverse](assets/writset-icon-inverse.svg) | White icon for cobalt backgrounds | +| [Light logo](assets/writset-logo-light.svg) | Icon and dark title on a light background | +| [Dark logo](assets/writset-logo-dark.svg) | Icon and light title on a dark background | -The mark combines three ideas: +The icon combines a bracket-shaped W with a terminal cursor. Use the approved +geometry as supplied. Keep the icon separate from the title; do not recolor parts +of the word, stretch the mark, or add letter spacing. -- a notarial seal for attestation -- a hidden `T` for Tabellio -- a connected path for Git provenance +## Typography -## Color Stack +Use **Space Grotesk** for headings, the title, and body copy. Use **JetBrains Mono** +for code and small technical labels. The logo title uses Space Grotesk at weight +500 with its natural spacing. SVG text is outlined so GitHub renders it without +requiring visitors to install a font. -| Token | Hex | Use | +The [Space Grotesk license](assets/fonts/space-grotesk-LICENSE.txt) and original +[font source](assets/fonts/space-grotesk.woff2) accompany the editable SVG assets. + +## Colors + +| Color | Value | Role | | --- | --- | --- | -| `base` | `#000000` | Page background | -| `surface` | `#111111` | Primary cards and logo field | -| `surface-muted` | `#191919` | Secondary panels and inputs | -| `border` | `#3A3A3A` | Rules, dividers, inactive outlines | -| `accent` | `#DA5C2C` | Attestation paths, active states, primary emphasis | -| `accent-soft` | `#F2B37B` | Node highlights and small warm details | -| `text` | `#EEEEEE` | Headings and logo text | -| `text-muted` | `#B4B4B4` | Supporting copy | - -## Usage Rules - -- Use orange as signal, not decoration. -- Keep surfaces mostly black and graphite. -- Prefer vector SVG for logos; export PNG only for compatibility. -- Keep radius low for product UI and cards. -- Avoid blue/teal gradients in Tabellio brand assets. +| Cobalt | `#2455CC` | Primary accent and light-background icon | +| Light blue | `#88B4FF` | Dark-background icon and active details | +| Ink | `#101B30` | Light-background title and text | +| Night | `#080E1C` | Dark page background | +| Paper | `#F4F7FC` | Dark-background title and light surfaces | +| Muted | `#96A4BF` | Secondary text on dark surfaces | + +The product name is **WritSet**. Use **WritSet** for the GitHub repository and +public-facing prose. The existing `@intelip/tabellio` package, CLI names, schemas, +Git refs, and stored records remain compatible during the transition. Historical +Tabellio assets and release records are retained as history, not current branding. diff --git a/docs/getting-started.md b/docs/getting-started.md index 043d3671..57b49a6d 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,7 +1,7 @@ # Connect a repository -Connect one trusted repository so reviewers can identify the exact code version, -its checks, checkpoint evidence, and any unresolved work. Try the +Connect one trusted repository to track the task, source version, checkpoints, +results, and unresolved work behind an agent session. Try the [credential-free demo](try-tabellio.md) first if you are evaluating the package. ## Integration requirements @@ -24,8 +24,8 @@ npx tabellio-version --expect-version 0.7.0 ``` Use installed CLIs with `npx`. Commands beginning `node scripts/` or `npm run` -in operator guides refer to a Tabellio source checkout. Source contributors use -[CONTRIBUTING.md](../CONTRIBUTING.md); do not copy Tabellio's development scripts +in operator guides refer to a WritSet source checkout. Source contributors use +[CONTRIBUTING.md](../CONTRIBUTING.md); do not copy WritSet's development scripts into an unrelated application. GitHub is the canonical code store through `origin`. Private transcripts, @@ -54,7 +54,7 @@ operator-approved repair step. Use the [platform boundary](github-code-storage-boundary.md) and [validation contract](validation-runner.md) to add `tabellio.platform.json` and `tabellio.validation.json` for your repository. Commit only the intended commands, -acceptance criteria, and data boundaries. Tabellio ships +acceptance criteria, and data boundaries. WritSet ships [examples](../examples/); copying a fixture does not establish passing evidence. Run the committed manifest against one exact candidate: diff --git a/docs/native-git-foundation.md b/docs/native-git-foundation.md index 601c6ceb..c457bea3 100644 --- a/docs/native-git-foundation.md +++ b/docs/native-git-foundation.md @@ -1,6 +1,6 @@ # Native Git Foundation -Tabellio's core works without a GitHub API or a proprietary code-storage service. It uses the installed Git executable, standard object storage, bare repositories, refs, notes, and worktrees. +WritSet's core works without a GitHub API or a proprietary code-storage service. It uses the installed Git executable, standard object storage, bare repositories, refs, notes, and worktrees. ## Architecture diff --git a/docs/try-tabellio.md b/docs/try-tabellio.md index 10caeda7..5706db8d 100644 --- a/docs/try-tabellio.md +++ b/docs/try-tabellio.md @@ -1,8 +1,11 @@ -# Try Tabellio +# Try WritSet -Run the published package in a new directory to see how a code review can retain -its source evidence and reject stale or missing proof. This sample needs no -provider account or credentials. +Run the published package in a new directory to see how source context is recorded, +rebuilt, and checked for stale or missing evidence. This sample needs no provider +account or credentials. + +WritSet was previously Tabellio. Version 0.7.0 remains published as +`@intelip/tabellio`; use the existing commands below during the naming transition. ## Requirements diff --git a/docs/workflow-model.md b/docs/workflow-model.md index dfd6dc5a..7a975aff 100644 --- a/docs/workflow-model.md +++ b/docs/workflow-model.md @@ -1,6 +1,6 @@ -# Tabellio Workflow Model +# WritSet Workflow Model -Tabellio turns an agentic coding run into a GitHub-bound context packet and, when wanted, a reviewable pull request packet. +WritSet turns an agentic coding run into a GitHub-bound context packet and, when wanted, a reviewable pull request packet. ## Core Objects @@ -25,7 +25,7 @@ Tabellio turns an agentic coding run into a GitHub-bound context packet and, whe | --- | --- | --- | | Git substrate | Standard Git CLI and bare repositories | Stores repositories, branches, commits, and patch state | | Session ledger | Entire; Git notes only for migration | Preserves checkpoint and agent-run context for later review | -| Evidence gate | Tabellio | Validates commands, checks, changed files, approvals, and side-effect policy | +| Evidence gate | WritSet | Validates commands, checks, changed files, approvals, and side-effect policy | | Stacked review | git-spice | Keeps related GitHub pull requests small, ordered, and reviewable | | Agent review | Codex review | Adds optional diff and evidence review by an agent | @@ -60,7 +60,7 @@ Each PR should expose: - external actions attempted or blocked - evidence artifact path -The context packet is usable without a pull request. GitHub is the review and code-distribution surface; Tabellio's evidence remains independently verifiable. +The context packet is usable without a pull request. GitHub is the review and code-distribution surface; WritSet's evidence remains independently verifiable. Raw evidence is not automatically a correctness claim. A typed validation decision proves that the exact committed evidence met the committed thresholds. Human review still owns product judgment outside the declared contract. diff --git a/package.json b/package.json index ffc1b971..336219ef 100644 --- a/package.json +++ b/package.json @@ -1,14 +1,14 @@ { "name": "@intelip/tabellio", "version": "0.7.0", - "description": "Tabellio helps teams review AI-assisted code with evidence tied to the exact code version.", + "description": "WritSet helps teams understand and track context across coding-agent work.", "type": "module", "license": "Apache-2.0", "author": "IntelIP", - "homepage": "https://github.com/IntelIP/Tabellio/tree/main/docs", + "homepage": "https://github.com/IntelIP/WritSet/tree/main/docs", "repository": { "type": "git", - "url": "git+https://github.com/IntelIP/Tabellio.git" + "url": "git+https://github.com/IntelIP/WritSet.git" }, "bin": { "tabellio-run": "scripts/tabellio-run.mjs", @@ -41,7 +41,7 @@ "tabellio-checkpoint-proof": "scripts/tabellio-checkpoint-proof.mjs" }, "bugs": { - "url": "https://github.com/IntelIP/Tabellio/issues" + "url": "https://github.com/IntelIP/WritSet/issues" }, "private": false, "publishConfig": { @@ -129,22 +129,17 @@ "node": ">=20" }, "keywords": [ - "agentic", + "writset", + "context-engineering", + "coding-agents", + "agent-context", + "agent-memory", "git", - "native-git", - "bare-repository", - "worktree", - "pull-request", - "evidence", "provenance", - "ci", - "workflow", - "tabellio", - "json-schema", - "sarif", - "stacked-pr", - "git-spice", + "checkpoints", + "codex", "entire", - "codex" + "workflow", + "tabellio" ] } diff --git a/templates/pull_request_template.md b/templates/pull_request_template.md index 6ae3c938..889c2257 100644 --- a/templates/pull_request_template.md +++ b/templates/pull_request_template.md @@ -3,7 +3,7 @@ Who benefits, what problem this solves, and the observable before/after behavior. List changed files, scope limits, and any unfinished work. -## Tabellio Evidence +## WritSet evidence - [ ] Evidence envelope generated - [ ] Evidence envelope validated