deskssh 0.0.1 → 0.0.2

package/README.md

@@ -1,66 +1,11 @@
-<h1 align="center">DeskSSH</h1>
+# DeskSSH
 
-<p align="center">
-  <strong>A graphical desktop over plain SSH.</strong><br>
-  The GUI is synthesized on the client; every action is translated into commands
-  executed on the remote host. <em>It is not remote desktop.</em>
-</p>
+**A graphical desktop over plain SSH.** The GUI is synthesized on the client and
+every action is translated into commands executed on the remote host. _Not remote
+desktop. Agentless._
 
----
+> ⚠️ **Early development — not yet functional.** This `0.0.1` reserves the package
+> name and provides the future `deskssh` launch command. Follow progress on GitHub.
 
-## What is it?
-
-You connect via SSH to a server **with no graphical environment** and DeskSSH
-shows you a familiar desktop —file manager, terminal, system monitor, editor,
-service manager…—. Behind the scenes, every click runs the equivalent command
-(`ls`, `stat`, `mv`, `systemctl`, `ps`…) and the interface is built from its
-output.
-
-### What makes it different
-
-- **Not VNC/RDP/X.** No pixels travel: the GUI is generated locally.
-- **Agentless.** Installs nothing on the server; only needs SSH and standard POSIX
-  utilities.
-- **Transparent.** You can always see the command behind each action.
-- **100% open source.**
-
-## Origin and motivation
-
-DeskSSH started as a project in **ASP.NET with .NET 8**. As it grew, I felt
-overwhelmed by the sheer number of commands and cases the tool could end up
-covering. I began reviewing and improving the code with the help of AI, but ended
-up making a more radical decision: **restart the project from scratch**, also with
-AI, in order to:
-
-- use languages and technologies **more widely accepted by the community**, and
-- leverage **npm's ease of distribution** for simple adoption.
-
-This rewrite is developed with **Spec-Driven Development**: decisions are
-documented in `specs/` before any code is written.
-
-The reason for making it **open source** is simple: I want DeskSSH to become a
-**genuinely useful and popular** tool, built and improved by the community.
-
-## Status
-
-🚧 **In design.** The project is developed with **Spec-Driven Development**: right
-now only the specification exists; code comes later. Start with:
-
-- [`specs/vision.md`](specs/vision.md) — the why and the where-to (the vision).
-- [`specs/constitution.md`](specs/constitution.md) — the project's principles.
-- [`specs/001-core/spec.md`](specs/001-core/spec.md) — what DeskSSH does.
-- [`specs/001-core/plan.md`](specs/001-core/plan.md) — how it will be built.
-- [`specs/glossary.md`](specs/glossary.md) — the domain vocabulary.
-
-## How to contribute
-
-This project follows SDD: design discussions happen in `specs/` **before** they
-reach the code. To propose something, open the conversation on the relevant
-document. (Detailed contribution guide: pending — `M0`.)
-
-## License
-
-[**GNU AGPL-3.0-or-later**](LICENSE). Strong copyleft with a network clause: if you
-modify DeskSSH and offer it as a network-accessible service, you must publish your
-changes. Chosen so the project and all its improvements stay free. See
-[`specs/constitution.md`](specs/constitution.md), Article 9.
+- Repository & docs: https://github.com/nestorrguez/DeskSSH
+- License: **AGPL-3.0-or-later**

package/package.json

@@ -1,51 +1,37 @@
 {
   "name": "deskssh",
-  "version": "0.0.1",
-  "private": false,
-  "description": "A graphical desktop over plain SSH — workspace root",
+  "version": "0.0.2",
+  "description": "A graphical desktop over plain SSH. Early development — not yet functional.",
   "license": "AGPL-3.0-or-later",
   "type": "module",
-  "engines": {
-    "node": ">=20"
-  },
-  "packageManager": "pnpm@9.15.9",
-  "scripts": {
-    "build": "pnpm -r build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc -b",
-    "lint": "eslint .",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
-  },
-  "devDependencies": {
-    "@types/node": "^20.14.0",
-    "@typescript-eslint/eslint-plugin": "^7.13.0",
-    "@typescript-eslint/parser": "^7.13.0",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^9.1.0",
-    "prettier": "^3.3.2",
-    "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
-  },
-  "main": "index.js",
-  "dependencies": {
-    "eslint-scope": "^7.2.2",
-    "eslint-visitor-keys": "^3.4.3"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nestorrguez/DeskSSH.git"
+  "bin": {
+    "deskssh": "bin/deskssh.js"
   },
+  "files": [
+    "bin",
+    "README.md"
+  ],
   "keywords": [
     "ssh",
-    "desk",
+    "sftp",
     "gui",
-    "client"
+    "desktop",
+    "sysadmin",
+    "devops",
+    "agentless"
   ],
-  "author": "Nestor Rodriguez",
+  "homepage": "https://github.com/nestorrguez/DeskSSH",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nestorrguez/DeskSSH.git"
+  },
   "bugs": {
     "url": "https://github.com/nestorrguez/DeskSSH/issues"
   },
-  "homepage": "https://github.com/nestorrguez/DeskSSH#readme"
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "true"
+  }
 }

