sphica 0.6.65 → 0.6.67
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 +18 -0
- package/dist/capture.js +18 -2
- package/dist/cli.js +18 -2
- package/dist/deliver.js +18 -2
- package/dist/mcp-record.js +18 -2
- 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.67",
|
|
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
|
@@ -83,6 +83,20 @@ codex plugin add sphica@sphica
|
|
|
83
83
|
|
|
84
84
|
In Codex, open `/hooks` and mark Sphica's hooks as trusted. Automatic recording does not start until you do. If a plugin update changes the hooks, trust them again. The "Codex hooks" line of `sphica doctor` shows how many are trusted (for Codex 0.160.0).
|
|
85
85
|
|
|
86
|
+
Optional, Claude Code only: a pane that lists what Sphica handed the agent in this session.
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
claude plugin install sphica-pane@sphica
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Run `/sphica-pane` to open it, and press ctrl+x then x to close it. Newest first, it shows the current work and constraints given at session start, the records given before a read, an edit, or a prompt, and the reason when Sphica stopped a shell call.
|
|
93
|
+
|
|
94
|
+
- It needs Claude Code 2.1.300 or later, the version its checks run on. Older Claude Code fails to load it, and Sphica itself keeps working.
|
|
95
|
+
- It is a Claude Code mod, so it runs with Claude Code's permissions. It only reads what the hooks returned and passes that on unchanged. It writes nothing, reads no files, and sends nothing anywhere.
|
|
96
|
+
- It recognizes Sphica's text by its wording, so text another plugin writes in the same words shows too. Treat it as a view, not a record.
|
|
97
|
+
- Where an organization manages Claude Code, the hooks it reads run only for plugins the organization lists, so the pane stays empty.
|
|
98
|
+
- Codex has no mods. `codex plugin list` shows sphica-pane too, but do not install it there: Codex warns about its hooks file in every session.
|
|
99
|
+
|
|
86
100
|
**3. Set up in your repository**
|
|
87
101
|
|
|
88
102
|
```bash
|
|
@@ -193,6 +207,8 @@ claude plugin marketplace update sphica
|
|
|
193
207
|
claude plugin update sphica@sphica
|
|
194
208
|
```
|
|
195
209
|
|
|
210
|
+
If you installed the pane, update it too with `claude plugin update sphica-pane@sphica`. A fix to it comes with the next Sphica release.
|
|
211
|
+
|
|
196
212
|
Codex:
|
|
197
213
|
|
|
198
214
|
```bash
|
|
@@ -216,6 +232,8 @@ codex plugin remove sphica@sphica && codex plugin marketplace remove sphica
|
|
|
216
232
|
npm uninstall -g sphica
|
|
217
233
|
```
|
|
218
234
|
|
|
235
|
+
If you installed the pane, remove it first with `claude plugin uninstall sphica-pane@sphica`. Removing the pane alone leaves Sphica working.
|
|
236
|
+
|
|
219
237
|
## Troubleshooting
|
|
220
238
|
|
|
221
239
|
Run `sphica doctor` first. It shows which part is out of date or not working. Common cases:
|
package/dist/capture.js
CHANGED
|
@@ -12026,7 +12026,7 @@ var sessionId = (projectId, host, externalId) => uuidFrom(String(projectId), hos
|
|
|
12026
12026
|
import fs5 from "node:fs";
|
|
12027
12027
|
import os3 from "node:os";
|
|
12028
12028
|
import path5 from "node:path";
|
|
12029
|
-
function
|
|
12029
|
+
function marksDir() {
|
|
12030
12030
|
const user = (() => {
|
|
12031
12031
|
try {
|
|
12032
12032
|
return os3.userInfo().username;
|
|
@@ -12034,9 +12034,25 @@ function markOnce(kind, key) {
|
|
|
12034
12034
|
return String(process.getuid?.() ?? "user");
|
|
12035
12035
|
}
|
|
12036
12036
|
})();
|
|
12037
|
-
|
|
12037
|
+
return path5.join(os3.tmpdir(), `sphica-${sha256(user).toString("hex").slice(0, 12)}`);
|
|
12038
|
+
}
|
|
12039
|
+
function ours(dir) {
|
|
12040
|
+
if (process.platform === "win32" || !process.getuid)
|
|
12041
|
+
return true;
|
|
12042
|
+
const st = fs5.lstatSync(dir);
|
|
12043
|
+
return st.isDirectory() && st.uid === process.getuid() && (st.mode & 63) === 0;
|
|
12044
|
+
}
|
|
12045
|
+
function markOnce(kind, key) {
|
|
12046
|
+
const top = marksDir();
|
|
12047
|
+
const dir = path5.join(top, kind);
|
|
12038
12048
|
try {
|
|
12039
12049
|
fs5.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
12050
|
+
if (!ours(top))
|
|
12051
|
+
return true;
|
|
12052
|
+
} catch {
|
|
12053
|
+
return true;
|
|
12054
|
+
}
|
|
12055
|
+
try {
|
|
12040
12056
|
fs5.writeFileSync(path5.join(dir, sha256(key).toString("hex").slice(0, 24)), "", { flag: "wx" });
|
|
12041
12057
|
return true;
|
|
12042
12058
|
} catch (e) {
|
package/dist/cli.js
CHANGED
|
@@ -16406,7 +16406,7 @@ var sessionId = (projectId, host, externalId) => uuidFrom(String(projectId), hos
|
|
|
16406
16406
|
import fs7 from "node:fs";
|
|
16407
16407
|
import os4 from "node:os";
|
|
16408
16408
|
import path7 from "node:path";
|
|
16409
|
-
function
|
|
16409
|
+
function marksDir() {
|
|
16410
16410
|
const user = (() => {
|
|
16411
16411
|
try {
|
|
16412
16412
|
return os4.userInfo().username;
|
|
@@ -16414,9 +16414,25 @@ function markOnce(kind, key) {
|
|
|
16414
16414
|
return String(process.getuid?.() ?? "user");
|
|
16415
16415
|
}
|
|
16416
16416
|
})();
|
|
16417
|
-
|
|
16417
|
+
return path7.join(os4.tmpdir(), `sphica-${sha2562(user).toString("hex").slice(0, 12)}`);
|
|
16418
|
+
}
|
|
16419
|
+
function ours(dir) {
|
|
16420
|
+
if (process.platform === "win32" || !process.getuid)
|
|
16421
|
+
return true;
|
|
16422
|
+
const st = fs7.lstatSync(dir);
|
|
16423
|
+
return st.isDirectory() && st.uid === process.getuid() && (st.mode & 63) === 0;
|
|
16424
|
+
}
|
|
16425
|
+
function markOnce(kind, key) {
|
|
16426
|
+
const top = marksDir();
|
|
16427
|
+
const dir = path7.join(top, kind);
|
|
16418
16428
|
try {
|
|
16419
16429
|
fs7.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
16430
|
+
if (!ours(top))
|
|
16431
|
+
return true;
|
|
16432
|
+
} catch {
|
|
16433
|
+
return true;
|
|
16434
|
+
}
|
|
16435
|
+
try {
|
|
16420
16436
|
fs7.writeFileSync(path7.join(dir, sha2562(key).toString("hex").slice(0, 24)), "", { flag: "wx" });
|
|
16421
16437
|
return true;
|
|
16422
16438
|
} catch (e) {
|
package/dist/deliver.js
CHANGED
|
@@ -12124,7 +12124,7 @@ var sessionId = (projectId, host, externalId) => uuidFrom(String(projectId), hos
|
|
|
12124
12124
|
import fs5 from "node:fs";
|
|
12125
12125
|
import os3 from "node:os";
|
|
12126
12126
|
import path6 from "node:path";
|
|
12127
|
-
function
|
|
12127
|
+
function marksDir() {
|
|
12128
12128
|
const user = (() => {
|
|
12129
12129
|
try {
|
|
12130
12130
|
return os3.userInfo().username;
|
|
@@ -12132,9 +12132,25 @@ function markOnce(kind, key) {
|
|
|
12132
12132
|
return String(process.getuid?.() ?? "user");
|
|
12133
12133
|
}
|
|
12134
12134
|
})();
|
|
12135
|
-
|
|
12135
|
+
return path6.join(os3.tmpdir(), `sphica-${sha256(user).toString("hex").slice(0, 12)}`);
|
|
12136
|
+
}
|
|
12137
|
+
function ours(dir) {
|
|
12138
|
+
if (process.platform === "win32" || !process.getuid)
|
|
12139
|
+
return true;
|
|
12140
|
+
const st = fs5.lstatSync(dir);
|
|
12141
|
+
return st.isDirectory() && st.uid === process.getuid() && (st.mode & 63) === 0;
|
|
12142
|
+
}
|
|
12143
|
+
function markOnce(kind, key) {
|
|
12144
|
+
const top = marksDir();
|
|
12145
|
+
const dir = path6.join(top, kind);
|
|
12136
12146
|
try {
|
|
12137
12147
|
fs5.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
12148
|
+
if (!ours(top))
|
|
12149
|
+
return true;
|
|
12150
|
+
} catch {
|
|
12151
|
+
return true;
|
|
12152
|
+
}
|
|
12153
|
+
try {
|
|
12138
12154
|
fs5.writeFileSync(path6.join(dir, sha256(key).toString("hex").slice(0, 24)), "", { flag: "wx" });
|
|
12139
12155
|
return true;
|
|
12140
12156
|
} catch (e) {
|
package/dist/mcp-record.js
CHANGED
|
@@ -46974,7 +46974,7 @@ var sessionId = (projectId, host, externalId) => uuidFrom(String(projectId), hos
|
|
|
46974
46974
|
import fs5 from "node:fs";
|
|
46975
46975
|
import os3 from "node:os";
|
|
46976
46976
|
import path5 from "node:path";
|
|
46977
|
-
function
|
|
46977
|
+
function marksDir() {
|
|
46978
46978
|
const user = (() => {
|
|
46979
46979
|
try {
|
|
46980
46980
|
return os3.userInfo().username;
|
|
@@ -46982,9 +46982,25 @@ function markOnce(kind, key) {
|
|
|
46982
46982
|
return String(process.getuid?.() ?? "user");
|
|
46983
46983
|
}
|
|
46984
46984
|
})();
|
|
46985
|
-
|
|
46985
|
+
return path5.join(os3.tmpdir(), `sphica-${sha256(user).toString("hex").slice(0, 12)}`);
|
|
46986
|
+
}
|
|
46987
|
+
function ours(dir) {
|
|
46988
|
+
if (process.platform === "win32" || !process.getuid)
|
|
46989
|
+
return true;
|
|
46990
|
+
const st = fs5.lstatSync(dir);
|
|
46991
|
+
return st.isDirectory() && st.uid === process.getuid() && (st.mode & 63) === 0;
|
|
46992
|
+
}
|
|
46993
|
+
function markOnce(kind, key) {
|
|
46994
|
+
const top = marksDir();
|
|
46995
|
+
const dir = path5.join(top, kind);
|
|
46986
46996
|
try {
|
|
46987
46997
|
fs5.mkdirSync(dir, { recursive: true, mode: 448 });
|
|
46998
|
+
if (!ours(top))
|
|
46999
|
+
return true;
|
|
47000
|
+
} catch {
|
|
47001
|
+
return true;
|
|
47002
|
+
}
|
|
47003
|
+
try {
|
|
46988
47004
|
fs5.writeFileSync(path5.join(dir, sha256(key).toString("hex").slice(0, 24)), "", { flag: "wx" });
|
|
46989
47005
|
return true;
|
|
46990
47006
|
} catch (e) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sphica",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.67",
|
|
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",
|