deep-projects 0.0.0-stage → 0.4.1

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Johannes Tebbert
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,121 @@
1
- # Temporary Holding Version
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/JoblessJoe/deep-projects/main/.github/assets/banner.svg" alt="deep-projects: project rooms for the DeepSeek Harness web GUI with a goal, memory, instructions and knowledge" width="100%">
3
+ </p>
2
4
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
5
+ <p align="center">
6
+ <a href="https://www.npmjs.com/package/deep-projects"><img src="https://img.shields.io/npm/v/deep-projects?color=4d6bfe&label=npm" alt="npm version"></a>
7
+ <a href="https://www.npmjs.com/package/deep-projects"><img src="https://img.shields.io/npm/dm/deep-projects?color=4d6bfe" alt="npm downloads"></a>
8
+ <img src="https://img.shields.io/badge/dependencies-0-4d6bfe" alt="zero runtime dependencies">
9
+ <a href="https://github.com/JoblessJoe/deep-projects/blob/main/LICENSE"><img src="https://img.shields.io/github/license/JoblessJoe/deep-projects?color=4d6bfe" alt="MIT license"></a>
10
+ <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/topic-dsh--plugin-0b6bcb" alt="dsh-plugin topic"></a>
11
+ </p>
12
+
13
+ A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) web GUI plugin that gives every project **its own room**: a goal, custom instructions, knowledge files and a memory your agents keep up to date. Start a chat in the room and the agent already knows the project. You never explain it twice. Think Claude Desktop's Projects, built for dsh and your local models.
14
+
15
+ ```bash
16
+ npx @deepseek-ai/dsh plugin --profile web add deep-projects
17
+ ```
18
+
19
+ Then restart your dsh web server and reload the tab. **Projects** appears in the sidebar. Full details under [Install](#install).
20
+
21
+ <p align="center">
22
+ <img src="https://raw.githubusercontent.com/JoblessJoe/deep-projects/main/.github/assets/projects-page.png" alt="The Projects page: project list on the left; goal, memory, knowledge files and instructions on the right" width="100%">
23
+ </p>
24
+
25
+ <p align="center">
26
+ <img src="https://raw.githubusercontent.com/JoblessJoe/deep-projects/main/.github/assets/sidebar.png" alt="Pinned projects in the dsh sidebar with their … menu open" width="430">
27
+ <br><sub>Pinned projects sit in the sidebar. The "…" menu opens, edits, pins, archives or deletes a project.</sub>
28
+ </p>
29
+
30
+ ## What's in a room
31
+
32
+ - **Goal**: what the project is for and what done looks like. Every chat sees it.
33
+ - **Memory**: facts, decisions and preferences, one bullet each. You add and edit them; agents add new ones as they learn and fix stale ones. Every chat sees it.
34
+ - **Custom instructions**: the project's `AGENTS.md`, edited in place.
35
+ - **Knowledge files**: drag and drop docs, specs and references for the agent to read.
36
+ - **Chats**: every chat started from the project runs in its folder and is listed under it.
37
+
38
+ ## Features
39
+
40
+ - **Projects page** with a filterable project list and one page per project.
41
+ - **Pinned projects in the sidebar**, styled like dsh's own rows. Click to open, or use the arrow to show the project's chats.
42
+ - **"…" menus** that match dsh's: open, new chat, edit, pin, archive, delete. Chat rows get dsh's usual chat menu.
43
+ - **Edit in place**: name, description and goal.
44
+ - **Archive**: hide finished projects without deleting anything. Restore any time.
45
+ - **Project tab** in the right sidebar of every chat that belongs to a project, plus a folder button in the chat header.
46
+ - **8 agent tools**, so agents can read and maintain projects themselves (see below).
47
+ - English and Chinese, light and dark theme, works on narrow screens. No runtime dependencies.
48
+
49
+ ## How it works
50
+
51
+ Each project is a plain folder:
52
+
53
+ ```text
54
+ ~/deep-projects/<slug>/
55
+ AGENTS.md custom instructions
56
+ AGENTS.local.md goal + memory
57
+ README.md description
58
+ knowledge/ your files
59
+ ```
60
+
61
+ dsh already loads `AGENTS.md` and `AGENTS.local.md` from a chat's working folder. Chats started from a project run in that folder, so the goal, memory and instructions reach the model **natively, with no prompt injection**. Everything is plain markdown: read it, edit it by hand, or commit it to git.
62
+
63
+ - **Host**: JSON routes under `/api/deep-projects/` on the dsh web server, plus the agent tools. All file access stays inside the projects folder.
64
+ - **Client**: one self-contained bundle. It uses dsh's own design tokens, icons and context menus, so it looks native in both themes.
65
+
66
+ ## Agent tools
67
+
68
+ | Tool | What it does |
69
+ | --- | --- |
70
+ | `projects_list` | List projects |
71
+ | `projects_create` | Create a project |
72
+ | `projects_read` | Read goal, instructions, memory and the knowledge list |
73
+ | `projects_update` | Change name, description, goal, instructions, pin or archive state |
74
+ | `projects_add_note` | Add one memory |
75
+ | `projects_set_memory` | Rewrite the memory list (fix, merge or remove entries) |
76
+ | `projects_add_knowledge` | Copy a file into the project's knowledge |
77
+ | `projects_delete` | Delete a project (its chats are kept) |
78
+
79
+ The memory file tells agents to keep it current, so they record new facts without being asked.
80
+
81
+ ## Install
82
+
83
+ Into your dsh **web profile** (`web` below is the profile name; use whichever profile backs your web GUI). From a source checkout, use `pnpm dsh` instead of `npx @deepseek-ai/dsh`:
84
+
85
+ ```bash
86
+ npx @deepseek-ai/dsh plugin --profile web add deep-projects
87
+ ```
88
+
89
+ Restart the dsh web server afterwards (the plugin adds a new profile entry), then reload the browser tab.
90
+
91
+ Other sources:
92
+
93
+ ```bash
94
+ # straight from GitHub
95
+ npx @deepseek-ai/dsh plugin --profile web add github:JoblessJoe/deep-projects
96
+ # from a local checkout
97
+ npx @deepseek-ai/dsh plugin --profile web add file:/path/to/deep-projects
98
+ ```
99
+
100
+ **Projects folder**: `~/deep-projects` by default. Set `DSH_PROJECTS_ROOT` in the dsh server's environment to use another folder.
101
+
102
+ **Requirements**: the dsh web GUI, dsh 0.2.2 or newer (`engines.dsh`: `>=0.2.2-rc.1 <0.4.0-0`), Node 20+.
103
+
104
+ ### Sidebar chat tree (optional)
105
+
106
+ On stock dsh, pinned projects show up as plain sidebar rows that open the project. dsh has no plugin seat yet for a block between the panel rows and the workspace list, so the expandable version (arrow, chats underneath, "…" menu right in the sidebar) needs a small `ui-sidebar` patch: [`patches/ui-sidebar-projects-seat.patch`](https://github.com/JoblessJoe/deep-projects/blob/main/patches/ui-sidebar-projects-seat.patch). With it applied, the plugin switches to that view by itself. Everything else works without it.
107
+
108
+ **Let your agent do it:** give your coding agent [`patches/AGENT-INSTRUCTIONS.md`](https://github.com/JoblessJoe/deep-projects/blob/main/patches/AGENT-INSTRUCTIONS.md). It checks your dsh version, applies the patch, rebuilds the sidebar package and tells you when to restart. The patch needs a dsh source checkout; it can't be applied to an npm-installed dsh.
109
+
110
+ ## Develop
111
+
112
+ ```bash
113
+ npm install
114
+ npm run build # lib/index.js (host) + lib/client.js (web)
115
+ node scripts/smoke.mjs # routes + agent tools against a temp folder
116
+ DSH_REPO=/path/to/deepseek-harness node scripts/validate-tools.mjs # dsh's real tool validator
117
+ ```
118
+
119
+ ## License
120
+
121
+ MIT
@@ -0,0 +1,7 @@
1
+ # deep-projects bundle mount.
2
+ # A NEW plugin contributes a brand-new profile entry, so the row is an `insert:`
3
+ # (a bare `- id:` would patch an existing entry by id and fail silently).
4
+ # Adding a new `insert:` requires a web-server restart to take effect.
5
+ - insert:
6
+ - id: deep-projects
7
+ name: 'deep-projects'
package/icon.svg ADDED
@@ -0,0 +1,4 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
2
+ <path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7z"/>
3
+ <path d="M3 11h18" opacity="0.5"/>
4
+ </svg>