Vector OS Team Hub

Vector OS Team Hub is a polished VS Code extension for lightweight team coordination and task management inside the editor. It provides an admin-focused dashboard for creating teams, adding members, assigning dated tasks and tracking work health, plus a streamlined member view for daily work.

This README is optimized for the Visual Studio Marketplace listing — clear value proposition, usage guidance, and publishing details to help users and reviewers quickly evaluate the extension.

Highlights

• Admin-first dashboard: create teams, invite members, and manage permissions from within VS Code.
• Fast task assignment: create tasks with title, description, due date, priority and assignee.
• Sidebar & webview: quick access via the explorer sidebar plus a rich webview dashboard for analytics and guidance.
• Member mode: switch to a focused personal view to see daily tasks and next actions.
• Local-first store: lightweight persistence using VS Code memento APIs (no external backend required).

Install

1. Install from the Visual Studio Marketplace: search for "Vector OS Team Hub" or visit the extension page.
2. Or install locally with the packaged VSIX:

npx @vscode/vsce package
code --install-extension .\vector-os-team-hub-0.0.4.vsix

Quick Start

1. Open the Command Palette (Ctrl/Cmd+Shift+P) and run Vector Team Hub: Open Dashboard to launch the admin dashboard.
2. Use quick actions to Create team, Add member, and Assign task.
3. Members can sign in (Microsoft / Google) and view their daily tasks from the sidebar or dashboard.

Setup in VS Code

1. Open this repository folder in VS Code.
2. Install dependencies in the integrated terminal:

npm install

3. Build the extension:

npm run compile

4. Run the extension for development: press F5 to open the Extension Development Host.

5. Debug webviews: in the Extension Development Host window open Help → Toggle Developer Tools to view console logs and network traces for webview content.

How to use (step‑by‑step)

1. Open the dashboard

• Open the Command Palette (Ctrl/Cmd+Shift+P) and run Vector Team Hub: Open Dashboard.

2. Sign in (optional, recommended)

• Use Vector Team Hub: Sign In or the Sign in with Microsoft / Sign in with Google commands to link an account. This makes it easier to map members to real accounts.

3. Create a team

• From the dashboard click Create team or run Vector Team Hub: Create Team and provide a name and optional focus/description.

4. Add members

• Use Add member in the dashboard or run Vector Team Hub: Add Member. Provide a name, email (optional), and role (admin or member).

5. Assign tasks

• Use Assign task or Vector Team Hub: Open Task Creator UI for a visual form. Required fields: title and due date. Optionally set description, team, assignee, priority, and status.

6. Use the sidebar

• The Vector Team Hub view in the Explorer shows quick stats, the next task, and buttons for common actions (sign in, open dashboard). Click buttons to run commands from the extension host.

7. Admin quick actions

• Run Vector Team Hub: Admin Actions to access a compact QuickPick menu for sign-in flows, creating teams/members, and assigning tasks.

Tips

• Date format: use YYYY-MM-DD when entering due dates in prompts.
• If a webview looks blank, open the Extension Development Host Developer Tools and check for CSP or asset path errors.
• To package a release locally use npx @vscode/vsce package and share the resulting .vsix file.

Commands

• Vector Team Hub: Open Dashboard — open the main webview dashboard.
• Vector Team Hub: Sign In — sign in with an external provider.
• Vector Team Hub: Sign In with Microsoft — sign in with Microsoft / Entra ID.
• Vector Team Hub: Sign In with Google — sign in with Google.
• Vector Team Hub: Sign Out — sign out current user.
• Vector Team Hub: Create Team — interactive team creation.
• Vector Team Hub: Add Member — interactive member creation.
• Vector Team Hub: Assign Task — interactive task assignment.
• Vector Team Hub: Open Task Creator UI — open the visual task creator webview.

Screenshots

Add screenshots to the Marketplace entry (recommended) to illustrate:

• Admin dashboard showing analytics and quick actions
• Sidebar overview with next task and stats
• Task Creator UI form

Include these images in the Marketplace publisher portal when you publish.

Settings

This extension currently uses no user-configurable workspace settings. Future releases may expose preferences for date format, default priority, and notification cadence.

Security & Privacy

• Sign-in is performed using VS Code's authentication API and relies on provider sessions — no credentials are stored in plaintext.
• The extension stores app state in VS Code global state (Memento) inside the user's environment. No external servers are contacted by default.

Packaging & Publishing (for maintainers)

1. Bump semantic version in package.json (patch/minor/major):

npm version patch

2. Build and package:

npm install
npm run compile
npx @vscode/vsce package

3. Publish (create a Personal Access Token (PAT) in the Visual Studio Marketplace and export it):

$env:VSCE_PAT = 'YOUR_PERSONAL_ACCESS_TOKEN'
npx @vscode/vsce publish

Security: never commit or share the PAT. Use CI secrets for automation.

Contributing

• Fork the repository, create a feature branch, and open a pull request with tests and a clear description.
• Run npm run lint and npm run compile before opening PRs.

License & Support

Add an appropriate LICENSE file (MIT or Apache-2.0 recommended) to the repository to remove packaging warnings and make redistribution terms clear.

For support, open an issue on the GitHub repository or email the maintainer listed in the Marketplace publisher profile.

---

For developer-focused details and a step-by-step publishing checklist, see LEARN.md.