@zonease/aiworker-cli 0.12.2 → 0.13.1

package/official-apps/aiworker-hr/migrations/0001_hr.sql

@@ -0,0 +1,2 @@
+-- AIWorker HR app-local migration: hr-initial
+-- App-owned storage is brokered by Host in mounted mode and local in standalone mode.

package/official-apps/aiworker-hr/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@zonease/aiworker-hr",
+  "type": "module",
+  "private": true,
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "build": "bun build src/index.ts src/standalone.ts src/host-mounted.ts --outdir dist --target bun",
+    "dev": "bun src/standalone.ts --serve",
+    "serve": "bun src/host-mounted.ts",
+    "smoke": "bun ../../apps/cli/src/aiworker.ts app smoke .",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "validate": "bun ../../apps/cli/src/aiworker.ts app validate ."
+  },
+  "dependencies": {
+    "@zonease/aiworker-soul-app-sdk": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.13",
+    "@zonease/aiworker-soul-app-runtime": "workspace:*",
+    "typescript": "^5.8.3"
+  }
+}

package/official-apps/aiworker-hr/packs/hr-recruiting/SOUL.md

@@ -0,0 +1,7 @@
+# AIWorker HR Soul Pack
+
+This pack anchors HR work in app-owned domain guidance.
+
+- Stay inside the app workspace.
+- Produce reviewable artifacts.
+- Use Host broker only for shared resources.

package/official-apps/aiworker-hr/review/candidate-screen.md

@@ -0,0 +1,5 @@
+# Candidate Screen Review Policy
+
+- Verify source evidence is explicit.
+- Mark missing facts before promotion.
+- Keep human review notes separate from generated summary.

package/official-apps/aiworker-hr/review/person-profile.md

@@ -0,0 +1,5 @@
+# Person Profile Review Policy
+
+- Verify source evidence is explicit.
+- Mark missing facts before promotion.
+- Keep human review notes separate from generated summary.

package/official-apps/aiworker-hr/schemas/candidate-screen.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AIWorker HR Candidate Screen",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "title",
+    "summary",
+    "evidence"
+  ],
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "source",
+          "summary"
+        ],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/official-apps/aiworker-hr/schemas/person-profile.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AIWorker HR Person Profile",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "title",
+    "summary",
+    "evidence"
+  ],
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "source",
+          "summary"
+        ],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/official-apps/aiworker-hr/soul-app.manifest.json