package/.eslintrc.cjs

@@ -1,21 +0,0 @@
-/* eslint-env node */
-module.exports = {
-  root: true,
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    ecmaVersion: 2022,
-    sourceType: 'module',
-    ecmaFeatures: { jsx: true },
-  },
-  plugins: ['@typescript-eslint'],
-  extends: ['eslint:recommended', 'plugin:@typescript-eslint/recommended', 'prettier'],
-  env: {
-    es2022: true,
-    node: true,
-    browser: true,
-  },
-  ignorePatterns: ['dist', 'node_modules', '*.cjs'],
-  rules: {
-    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-  },
-};

package/.github/workflows/ci.yml

@@ -1,40 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Format check
-        run: pnpm format:check
-
-      - name: Lint
-        run: pnpm lint
-
-      - name: Typecheck
-        run: pnpm typecheck && pnpm --filter @deskssh/web typecheck
-
-      - name: Test
-        run: pnpm test
-
-      - name: Build
-        run: pnpm build

package/.prettierignore

@@ -1,5 +0,0 @@
-node_modules
-dist
-build
-pnpm-lock.yaml
-LICENSE

package/.prettierrc.json

@@ -1,6 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "trailingComma": "all",
-  "printWidth": 100
-}

package/CONTRIBUTING.md

@@ -1,59 +0,0 @@
-# Contributing to DeskSSH
-
-Thanks for your interest in DeskSSH! This project is built with **Spec-Driven
-Development (SDD)**: design decisions are made in `specs/` **before** they reach the
-code. That keeps the project coherent and lets anyone understand _why_ things are
-the way they are.
-
-## Ground rules
-
-- **English only** in the repository (code, comments, docs, commit messages, specs).
-  The repo is public and international.
-- **Read the specs first.** Start with [`specs/vision.md`](specs/vision.md) and
-  [`specs/constitution.md`](specs/constitution.md). The constitution lists
-  **non-negotiable** principles — if a change conflicts with one, it won't be
-  accepted unless the constitution is explicitly amended.
-- **Spec before code.** No behavior change lands without the spec being updated
-  first. For a non-trivial change, open a discussion/PR on the relevant document in
-  `specs/` before writing code.
-- **Traceability.** Functional requirements have IDs (`FR-XXX`). Reference the
-  `FR-`/Article a change serves in the spec, tasks and PR description.
-
-## Project layout
-
-```
-specs/                  Source of truth (vision, constitution, glossary, 001-core/*)
-packages/
-  core/                 Frontend-agnostic core (SSH sessions, adapters, contract)
-  server/               Web gateway (keeps SSH sessions, exposes the API)
-  web/                  Browser UI (desktop shell + app views)
-```
-
-## Local development
-
-Requirements: **Node.js >= 20** and **pnpm 9** (`corepack enable pnpm` or
-`npm i -g pnpm@9`).
-
-```bash
-pnpm install        # install all workspaces
-pnpm typecheck      # type-check core + server
-pnpm lint           # ESLint
-pnpm test           # Vitest
-pnpm build          # build all packages
-pnpm format         # apply Prettier
-```
-
-CI runs format-check, lint, typecheck, test and build on every push/PR — please make
-sure they pass locally first.
-
-## Commits & pull requests
-
-- Keep commits focused; write clear messages in English.
-- Describe **what** and **why**, and reference the `FR-`/Article involved.
-- Be kind and constructive. DeskSSH aims to be a welcoming, accessibility-first
-  project.
-
-## License
-
-By contributing, you agree that your contributions are licensed under
-**AGPL-3.0-or-later**, the project's license.