sphica 0.6.45 → 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.
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/README.md +7 -1
- package/db/migrations/0002.sql +3 -0
- package/db/migrations/0003.sql +3 -0
- package/db/migrations/0004.sql +3 -0
- package/db/migrations/0005.check.sql +3 -0
- package/db/migrations/0005.sql +3 -0
- package/db/migrations/0006.sql +3 -0
- package/db/migrations/0007.sql +3 -0
- package/db/migrations/0008.check.sql +3 -0
- package/db/migrations/0008.sql +3 -0
- package/db/migrations/0009.sql +3 -0
- package/db/migrations/0010.check.sql +3 -0
- package/db/migrations/0010.sql +3 -0
- package/db/migrations/0011.sql +3 -0
- package/db/migrations/0012.sql +3 -0
- package/db/schema.sql +3 -0
- package/package.json +1 -1
|
@@ -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.
|
|
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",
|
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 `
|
|
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,6 +219,10 @@ 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
|
|
@@ -231,6 +235,8 @@ Come build something interesting together. Sphica is still small and there is pl
|
|
|
231
235
|
|
|
232
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.
|
|
233
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
|
+
|
|
234
240
|
## License
|
|
235
241
|
|
|
236
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.
|
package/db/migrations/0002.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0003.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0004.sql
CHANGED
|
@@ -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
|
|
package/db/migrations/0005.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0006.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0007.sql
CHANGED
|
@@ -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
|
|
package/db/migrations/0008.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0009.sql
CHANGED
|
@@ -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
|
|
package/db/migrations/0010.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0011.sql
CHANGED
|
@@ -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.
|
package/db/migrations/0012.sql
CHANGED
|
@@ -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.
|
|
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",
|