Projects Plugin for Nova

This repository contains the Projects plugin extracted for use with Nova core.

It adds a dedicated Projects top-level UI tab and project-management runtime helpers for:

• project configuration
• workspace project inspection
• project todo and role-task board management
• project pipeline visibility
• idle opportunity scanning and project-cycle scheduling

What This Plugin Assumes

This is not a standalone app. It is a Nova plugin module that expects to run inside a compatible Nova core environment.

The plugin currently depends on core-provided runtime APIs and project helpers, including functions such as:

• getRuntimeContext()
• listContainerWorkspaceProjects()
• readContainerFile()
• writeContainerTextFile()
• readJsonFileIfExists()
• moveWorkspaceProjectToOutput()
• snapshotWorkspaceProjectToOutput()

Included Files

• projects/projects-plugin.js - plugin entry point and route registration
• projects/lib/projects-runtime.js - runtime composition and mutation helpers
• projects/lib/observer-project-planning.js - todo, directive, and role-board planning logic
• projects/lib/observer-project-state.js - state aggregation for the UI panel
• projects/lib/observer-project-workspace-support.js - workspace rotation, export, and project-cycle task support
• projects/public/projects-tab.js - browser-side Projects tab UI

Features

• Adds a Projects UI tab to the Nova panel
• Exposes project configuration and state routes under /api/projects/*
• Surfaces project pipelines and recent project-cycle activity
• Seeds and maintains PROJECT-TODO.md and PROJECT-ROLE-TASKS.md
• Supports project export and workspace lifecycle helpers through Nova core

Security Notes

The current version includes hardening for project-board mutations:

• checklist item removal only operates on managed project files
• role add/remove only operates on PROJECT-ROLE-TASKS.md
• free-form role and checklist inputs are normalized to single-line content before write

Before You Use It

Make sure your Nova core environment:

• loads plugins with this file structure
• exposes the runtime helpers this plugin expects
• protects /api/projects/* routes behind authenticated access
• uses managed workspace projects with .observer-project.json markers where appropriate

License

This project is licensed under the MIT License. See LICENSE.