sphica 0.6.44 → 0.6.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
3
3
  "name": "sphica",
4
- "version": "0.6.44",
4
+ "version": "0.6.46",
5
5
  "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
6
6
  "author": {
7
7
  "name": "iroha924",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sphica",
3
- "version": "0.6.44",
3
+ "version": "0.6.46",
4
4
  "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
5
5
  "author": {
6
6
  "name": "iroha924",
package/README.md CHANGED
@@ -137,7 +137,7 @@ The agent searches with Sphica's `search` and opens full records with `read`. `s
137
137
  - `mysql -p`
138
138
 
139
139
  **Anything else is stored as typed, so do not paste secrets into a session.** If one got in, remove the source holding it with `/sphica:forget` (Claude Code; the confirmation dialog it needs may not appear in Codex). A record that repeated it keeps its own text.
140
- - **Network.** Sphica has no account, no hosted service, and no telemetry, and makes no network connections itself. `/sphica:harvest` and `/sphica:glean` run `gh api` with your credentials to read pull requests and issues, `sphica init` runs `gh api user` to read which GitHub account is yours, and `sphica doctor` runs `npm` and `claude` to check installed versions. `gh api` is always sent to github.com.
140
+ - **Network.** Sphica has no account, no hosted service, and no telemetry, and makes no network connections itself. `/sphica:harvest` and `/sphica:glean` run `gh api` with your credentials to read pull requests and issues, `sphica init` runs `gh api user` to read which GitHub account is yours, and `sphica doctor` runs `npm`, `claude`, and `codex` to check installed versions. `gh api` is always sent to github.com.
141
141
  - **Text written by others.** Pull request and issue text may come from anyone. It is kept as a source and passed to the agent as data, never as instructions. A decision is adopted by your words, those of the repository's owner or a maintainer, or what the agent decided itself; what the agent quotes or sums up from someone else's text is not adopted.
142
142
 
143
143
  ## What Sphica can't do yet
@@ -219,14 +219,24 @@ Each release is built by GitHub Actions from a tag on the head of a pull request
219
219
  It is published only after the maintainer approves the release environment on GitHub, and it reaches npm through trusted publishing, with no stored token.
220
220
  The [npm page](https://www.npmjs.com/package/sphica#provenance) links to the workflow and the commit each release was built from.
221
221
 
222
+ Releases are signed. To check one yourself, run `npm init -y && npm install sphica && npm audit signatures` in an empty directory: it verifies npm's registry signature and the provenance attestation, which is signed through Sigstore, so there is no key to fetch. The attestation of the SBOM (the list of dependencies bundled into the package) for a tarball from `npm pack sphica@<version>` can be checked with `gh attestation verify sphica-<version>.tgz --repo iroha924/sphica --predicate-type https://cyclonedx.org/bom`.
223
+
224
+ How the parts fit together is in [ARCHITECTURE.md](https://github.com/iroha924/sphica/blob/main/ARCHITECTURE.md), and why the security claims hold is in [ASSURANCE.md](https://github.com/iroha924/sphica/blob/main/ASSURANCE.md).
225
+
222
226
  Dependabot opens weekly pull requests to update the GitHub Actions used in CI, and Renovate opens monthly ones for the npm dependencies bundled into the package.
223
227
 
224
228
  ## Contributing
225
229
 
226
- Issues are welcome. Pull requests from outside contributors are closed without review, because the review tools here run with maintainer credentials and cannot safely check out code written by others.
230
+ Come build something interesting together. Sphica is still small and there is plenty left to make. Ideas, bug reports, questions, and pull requests are all welcome, and small ones count: a typo fix or a "this part confused me" is a fine first contribution.
231
+
232
+ - **Not sure where to start?** Open an issue and say what you would like to try, or what got in your way. For a larger change, it is also the place to agree on the direction before you write any code.
233
+ - **Have a change ready?** Fork the repository and open a pull request. [CONTRIBUTING.md](https://github.com/iroha924/sphica/blob/main/CONTRIBUTING.md) walks through the setup, the checks, the commit rules, and how review works.
234
+ - **What happens next?** A pull request goes in once the maintainer has read and accepted it, so expect questions or requests for changes along the way. Only the maintainer merges.
227
235
 
228
236
  Changes that add or change behavior include automated tests in the same pull request. CI runs them with `bun run verify` on every pull request.
229
237
 
238
+ Everyone taking part follows the [code of conduct](https://github.com/iroha924/sphica/blob/main/CODE_OF_CONDUCT.md). Who decides what is in [GOVERNANCE.md](https://github.com/iroha924/sphica/blob/main/GOVERNANCE.md), and where the project is headed is in [ROADMAP.md](https://github.com/iroha924/sphica/blob/main/ROADMAP.md).
239
+
230
240
  ## License
231
241
 
232
242
  [MIT](https://github.com/iroha924/sphica/blob/main/LICENSE). The published package bundles its dependencies. Their licenses are listed in `THIRD_PARTY_NOTICES.md` inside the package.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 1 → 2 of generation 2: the owner can forget chosen sources.
2
5
  -- `sphica init` runs this in one transaction with foreign keys off (set outside the transaction), then checks foreign_key_check before
3
6
  -- committing. Every statement matches db/schema.sql at revision 2; server/test/migrate.test.ts compares a migrated database with a fresh one.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 2 → 3 of generation 2: a rejected option can carry a reconsider condition the owner stated, quoted as `reconsiders` evidence.
2
5
  -- `sphica init` runs this in one transaction with foreign keys off (set outside the transaction), then checks foreign_key_check before
3
6
  -- committing. Every statement matches db/schema.sql at revision 3; server/test/migrate.test.ts compares a migrated database with a fresh one.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 3 → 4 of generation 2: project-defined fields (field_def) and quoted field values (unit_field).
2
5
  -- `sphica init` runs this in one transaction with foreign keys off (set outside the transaction), then checks foreign_key_check before
3
6
  -- committing. Every statement matches db/schema.sql at revision 4; server/test/migrate.test.ts compares a migrated database with a fresh one.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Rows revision 5 cannot take and the migration must not change on its own. `sphica init` runs this first, inside the same transaction,
2
5
  -- and stops with every row listed when there is any; nothing is changed.
3
6
 
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 4 → 5 of generation 2: the write boundary, lifecycle transitions, indexes, checks, and unused vocabulary.
2
5
  -- `sphica init` runs this in one transaction with foreign keys off (set outside the transaction), then checks foreign_key_check before
3
6
  -- committing. Every statement matches db/schema.sql at revision 5; server/test/migrate.test.ts compares a migrated database with a fresh one.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 5 → 6 of generation 2: the subagent a delivery ran in (existing rows keep null, the main conversation), and a capture view
2
5
  -- that writes it while capture_delivery keeps its columns. `sphica init` runs this in one transaction with foreign keys off, then checks
3
6
  -- foreign_key_check. Every statement matches db/schema.sql at revision 6; server/test/migrate.test.ts compares the two.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 6 → 7 of generation 2: capture prunes the deliveries of sessions idle past a cutoff, so delivery_unit loses its cascade from
2
5
  -- delivery (capture may not delete through one) and delivery_ad removes the units. Runs in one transaction with foreign keys off; every
3
6
  -- statement matches db/schema.sql at revision 7, and server/test/migrate.test.ts compares the two.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Rows revision 8 cannot take and the migration must not change on its own. `sphica init` runs this first, inside the same transaction,
2
5
  -- and stops with every row listed when there is any; nothing of revision 8 is applied.
3
6
 
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 7 → 8 of generation 2: project keys are normalized, and triggers refuse a key that is not. Projects whose keys become one
2
5
  -- merge only when at most one holds rows: the one with rows, or the oldest, keeps its id and takes the key, and the empty others go.
3
6
  -- Every statement that stays is the same as in the schema at revision 8.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Both full-text indexes must hold terms() output as of revision 9, which includes the parts of camelCase and snake_case names, so they
2
5
  -- are rebuilt as `sphica doctor --reindex` does. Tables, views, and triggers are the same as at revision 8.
3
6
 
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Rows revision 9 cannot take and the migration must not change on its own. `sphica init` runs this first, inside the same transaction,
2
5
  -- and stops with every row listed when there is any; nothing of revision 10 is applied.
3
6
 
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 9 → 10 of generation 2: AI adoption. Evidence gains the role decides and adoption the route agent; each record tool call is
2
5
  -- logged (record_call), Claude Code's PreToolUse hook logs the turn of each (tool_call_observation), and a run names the call that began it.
3
6
  -- Triggers and views are dropped first and all created again: rebuilding a table fails while a trigger names it.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 10 → 11 of generation 2: a harvest run keeps the sources it may cite, chosen when it begins (harvest_run_source). A running
2
5
  -- harvest has none, so it is removed and its session gets "Begin again"; nothing cites a running run (a save also finishes it).
3
6
  -- Every statement that stays is the same as in the schema at revision 11.
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- Revision 11 → 12 of generation 2: glean keeps the owner's words that retired or moved an anchor (unit_anchor_retirement). Anchors
2
5
  -- retired before it have no reason row; nothing is inferred for them. Every statement is the same as in the schema at revision 12.
3
6
 
package/db/schema.sql CHANGED
@@ -1,3 +1,6 @@
1
+ -- Copyright (c) 2026 iroha924 and contributors
2
+ -- SPDX-License-Identifier: MIT
3
+
1
4
  -- The source of truth for Sphica's database (SQLite, `node:sqlite`): the memory of past implementation and decisions for one owner on one machine.
2
5
  -- Generation 2. `sphica_generation` holds the generation; `pragma user_version` is the revision within it.
3
6
  -- A database of another generation is refused without being changed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sphica",
3
- "version": "0.6.44",
3
+ "version": "0.6.46",
4
4
  "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
5
5
  "license": "MIT",
6
6
  "type": "module",