Architecture

2026-03-31

oves-sharepoint-tools is a focused gateway repo rather than an application platform. Its architecture centers on a single operational flow:

1. authenticate with Microsoft Graph
2. resolve a SharePoint sharing link or site request
3. fetch and cache remote content locally when needed
4. analyze supported file types
5. write durable outputs to analyses/
6. expose those outputs as reusable agent context

Core Areas

• scripts/: command-line implementation and Graph integration
• docs/context/: repo contract, capabilities, and workflow notes
• analyses/: generated outputs from scans and file analysis

Functional Role

• SharePoint is the system of record.
• This repo is the access and curation gateway.
• Agents should use this repo to obtain structured context from SharePoint.
• Curation is moderate and selective, not exhaustive.

Curation Boundary

• Keep remote document ownership, permissions, and collaboration in SharePoint.
• Store only derived artifacts that improve retrieval, analysis, or agent use.
• Prefer inventories, summaries, and analysis outputs over raw file mirroring.
• Do not redefine this repo as a SharePoint replacement platform.

Workspace Boundary

• This repo owns SharePoint tooling behavior.
• It may define how SharePoint-derived context is curated for agents.
• It does not replace broader document management or hub publishing systems.
• Agent routing for this repo is declared in docs/agent/manifest.yaml.