ownerlens 0.1.7 → 0.1.9-preview.0

package/README.md

@@ -48,8 +48,6 @@ flowchart TD
 
 ## Requirements
 
-- Node.js 20 or newer
-- npm
 - PowerShell 7 or Windows PowerShell for snapshot export scripts
 - Azure PowerShell and Microsoft Graph PowerShell modules when exporting data
 
@@ -84,121 +82,51 @@ Sign in to Microsoft Graph:
 Connect-MgGraph -TenantId "<tenant-id>" -Scopes "Application.Read.All","Group.Read.All","Directory.Read.All"
 ```
 
-Create the resource snapshot:
-
-```bash
-npx ownerlens collect:azure -SubscriptionIds "sub-id-1,sub-id-2"
-```
-
-Create the Entra snapshot:
-
-```bash
-npx ownerlens collect:entra -TenantId "<tenant-id>"
-```
-
-More script options are documented in [tools/README.md](tools/README.md).
-
-Snapshot files can contain tenant, subscription, resource, identity, group, and
-activity-log metadata. Review them before sharing. Files matching
-`data/*snapshot.json` are ignored by git.
-
-## Local Development
-
-Clone the repository, install dependencies, then run the development server:
-
-```bash
-npm install
-npm run dev
-```
-
-Open the Vite URL printed by the command, usually `http://127.0.0.1:5173`.
-
-You can also exercise the published CLI entrypoint from a repository checkout:
-
-```bash
-npm run start
-npm run preview
-npm run collect:azure -- -SubscriptionIds "sub-id-1,sub-id-2"
-npm run collect:entra -- -TenantId "<tenant-id>"
-```
-
-For a production build:
+Import the PowerShell module:
 
-```bash
-npm run build
-```
-
-## Configure Ownership Rules
-
-Edit [src/core/config.ts](src/core/config.ts) to change ownership resolution defaults.
-
-`ownerTags` is ordered by priority. The tag value is treated as the owner
-identity and can be a group name, security group alias, or user email.
-
-```ts
-export const appConfig = {
-  azure: {
-    ownership: {
-      ownerTags: [
-        { name: "ownerGroup", confidence: "high" },
-        { name: "costCenter", confidence: "high" },
-        { name: "owner", confidence: "medium" }
-      ]
-    }
-  }
-};
-```
-
-## Test
-
-```bash
-npm test
+```powershell
+Import-Module ./artifacts/OwnerLens/OwnerLens.psd1 -Force
 ```
 
-Run only component tests:
+Start OwnerLens from PowerShell on Windows:
 
-```bash
-npm run test:components
+```powershell
+Start-OwnerLens
+Open-OwnerLens
+Get-OwnerLensStatus
+Stop-OwnerLens
 ```
 
-Track component-test coverage:
+`Start-OwnerLens` starts the local app on `127.0.0.1` using a free port and
+stores runtime state under `$env:LOCALAPPDATA\OwnerLens`. To use a specific data
+directory or port, pass them explicitly:
 
-```bash
-npm run test:components:coverage
+```powershell
+Start-OwnerLens -DataPath C:\OwnerLensData -Port 4174
 ```
 
-The component coverage report is written to `coverage/components`. Jest also
-enforces the current component coverage baseline so new UI changes do not
-silently reduce coverage.
-
-## Dependency Graph
-
-Generate a folder-level dependency graph:
+Create the resource snapshot:
 
-```bash
-npm run deps:graph
+```powershell
+Invoke-OwnerLensCollectAzure -SubscriptionIds "sub-id-1,sub-id-2"
 ```
 
-The generated SVG is written to `output/dependency-folders.svg`.
-
-Generate a file-level dependency graph:
+Create the Entra snapshot:
 
-```bash
-npm run deps:graph:files
+```powershell
+Invoke-OwnerLensCollectEntra -TenantId "<tenant-id>"
 ```
 
-The generated SVG is written to `output/dependency-files.svg`.
+More collector options are documented in [tools/README.md](tools/README.md).
 
-## Project Structure
+Snapshot files can contain tenant, subscription, resource, identity, group, and
+activity-log metadata. Review them before sharing. Files matching
+`data/*snapshot.json` are ignored by git.
 
-- `src/App.tsx` loads snapshot files and renders the report.
-- `src/core/config.ts` contains ownership resolution configuration.
-- `src/report` contains report UI, filtering, view helpers, and tests.
-- `src/providers/azure` contains Azure and Entra domain models and ownership
-  analysis logic.
-- `tools` contains PowerShell scripts for exporting local snapshot files.
+## Development
 
-## Contributing
+See [DEVELOPMENT.md](DEVELOPMENT.md) for local development, testing, dependency
+graph, project structure, and ownership rule configuration notes.
 
 Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for local
 development expectations.

package/bin/ownerlens.js

@@ -15,10 +15,10 @@ const dataDir = ensureDataDirectory(invocationRoot);
 printDataDirectorySummary(dataDir);
 
 const commands = new Map([
-  ["collect:entra", "collect-entra.ps1"],
-  ["collect-azure", "collect-azure.ps1"],
-  ["collect:azure", "collect-azure.ps1"],
-  ["collect-entra", "collect-entra.ps1"]
+  ["collect:entra", { root: "powershell", script: join("OwnerLens", "Public", "Invoke-OwnerLensCollectEntra.ps1") }],
+  ["collect-azure", { root: "powershell", script: join("OwnerLens", "Public", "Invoke-OwnerLensCollectAzure.ps1") }],
+  ["collect:azure", { root: "powershell", script: join("OwnerLens", "Public", "Invoke-OwnerLensCollectAzure.ps1") }],
+  ["collect-entra", { root: "powershell", script: join("OwnerLens", "Public", "Invoke-OwnerLensCollectEntra.ps1") }]
 ]);
 
 if (command === "help" || command === "--help" || command === "-h") {
@@ -36,9 +36,9 @@ if (commands.has(command)) {
   process.exit(1);
 }
 
-function runPowerShellScript(scriptName, args, options = {}) {
+function runPowerShellScript(script, args, options = {}) {
   const pwsh = resolvePowerShell();
-  const scriptPath = join(packageRoot, "tools", scriptName);
+  const scriptPath = join(packageRoot, script.root, script.script);
   const psArgs = [
     "-NoProfile",
     "-ExecutionPolicy",

package/contracts/entra/snapshot.v0.4.schema.json

@@ -382,7 +382,10 @@
       "additionalProperties": false,
       "properties": {
         "account": {
-          "type": "string"
+          "type": [
+            "string",
+            "null"
+          ]
         },
         "appRoleAssignmentCount": {
           "type": "number"