Devian v10 — Workspace Manager

Manage the single workspace structure and npm policies for Devian TypeScript v10 framework projects.

What This Skill Does

This skill helps you work with Devian v10 TypeScript projects by enforcing workspace structure rules, managing npm dependencies, and providing build/archive/dev operations. It ensures that all npm operations happen at the workspace root and prevents common misconfigurations.

Instructions

1. Workspace Structure Enforcement

**Hard Rules (MUST follow):**

When working with the project:

1. Always verify you're in `framework-ts/` directory before npm commands

2. If you detect `package-lock.json` or `node_modules` in subfolders, warn the user

3. All npm operations must run from workspace root: `cd framework-ts && npm install`

2. Root package.json Configuration

The root `framework-ts/package.json` should contain:

```json

{

"name": "devian-framework-ts",

"version": "10.0.0",

"type": "module",

"private": true,

"workspaces": [

"module/*",

"apps/*",

"tools/*"

],

"scripts": {

"builder": "npm -w builder run build --",

"archive": "npm -w archive run archive --",

"dev:client": "npm -w game-client run dev",

"start:server": "npm -w game-server run start"

}

}

```

3. Available Scripts

Provide these commands to users based on their needs:

| Task | Command | Example |

|------|---------|---------|

| Build project | `npm run builder -- ../path/to/input.json` | `npm run builder -- ../input/input_common.json` |

| Archive project | `npm run archive -- <args>` | `npm run archive -- --output dist.zip` |

| Dev client | `npm run dev:client` | Starts development server |

| Start server | `npm run start:server` | Starts game server |

**Usage Pattern:**

```bash

cd framework-ts

npm run builder -- ../input/input_common.json

```

4. TypeScript Configuration

Verify `framework-ts/tsconfig.json` contains:

```json

{

"compilerOptions": {

"target": "ES2020",

"module": "ESNext",

"moduleResolution": "node",

"baseUrl": ".",

"paths": {

"@devian/core": ["./module/devian/src"]

}

}

}

```

5. Dependency Installation

**CI/CD Environment:**

```bash

cd framework-ts

npm ci

```

**Development Environment:**

```bash

cd framework-ts

npm install

```

**Recovery Procedure (lockfile corruption):**

```bash

cd framework-ts

rm -rf node_modules package-lock.json

npm install

```

6. Validation Checklist

Before completing any task, verify:

7. Error Handling

If you encounter these issues:

**Issue**: Dependencies not found

**Solution**:

```bash

cd framework-ts

npm install

```

**Issue**: Multiple lockfiles detected

**Solution**:

```bash

find . -name "package-lock.json" -not -path "./framework-ts/package-lock.json" -delete

cd framework-ts

npm install

```

**Issue**: Build fails with module errors

**Solution**: Check `tsconfig.json` paths and workspace configuration

Examples

Example 1: Initial Setup

```bash

cd framework-ts

npm install

npm run builder -- ../input/input_common.json

```

Example 2: Start Development

```bash

cd framework-ts

npm run dev:client

In another terminal

npm run start:server

```

Example 3: Clean Install (CI)

```bash

cd framework-ts

npm ci

npm run builder -- ../input/production.json

```

Constraints

Related Skills