@@ -0,0 +1,374 @@
+{
+  "api": {
+    "entry": "./src/api.ts",
+    "localService": {
+      "command": [
+        "bun",
+        "dist/host-mounted.js"
+      ],
+      "healthPath": "/health"
+    },
+    "routePrefix": "/api/local/apps/aiworker-hr"
+  },
+  "artifactTypes": [
+    {
+      "description": "Source-backed HR lifecycle profile.",
+      "id": "person-profile",
+      "name": "Person Profile",
+      "previewRef": "./src/ui/person-profile-preview.tsx",
+      "reviewPolicyRef": "./review/person-profile.md",
+      "schemaRef": "./schemas/person-profile.schema.json",
+      "schemaSha256": "35c14e3d4c0fe9fd95c87e9bc47a210e21f99bcb1b079aa99a95bb93e820c8ab",
+      "version": "0.1.0"
+    },
+    {
+      "description": "Role-related candidate screen with missing evidence and risks.",
+      "id": "candidate-screen",
+      "name": "Candidate Screen",
+      "previewRef": "./src/ui/candidate-screen-preview.tsx",
+      "reviewPolicyRef": "./review/candidate-screen.md",
+      "schemaRef": "./schemas/candidate-screen.schema.json",
+      "schemaSha256": "e8bd207be63eab23073cd47e41092f1d753c38d609383206e94334dd984b309c",
+      "version": "0.1.0"
+    }
+  ],
+  "capabilities": [
+    {
+      "artifactTypes": [
+        "person-profile"
+      ],
+      "description": "Create a source-backed people profile snapshot.",
+      "id": "person-profile",
+      "name": "Person Profile",
+      "outputKind": "person-profile",
+      "packRefs": [],
+      "promptRef": "./capabilities/person-profile/prompt.md",
+      "reviewRubricRef": "./capabilities/person-profile/review.md",
+      "version": "0.1.0",
+      "workspaceTypes": [
+        "people-profile"
+      ]
+    },
+    {
+      "artifactTypes": [
+        "candidate-screen"
+      ],
+      "description": "Screen candidate evidence against a role rubric.",
+      "id": "candidate-screen",
+      "name": "Candidate Screen",
+      "outputKind": "candidate-screen",
+      "packRefs": [],
+      "promptRef": "./capabilities/candidate-screen/prompt.md",
+      "reviewRubricRef": "./capabilities/candidate-screen/review.md",
+      "version": "0.1.0",
+      "workspaceTypes": [
+        "role-search",
+        "candidate"
+      ]
+    }
+  ],
+  "compatibility": {
+    "host": {
+      "minVersion": "0.12.0"
+    },
+    "sdk": {
+      "minVersion": "0.1.0"
+    }
+  },
+  "connectors": {
+    "optional": [
+      {
+        "access": [
+          "read"
+        ],
+        "id": "calendar",
+        "reason": "Collect interview availability and touchpoint context.",
+        "scopes": [
+          "events.read"
+        ]
+      }
+    ],
+    "required": [
+      {
+        "access": [
+          "read"
+        ],
+        "id": "ats",
+        "reason": "Read candidate packets and role evidence through the Host connector broker.",
+        "scopes": [
+          "candidates.read",
+          "roles.read"
+        ]
+      }
+    ]
+  },
+  "description": "People operations Soul App for profiles, recruiting evidence, lifecycle touchpoints, and HR review policy.",
+  "exports": {
+    "artifact": "./src/protocol/artifact.ts",
+    "connector": "./src/protocol/connectors.ts",
+    "lifecycle": "./src/protocol/lifecycle.ts",
+    "review": "./src/protocol/review.ts",
+    "runtime": "./src/protocol/runtime.ts",
+    "ui": "./src/protocol/ui.ts"
+  },
+  "healthcheck": {
+    "kind": "protocol-handler",
+    "ref": "healthcheck",
+    "timeoutMs": 5000
+  },
+  "id": "aiworker-hr",
+  "memory": {
+    "admissionPolicy": "manual-review",
+    "namespace": "aiworker-hr"
+  },
+  "modes": {
+    "hostMounted": {
+      "entry": "./dist/host-mounted.js",
+      "supported": true
+    },
+    "standalone": {
+      "entry": "./dist/standalone.js",
+      "supported": true
+    }
+  },
+  "name": "AIWorker HR",
+  "pack": {
+    "refs": [
+      {
+        "id": "hr-recruiting",
+        "ref": "packs/hr-recruiting/SOUL.md",
+        "source": "embedded",
+        "version": "0.1.0"
+      }
+    ]
+  },
+  "permissions": [
+    {
+      "action": "read",
+      "kind": "storage",
+      "reason": "Read app-scoped HR domain metadata.",
+      "target": "aiworker-hr"
+    },
+    {
+      "action": "write",
+      "kind": "storage",
+      "reason": "Write app-scoped HR domain metadata.",
+      "target": "aiworker-hr"
+    },
+    {
+      "action": "read",
+      "kind": "search",
+      "reason": "Read app-owned HR search descriptors.",
+      "target": "aiworker-hr"
+    },
+    {
+      "action": "write",
+      "kind": "search",
+      "reason": "Publish app-owned HR search descriptors.",
+      "target": "aiworker-hr"
+    },
+    {
+      "action": "read",
+      "kind": "connector",
+      "reason": "Read HR evidence through Host connector broker.",
+      "target": "ats"
+    },
+    {
+      "action": "write",
+      "kind": "artifact",
+      "reason": "Create reviewable HR artifacts.",
+      "target": "person-profile"
+    },
+    {
+      "action": "create",
+      "kind": "review",
+      "reason": "Create HR review rubrics and findings.",
+      "target": "hr-review"
+    },
+    {
+      "action": "propose",
+      "kind": "memory",
+      "reason": "Propose reviewed HR lessons into the app namespace.",
+      "target": "aiworker-hr"
+    },
+    {
+      "action": "mount",
+      "kind": "ui",
+      "reason": "Mount HR workbench contributions.",
+      "target": "hr-workbench"
+    },
+    {
+      "action": "serve",
+      "kind": "api",
+      "reason": "Serve HR scoped API routes.",
+      "target": "/api/local/apps/aiworker-hr"
+    }
+  ],
+  "protocol": "soul-app/v1",
+  "soul": {
+    "description": "HR Soul for people operations, recruiting, onboarding, offboarding, and sensitive evidence review.",
+    "domain": "hr-people-ops",
+    "id": "hr",
+    "name": "HR",
+    "version": "0.1.0"
+  },
+  "storage": {
+    "migrations": [
+      {
+        "id": "hr-initial",
+        "path": "./migrations/0001_hr.sql"
+      }
+    ],
+    "namespace": "aiworker-hr"
+  },
+  "ui": {
+    "artifactPreviews": [
+      {
+        "entry": "./src/ui/person-profile-preview.tsx",
+        "id": "person-profile-preview",
+        "label": "Person profile preview",
+        "slot": "artifact-preview",
+        "target": "person-profile"
+      }
+    ],
+    "panels": [
+      {
+        "entry": "./src/ui/profile-panel.tsx",
+        "id": "hr-profile-panel",
+        "label": "Profile panel",
+        "slot": "panel",
+        "surface": {
+          "entry": "/surfaces/panels/hr-profile-panel",
+          "renderer": "host-descriptor",
+          "requiredPermissions": [
+            "storage:read:aiworker-hr"
+          ],
+          "scope": "workspace"
+        }
+      }
+    ],
+    "reviewPanels": [
+      {
+        "entry": "./src/ui/review-panel.tsx",
+        "id": "hr-review-panel",
+        "label": "HR review panel",
+        "slot": "review-panel"
+      }
+    ],
+    "routes": [
+      {
+        "entry": "./src/ui/hr-route.tsx",
+        "id": "hr-home",
+        "label": "HR",
+        "path": "/hr",
+        "surface": {
+          "entry": "/surfaces/routes/hr-home",
+          "renderer": "host-descriptor",
+          "requiredPermissions": [
+            "ui:mount:hr-workbench"
+          ],
+          "scope": "app"
+        }
+      }
+    ],
+    "shell": {
+      "actions": [
+        {
+          "id": "refresh-people",
+          "label": "Refresh",
+          "protocolAction": "people.refresh",
+          "requiredPermissions": [
+            "storage:read:aiworker-hr"
+          ],
+          "slot": "refresh"
+        },
+        {
+          "id": "toggle-evidence-drawer",
+          "label": "Evidence",
+          "protocolAction": "drawers.evidence.toggle",
+          "requiredPermissions": [
+            "connector:read:ats"
+          ],
+          "slot": "drawer-toggle"
+        }
+      ],
+      "primaryAction": {
+        "id": "create-people-profile",
+        "label": "New people profile",
+        "protocolAction": "peopleProfiles.create",
+        "requiredPermissions": [
+          "storage:write:aiworker-hr",
+          "search:write:aiworker-hr"
+        ],
+        "slot": "primary"
+      },
+      "search": {
+        "id": "people-profile-search",
+        "label": "Search people profiles",
+        "placeholder": "Search people profiles",
+        "protocolProvider": "peopleProfiles.search",
+        "requiredPermissions": [
+          "search:read:aiworker-hr"
+        ]
+      },
+      "settings": {
+        "id": "hr-settings",
+        "label": "HR settings",
+        "protocolAction": "settings.open",
+        "requiredPermissions": [
+          "api:serve:/api/local/apps/aiworker-hr"
+        ]
+      }
+    },
+    "workspaceWidgets": [
+      {
+        "entry": "./src/ui/people-widget.tsx",
+        "id": "hr-people-widget",
+        "label": "People widget",
+        "slot": "workspace-widget",
+        "surface": {
+          "entry": "/frames/widgets/hr-people-widget",
+          "renderer": "sandboxed-frame",
+          "scope": "workspace"
+        },
+        "target": "people-profile"
+      }
+    ]
+  },
+  "version": "0.1.0",
+  "workspaceTypes": [
+    {
+      "artifactTypes": [
+        "person-profile"
+      ],
+      "defaultCapabilityIds": [
+        "person-profile"
+      ],
+      "description": "Profile-centered workspace for one person lifecycle.",
+      "id": "people-profile",
+      "name": "People Profile"
+    },
+    {
+      "artifactTypes": [
+        "candidate-screen"
+      ],
+      "defaultCapabilityIds": [
+        "candidate-screen"
+      ],
+      "description": "Recruiting role workspace with candidate evidence and review.",
+      "id": "role-search",
+      "name": "Role Search"
+    },
+    {
+      "artifactTypes": [
+        "candidate-screen"
+      ],
+      "defaultCapabilityIds": [
+        "candidate-screen"
+      ],
+      "description": "Focused candidate packet workspace.",
+      "id": "candidate",
+      "name": "Candidate"
+    }
+  ]
+}

package/official-apps/aiworker-hr/src/api.ts

@@ -0,0 +1 @@
+export { hrReferenceSoulApp as soulApp } from './index'