@tinchu0/knitt 0.1.0-beta.1 → 0.1.0-beta.2
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/README.md +19 -12
- package/dist/apps/server/src/conversation-server.js +203 -0
- package/dist/apps/server/src/server.js +147 -37
- package/dist/memory-schema.json +1 -0
- package/dist/packages/adapters/src/cli.js +163 -15
- package/dist/packages/adapters/src/command.js +149 -18
- package/dist/packages/adapters/src/discovery.js +128 -0
- package/dist/packages/adapters/src/hooks.js +96 -23
- package/dist/packages/adapters/src/launch.js +10 -3
- package/dist/packages/adapters/src/providers/jsonl.js +105 -0
- package/dist/packages/adapters/src/repository.js +21 -5
- package/dist/packages/adapters/src/status.js +81 -0
- package/dist/packages/adapters/src/transcript.js +70 -15
- package/dist/packages/contracts/src/conversations.js +30 -0
- package/dist/packages/installer/src/cli.js +190 -75
- package/dist/packages/installer/src/connections.js +208 -82
- package/dist/packages/installer/src/runtime.js +94 -37
- package/dist/packages/memory/src/checkpoints.js +68 -0
- package/dist/packages/memory/src/context.js +91 -0
- package/dist/packages/memory/src/conversations.js +148 -0
- package/dist/packages/memory/src/migrations.js +55 -0
- package/dist/packages/memory/src/store.js +201 -23
- package/dist/skills/continue-chat/SKILL.md +1 -1
- package/docs/clients/local-agent-memory.md +50 -0
- package/docs/clients/npm-installation.md +17 -12
- package/package.json +4 -3
|
@@ -1,25 +1,25 @@
|
|
|
1
1
|
# npm installation and runtime lifecycle
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Install the npm preview
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Run the published CLI:
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
npm run build
|
|
11
|
-
npm pack
|
|
8
|
+
npx @tinchu0/knitt@latest setup \
|
|
9
|
+
--workspace /path/to/project --client codex --client claude-code
|
|
12
10
|
```
|
|
13
11
|
|
|
14
|
-
|
|
12
|
+
Add `--capture-new-sessions` to opt into independent local conversation histories and checkpoint-first handoffs. Version `0.1.0-beta.2` remains a preview. Both `latest` and `next` track the current preview release.
|
|
13
|
+
|
|
14
|
+
To test a source checkout before publication, run `npm ci`, `npm run check`, `npm run build` and `npm pack`, then install its exact artifact:
|
|
15
15
|
|
|
16
16
|
```bash
|
|
17
|
-
npx --yes --package ./tinchu0-knitt-0.1.0-beta.
|
|
17
|
+
npx --yes --package ./tinchu0-knitt-0.1.0-beta.2.tgz knitt setup \
|
|
18
18
|
--workspace /path/to/project --client codex --client claude-code \
|
|
19
|
-
--package /absolute/path/to/tinchu0-knitt-0.1.0-beta.
|
|
19
|
+
--package /absolute/path/to/tinchu0-knitt-0.1.0-beta.2.tgz
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
The outer `--package`
|
|
22
|
+
The outer `--package` selects the CLI; the `--package` after `setup` selects the artifact to install persistently. Without that inner option, setup installs the CLI's exact published version. `update` follows `next` for prerelease CLIs and `latest` for stable CLIs.
|
|
23
23
|
|
|
24
24
|
Use `--preview` to inspect changes without creating installation/configuration files. Interactive setup asks before applying; automation must pass `--yes`. Repeat `--client` for several agents. Setup requires Git repository metadata to derive a stable repository identity.
|
|
25
25
|
|
|
@@ -38,7 +38,7 @@ The project-local `.memory/npm-connection.json` records original and generated s
|
|
|
38
38
|
|
|
39
39
|
## Commands
|
|
40
40
|
|
|
41
|
-
Run commands through
|
|
41
|
+
Run commands through `npx @tinchu0/knitt@latest` or the tarball CLI above:
|
|
42
42
|
|
|
43
43
|
```text
|
|
44
44
|
knitt setup --workspace PATH --client codex --preview
|
|
@@ -57,6 +57,11 @@ Uninstall restores unchanged managed values and preserves independent additions
|
|
|
57
57
|
|
|
58
58
|
## Release gates
|
|
59
59
|
|
|
60
|
-
The
|
|
60
|
+
The package is `@tinchu0/knitt`, published under npm account `tinchu0`, with Apache-2.0 licensing. The LICENSE file ships in the npm archive. Release `0.1.0-beta.2` includes opt-in local conversation memory. Native Windows setup deliberately fails rather than writing POSIX hook commands. Linux tarball checks are the local verification target; macOS/Windows live client behavior remains unverified.
|
|
61
61
|
|
|
62
62
|
ChatGPT, Claude web and teammate machines require a separately reachable authenticated service. Packaging a CLI does not supply hosting, authentication accounts or background synchronization.
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
### Optional local conversation mode
|
|
66
|
+
|
|
67
|
+
Add `--capture-new-sessions` to setup to opt a connected project into independent session capture and explicit continuation links. The preference survives subsequent setup/update operations. Existing connections keep their previous semantics until opted in. This mode upgrades the database using consistent SQLite backups; the updated installer blocks incompatible runtime downgrade rather than restoring data automatically. Use `doctor` for content-free capture status. See [setup and recovery](local-agent-memory.md).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tinchu0/knitt",
|
|
3
|
-
"version": "0.1.0-beta.
|
|
3
|
+
"version": "0.1.0-beta.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"engines": {
|
|
6
6
|
"node": ">=24"
|
|
@@ -36,7 +36,8 @@
|
|
|
36
36
|
"README.md",
|
|
37
37
|
"docs/clients/connector-setup.md",
|
|
38
38
|
"docs/clients/npm-installation.md",
|
|
39
|
-
"LICENSE"
|
|
39
|
+
"LICENSE",
|
|
40
|
+
"docs/clients/local-agent-memory.md"
|
|
40
41
|
],
|
|
41
42
|
"repository": {
|
|
42
43
|
"type": "git",
|
|
@@ -45,7 +46,7 @@
|
|
|
45
46
|
"description": "Shared conversation memory for coding agents",
|
|
46
47
|
"publishConfig": {
|
|
47
48
|
"access": "public",
|
|
48
|
-
"tag": "
|
|
49
|
+
"tag": "latest"
|
|
49
50
|
},
|
|
50
51
|
"license": "Apache-2.0"
|
|
51
52
|
}
|