Krow/krow_backend
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Separate what a worker does from what a company needs filled
Some checks failed
CI / test (push) Failing after 4m41s
Details
CI / fixture (push) Failing after 8s
Details

Browse Source 
Owliver could offer neither create. The Create Position flow worked and no chip
anywhere suggested it, because the chip row is entirely the backend's static
catalogue and no intent in it wrote anything. The gap was never in the
frontend's trigger matching — every phrasing already routed.

`employee_roles` is the supply side of `job_postings`. A posting is what the
ORGANIZATION needs filled; this is what a WORKER says they do. They share a
vocabulary and almost nothing else: "3 years" on a posting is a minimum an
applicant must clear, and the same words here are what the person has. There is
deliberately no foreign key between them — supply and demand already meet
through `job_applications`, which carries the funnel, the interview and the
outcome, and a second weaker link would disagree with it the first time
somebody withdrew.

NO NEW COMPANY ENTITY, AND THAT IS THE LOAD-BEARING DECISION. "Create a company
position" reads like it needs a client record. `organizations` is the TENANT —
absent from the resource table, absent from the policy map, written only by the
seeder — so creating a row there from a chat flow would provision a new tenant,
and the position would carry an org_id the operator's session cannot see. The
operator could never view the record they just created. That breaks I5 and I1
to add a feature nobody asked for. The client stays free text on the posting,
per blueprint decision D2, and the flow simply offers the clients this
organization already staffs for as chips. No schema change, no endpoint change.

Create is operators-only, and that is an I1 decision rather than a deferral.
The worker is named explicitly on the row and is deliberately NOT derived from
the session, because an operator recording a role on somebody's behalf is the
whole point of the flow. Granting talent the same Create would let a talent
caller write a role under any worker_email in the tenant — the attribution hole
Phase 3D closed elsewhere. Talent reads its own via a ScopeEmail predicate,
which is in place now so the grant is one line when a talent console exists.

`created_by` is in gen_resources.py's SERVER_OWNED as well as the policy's
Derived list. Both are required and the pairing is easy to miss: Derived fills
the column from the session, SERVER_OWNED is what makes the descriptor ReadOnly
so a request body cannot set it in the first place. Without it,
TestDerivedColumnsAreReadOnlyOrTalentScoped fails — verified by mutation, not
by reading.

The two catalogue intents carry PHRASE terms only. A bare "position" or "role"
term scores 10, the same as every reading on that page, and wins the tie on
declaration order — so a create chip would have arrived by evicting
`positions-attention` from the exact ordered result TestPositionsSuggestions
asserts. An offer to create something must not displace the reading a person
actually asked for. Neither declares a Subject, on the precedent of
`position-spec-steps`: a Subject would let the bare query "summarize" match
through matchShape and survive filterOnTopic. Neither declares a Signal, so an
empty composer still reports what the organization needs rather than proposing
paperwork.

Chip text is the coupling with nothing else holding it together: no page
context declares `capabilities`, so every server suggestion dispatches as its
own TEXT and is answered by whichever skill's trigger that text matches. A
renamed chip would open nothing, silently. Asserted on the frontend side.

The down migration drops `employee_role_status` and keeps `english_level`,
which is shared with job_postings.english_required and
job_applications.english_level. Rolled back and re-applied against the
database to prove it, not asserted.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PJvibeSc1JYXjatankqM1g
This commit is contained in:
Suriyakumarvijayanayagam
2026-09-02 15:29:25 +05:30
parent c74fe7e074
commit dc785b917c
22 changed files with 658 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
go-api/internal/definition/conformance_test.go
View File

@@ -129,13 +129,13 @@ func TestCorpusShape(t *testing.T) {
for _, want := range []struct {
kind string
n int
}{{"agent", 9}, {"skill", 23}, {"example", 5}} {
}{{"agent", 9}, {"skill", 24}, {"example", 5}} {
if counts[want.kind] != want.n {
t.Errorf("%s definitions: got %d, want %d", want.kind, counts[want.kind], want.n)
}
}
if len(o.Corpus) != 37 {
t.Errorf("shipped definitions: got %d, want 37", len(o.Corpus))
if len(o.Corpus) != 38 {
t.Errorf("shipped definitions: got %d, want 38", len(o.Corpus))
}
}

109
go-api/internal/definition/testdata/oracle.json vendored
View File

@@ -943,8 +943,8 @@
{
"path": "src/agents/positions-agent.md",
"type": "agent",
"rawBase64": "LS0tCmlkOiBwb3NpdGlvbnMtYWdlbnQKbmFtZTogUG9zaXRpb25zIEFnZW50CmRlc2NyaXB0aW9uOiBPcGVuIHJvbGVzIOKAlCB3aGF0IHRoZXkgbmVlZCwgd2hvIGhhcyBhcHBsaWVkLCBhbmQgd2hpY2ggYXJlIGF0IHJpc2sgb2YgZ29pbmcgdW5maWxsZWQuCmljb246IGJyaWVmY2FzZQpzdGF0dXM6IHB1Ymxpc2hlZAp2ZXJzaW9uOiAxCnJlYXNvbmluZzogYmFsYW5jZWQKdHJpZ2dlcjogVXNlIG9uIFBvc2l0aW9ucywgZm9yIG9wZW4gcm9sZXMsIGFwcGxpY2FudCBmbG93LCBhbmQgc3BlY2lmeWluZyBhIG5ldyByb2xlLgpwYWdlczoKICAtIHBvc2l0aW9ucwogIC0gY3JlYXRlLXBvc2l0aW9uCnNraWxsczoKICAtIGNyZWF0ZS1wb3NpdGlvbgogIC0gaGlyaW5nLWFjdGl2aXR5LWFzc2lzdGFudAogIC0gc3RhZmZpbmctcmlzawpzdGFydGVyczoKICAtIGxhYmVsOiBXaGljaCBwb3NpdGlvbnMgbmVlZCBhdHRlbnRpb24/CiAgICBwcm9tcHQ6IFdoaWNoIHBvc2l0aW9ucyBuZWVkIGF0dGVudGlvbj8KICAtIGxhYmVsOiBTaG93IGhpcmluZyBhY3Rpdml0eQogICAgcHJvbXB0OiBTaG93IGhpcmluZyBhY3Rpdml0eSBhcyBhIGZsb3cKcGVybWlzc2lvbnM6CiAgb3duZXI6IGRlbW9Aa3Jvdy5hcHAKICBhY2Nlc3M6IGFsbAp0b29sczoKICAtIHBvc2l0aW9uc19yaXNrCiAgLSBvcGVuX3Bvc2l0aW9ucwogIC0gYXZhaWxhYmxlX3dvcmtlcnMKICAtIHdvcmtmb3JjZV9jb3ZlcmFnZQogIC0gY2FuZGlkYXRlc19xdWFsaXR5CiAgLSBhc3NpZ25fd29ya2VyCiAgLSBjYW5kaWRhdGVzX2F3YWl0aW5nCiAgLSBtb3ZlX2FwcGxpY2F0aW9uCi0tLQoKIyBQb3NpdGlvbnMgQWdlbnQKCiMjIEluc3RydWN0aW9ucwoKQW5zd2VyIGFib3V0IHRoZSByb2xlcyB0aGlzIHdvcmtzcGFjZSBoYXMgb3BlbjogaG93IHRoZXkgYXJlIGZpbGxpbmcsIHdoaWNoIGFyZQpzdGFydmVkIG9mIGFwcGxpY2FudHMsIGFuZCB3aGF0IGEgcm9sZSBzdGlsbCBuZWVkcyBiZWZvcmUgaXQgY2FuIGJlIHB1Ymxpc2hlZC4KCldoZW4gYSBxdWVzdGlvbiBuYW1lcyBhIHJvbGUsIGFuc3dlciBhYm91dCB0aGF0IHJvbGUuIFdoZW4gaXQgZG9lcyBub3QgYW5kIG9uZQppcyBvcGVuIG9uIHRoZSBwYWdlLCBhbnN3ZXIgYWJvdXQgdGhhdCBvbmUuIFdoZW4gbmVpdGhlciBpcyB0cnVlLCBhc2sgd2hpY2guCgpOZXZlciBjcmVhdGUgb3IgcHVibGlzaCBhIHBvc2l0aW9uIHdpdGhvdXQgYmVpbmcgYXNrZWQgdG8uCgojIyBQdXJwb3NlCgotIFJlcG9ydCBob3cgb3BlbiByb2xlcyBhcmUgZmlsbGluZywgYW5kIHdoaWNoIGFyZSBhdCByaXNrLgotIEhlbHAgc3BlY2lmeSBhIG5ldyByb2xlIGFuZCBpdHMgc2NyZWVuaW5nIHdlaWdodHMuCg==",
"bytes": 1357,
"rawBase64": "LS0tCmlkOiBwb3NpdGlvbnMtYWdlbnQKbmFtZTogUG9zaXRpb25zIEFnZW50CmRlc2NyaXB0aW9uOiBPcGVuIHJvbGVzIOKAlCB3aGF0IHRoZXkgbmVlZCwgd2hvIGhhcyBhcHBsaWVkLCBhbmQgd2hpY2ggYXJlIGF0IHJpc2sgb2YgZ29pbmcgdW5maWxsZWQuCmljb246IGJyaWVmY2FzZQpzdGF0dXM6IHB1Ymxpc2hlZAp2ZXJzaW9uOiAyCnJlYXNvbmluZzogYmFsYW5jZWQKdHJpZ2dlcjogVXNlIG9uIFBvc2l0aW9ucywgZm9yIG9wZW4gcm9sZXMsIGFwcGxpY2FudCBmbG93LCBhbmQgc3BlY2lmeWluZyBhIG5ldyByb2xlLgpwYWdlczoKICAtIHBvc2l0aW9ucwogIC0gY3JlYXRlLXBvc2l0aW9uCnNraWxsczoKICAtIGNyZWF0ZS1wb3NpdGlvbgogIC0gY3JlYXRlLWVtcGxveWVlLXJvbGUKICAtIGhpcmluZy1hY3Rpdml0eS1hc3Npc3RhbnQKICAtIHN0YWZmaW5nLXJpc2sKc3RhcnRlcnM6CiAgLSBsYWJlbDogV2hpY2ggcG9zaXRpb25zIG5lZWQgYXR0ZW50aW9uPwogICAgcHJvbXB0OiBXaGljaCBwb3NpdGlvbnMgbmVlZCBhdHRlbnRpb24/CiAgLSBsYWJlbDogU2hvdyBoaXJpbmcgYWN0aXZpdHkKICAgIHByb21wdDogU2hvdyBoaXJpbmcgYWN0aXZpdHkgYXMgYSBmbG93CnBlcm1pc3Npb25zOgogIG93bmVyOiBkZW1vQGtyb3cuYXBwCiAgYWNjZXNzOiBhbGwKdG9vbHM6CiAgLSBwb3NpdGlvbnNfcmlzawogIC0gb3Blbl9wb3NpdGlvbnMKICAtIGF2YWlsYWJsZV93b3JrZXJzCiAgLSB3b3JrZm9yY2VfY292ZXJhZ2UKICAtIGNhbmRpZGF0ZXNfcXVhbGl0eQogIC0gYXNzaWduX3dvcmtlcgogIC0gY2FuZGlkYXRlc19hd2FpdGluZwogIC0gbW92ZV9hcHBsaWNhdGlvbgotLS0KCiMgUG9zaXRpb25zIEFnZW50CgojIyBJbnN0cnVjdGlvbnMKCkFuc3dlciBhYm91dCB0aGUgcm9sZXMgdGhpcyB3b3Jrc3BhY2UgaGFzIG9wZW46IGhvdyB0aGV5IGFyZSBmaWxsaW5nLCB3aGljaCBhcmUKc3RhcnZlZCBvZiBhcHBsaWNhbnRzLCBhbmQgd2hhdCBhIHJvbGUgc3RpbGwgbmVlZHMgYmVmb3JlIGl0IGNhbiBiZSBwdWJsaXNoZWQuCgpXaGVuIGEgcXVlc3Rpb24gbmFtZXMgYSByb2xlLCBhbnN3ZXIgYWJvdXQgdGhhdCByb2xlLiBXaGVuIGl0IGRvZXMgbm90IGFuZCBvbmUKaXMgb3BlbiBvbiB0aGUgcGFnZSwgYW5zd2VyIGFib3V0IHRoYXQgb25lLiBXaGVuIG5laXRoZXIgaXMgdHJ1ZSwgYXNrIHdoaWNoLgoKTmV2ZXIgY3JlYXRlIG9yIHB1Ymxpc2ggYSBwb3NpdGlvbiB3aXRob3V0IGJlaW5nIGFza2VkIHRvLgoKIyMgUHVycG9zZQoKLSBSZXBvcnQgaG93IG9wZW4gcm9sZXMgYXJlIGZpbGxpbmcsIGFuZCB3aGljaCBhcmUgYXQgcmlzay4KLSBIZWxwIHNwZWNpZnkgYSBuZXcgcm9sZSBhbmQgaXRzIHNjcmVlbmluZyB3ZWlnaHRzLgo=",
"bytes": 1382,
"kind": "agent",
"hasFrontmatter": true,
"frontmatter": {
@@ -955,7 +955,7 @@
"description": "Open roles — what they need, who has applied, and which are at risk of going unfilled.",
"icon": "briefcase",
"status": "published",
"version": 1,
"version": 2,
"reasoning": "balanced",
"trigger": "Use on Positions, for open roles, applicant flow, and specifying a new role.",
"pages": [
@@ -964,6 +964,7 @@
],
"skills": [
"create-position",
"create-employee-role",
"hiring-activity-assistant",
"staffing-risk"
],
@@ -1002,7 +1003,7 @@
"name": "Positions Agent",
"description": "Open roles — what they need, who has applied, and which are at risk of going unfilled.",
"status": "published",
"version": 1,
"version": 2,
"pages": [
"positions",
"create-position"
@@ -1013,6 +1014,7 @@
"webSearch": false,
"skills": [
"create-position",
"create-employee-role",
"hiring-activity-assistant",
"staffing-risk"
],
@@ -1051,8 +1053,8 @@
{
"path": "src/agents/talent-pool-agent.md",
"type": "agent",
"rawBase64": "LS0tCmlkOiB0YWxlbnQtcG9vbC1hZ2VudApuYW1lOiBUYWxlbnQgUG9vbCBBZ2VudApkZXNjcmlwdGlvbjogQXZhaWxhYmxlIHRhbGVudCDigJQgd2hvIGlzIGluIHRoZSBwb29sLCB3aG8gaXMgdmVyaWZpZWQsIGFuZCB3aG8gaXMgcmVhZHkgdG8gcGxhY2UuCmljb246IGxheWVycwpzdGF0dXM6IHB1Ymxpc2hlZAp2ZXJzaW9uOiAxCnJlYXNvbmluZzogYmFsYW5jZWQKdHJpZ2dlcjogVXNlIG9uIFRhbGVudCBQb29sLCBmb3Igc3VwcGx5LCBhdmFpbGFiaWxpdHkgYW5kIHJlYWRpbmVzcyBvZiBrbm93biB3b3JrZXJzLgpwYWdlczoKICAtIHRhbGVudC1wb29sCnNraWxsczoKICAtIHRhbGVudC1wb29sLWFuYWx5c2lzCnN0YXJ0ZXJzOgogIC0gbGFiZWw6IFdobyBpcyBhdmFpbGFibGU/CiAgICBwcm9tcHQ6IFdobyBpcyBhdmFpbGFibGUgaW4gdGhlIHRhbGVudCBwb29sPwogIC0gbGFiZWw6IEhvdyB2ZXJpZmllZCBpcyB0aGUgcG9vbD8KICAgIHByb21wdDogSG93IG11Y2ggb2YgdGhlIHRhbGVudCBwb29sIGlzIHZlcmlmaWVkPwpwZXJtaXNzaW9uczoKICBvd25lcjogZGVtb0Brcm93LmFwcAogIGFjY2VzczogYWxsCnRvb2xzOgogIC0gdGFsZW50X3Bvb2wKICAtIHdvcmtmb3JjZV90cmFpbmluZwogIC0gYXZhaWxhYmxlX3dvcmtlcnMKLS0tCgojIFRhbGVudCBQb29sIEFnZW50CgojIyBJbnN0cnVjdGlvbnMKCkFuc3dlciBhYm91dCB0aGUgcGVvcGxlIHRoaXMgd29ya3NwYWNlIGFscmVhZHkga25vd3M6IHdobyBpcyBpbiB0aGUgcG9vbCwgd2hhdAp0aGV5IGFyZSB2ZXJpZmllZCBpbiwgYW5kIHdobyBjb3VsZCBiZSBwbGFjZWQgbm93LgoKVGhpcyBpcyBzdXBwbHksIG5vdCBhcHBsaWNhbnRzLiBTb21lb25lIGluIHRoZSBwb29sIGhhcyBub3QgYXBwbGllZCB0byBhbnl0aGluZwpieSBiZWluZyBoZXJlIOKAlCBkbyBub3QgZGVzY3JpYmUgdGhlbSBhcyBhIGNhbmRpZGF0ZSBmb3IgYSByb2xlLgoKVGhpcyBhZ2VudCBjYXJyaWVzIG5vIHNraWxscyBvZiBpdHMgb3duOyBUYWxlbnQgUG9vbCBhbnN3ZXJzIGZyb20gaXRzIG93biBwYWdlCnJlYWRlci4KCiMjIFB1cnBvc2UKCi0gUmVwb3J0IHdobyBpcyBhdmFpbGFibGUsIGFuZCBob3cgcmVhZHkgdGhleSBhcmUuCi0gRGVzY3JpYmUgdGhlIHBvb2wncyBzZWdtZW50cyBhbmQgdmVyaWZpY2F0aW9uIGNvdmVyYWdlLgo=",
"bytes": 1178,
"rawBase64": "LS0tCmlkOiB0YWxlbnQtcG9vbC1hZ2VudApuYW1lOiBUYWxlbnQgUG9vbCBBZ2VudApkZXNjcmlwdGlvbjogQXZhaWxhYmxlIHRhbGVudCDigJQgd2hvIGlzIGluIHRoZSBwb29sLCB3aG8gaXMgdmVyaWZpZWQsIGFuZCB3aG8gaXMgcmVhZHkgdG8gcGxhY2UuCmljb246IGxheWVycwpzdGF0dXM6IHB1Ymxpc2hlZAp2ZXJzaW9uOiAyCnJlYXNvbmluZzogYmFsYW5jZWQKdHJpZ2dlcjogVXNlIG9uIFRhbGVudCBQb29sLCBmb3Igc3VwcGx5LCBhdmFpbGFiaWxpdHkgYW5kIHJlYWRpbmVzcyBvZiBrbm93biB3b3JrZXJzLgpwYWdlczoKICAtIHRhbGVudC1wb29sCnNraWxsczoKICAtIHRhbGVudC1wb29sLWFuYWx5c2lzCiAgLSBjcmVhdGUtZW1wbG95ZWUtcm9sZQpzdGFydGVyczoKICAtIGxhYmVsOiBXaG8gaXMgYXZhaWxhYmxlPwogICAgcHJvbXB0OiBXaG8gaXMgYXZhaWxhYmxlIGluIHRoZSB0YWxlbnQgcG9vbD8KICAtIGxhYmVsOiBIb3cgdmVyaWZpZWQgaXMgdGhlIHBvb2w/CiAgICBwcm9tcHQ6IEhvdyBtdWNoIG9mIHRoZSB0YWxlbnQgcG9vbCBpcyB2ZXJpZmllZD8KcGVybWlzc2lvbnM6CiAgb3duZXI6IGRlbW9Aa3Jvdy5hcHAKICBhY2Nlc3M6IGFsbAp0b29sczoKICAtIHRhbGVudF9wb29sCiAgLSB3b3JrZm9yY2VfdHJhaW5pbmcKICAtIGF2YWlsYWJsZV93b3JrZXJzCi0tLQoKIyBUYWxlbnQgUG9vbCBBZ2VudAoKIyMgSW5zdHJ1Y3Rpb25zCgpBbnN3ZXIgYWJvdXQgdGhlIHBlb3BsZSB0aGlzIHdvcmtzcGFjZSBhbHJlYWR5IGtub3dzOiB3aG8gaXMgaW4gdGhlIHBvb2wsIHdoYXQKdGhleSBhcmUgdmVyaWZpZWQgaW4sIGFuZCB3aG8gY291bGQgYmUgcGxhY2VkIG5vdy4KClRoaXMgaXMgc3VwcGx5LCBub3QgYXBwbGljYW50cy4gU29tZW9uZSBpbiB0aGUgcG9vbCBoYXMgbm90IGFwcGxpZWQgdG8gYW55dGhpbmcKYnkgYmVpbmcgaGVyZSDigJQgZG8gbm90IGRlc2NyaWJlIHRoZW0gYXMgYSBjYW5kaWRhdGUgZm9yIGEgcm9sZS4KClRoaXMgYWdlbnQgY2FycmllcyBubyBza2lsbHMgb2YgaXRzIG93bjsgVGFsZW50IFBvb2wgYW5zd2VycyBmcm9tIGl0cyBvd24gcGFnZQpyZWFkZXIuCgojIyBQdXJwb3NlCgotIFJlcG9ydCB3aG8gaXMgYXZhaWxhYmxlLCBhbmQgaG93IHJlYWR5IHRoZXkgYXJlLgotIERlc2NyaWJlIHRoZSBwb29sJ3Mgc2VnbWVudHMgYW5kIHZlcmlmaWNhdGlvbiBjb3ZlcmFnZS4K",
"bytes": 1203,
"kind": "agent",
"hasFrontmatter": true,
"frontmatter": {
@@ -1063,14 +1065,15 @@
"description": "Available talent — who is in the pool, who is verified, and who is ready to place.",
"icon": "layers",
"status": "published",
"version": 1,
"version": 2,
"reasoning": "balanced",
"trigger": "Use on Talent Pool, for supply, availability and readiness of known workers.",
"pages": [
"talent-pool"
],
"skills": [
"talent-pool-analysis"
"talent-pool-analysis",
"create-employee-role"
],
"starters": [
{
@@ -1102,7 +1105,7 @@
"name": "Talent Pool Agent",
"description": "Available talent — who is in the pool, who is verified, and who is ready to place.",
"status": "published",
"version": 1,
"version": 2,
"pages": [
"talent-pool"
],
@@ -1111,7 +1114,8 @@
"trigger": "Use on Talent Pool, for supply, availability and readiness of known workers.",
"webSearch": false,
"skills": [
"talent-pool-analysis"
"talent-pool-analysis",
"create-employee-role"
],
"tools": [
"talent_pool",
@@ -1717,11 +1721,90 @@
"accepted": true,
"rejection": null
},
{
"path": "src/skills/owliver/create-employee-role.md",
"type": "skill",
"rawBase64": "LS0tCmlkOiBjcmVhdGUtZW1wbG95ZWUtcm9sZQpuYW1lOiBDcmVhdGUgRW1wbG95ZWUgUm9sZQpkZXNjcmlwdGlvbjogUmVjb3JkIHdoYXQgYSB3b3JrZXIgZG9lcyDigJQgdGhlaXIgcm9sZSwgZXhwZXJpZW5jZSwgcGF5IGFuZCBhdmFpbGFiaWxpdHkg4oCUIGJ5IGFuc3dlcmluZyBhIGZldyBxdWVzdGlvbnMgaW4gdGhlIGNoYXQuCnBhZ2VzOgogIC0gdGFsZW50LXBvb2wKICAtIHBvc2l0aW9ucwpzdGF0dXM6IGFjdGl2ZQp2ZXJzaW9uOiAxCnByb21wdDogQ3JlYXRlIGFuIGVtcGxveWVlIHJvbGUKZmxvdzogZW1wbG95ZWUtcm9sZQp0cmlnZ2VyczoKICAtIGNyZWF0ZSBhbiBlbXBsb3llZSByb2xlCiAgLSBjcmVhdGUgZW1wbG95ZWUgcm9sZQogIC0gY3JlYXRlIGVtcGxveWVlIHJvbGVzCiAgLSBhZGQgYW4gZW1wbG95ZWUgcm9sZQogIC0gYWRkIGVtcGxveWVlIHJvbGUKICAtIG5ldyBlbXBsb3llZSByb2xlCiAgLSBjcmVhdGUgYSB3b3JrZXIgcm9sZQogIC0gY3JlYXRlIHdvcmtlciByb2xlCiAgLSByZWNvcmQgYSByb2xlIGZvcgogIC0gYWRkIGEgd29ya2VyIHJvbGUKYWN0aW9uczoKICAtIGNyZWF0ZV9lbXBsb3llZV9yb2xlCi0tLQoKIyBDcmVhdGUgRW1wbG95ZWUgUm9sZQoKIyMgUHVycG9zZQoKUmVjb3JkIGEgd29ya2VyJ3MgZGVjbGFyZWQgcHJvZmVzc2lvbmFsIHJvbGUgd2l0aG91dCBsZWF2aW5nIHRoZSBwYWdlLiBPd2xpdmVyCmFza3Mgb25lIHF1ZXN0aW9uIGF0IGEgdGltZSwgb2ZmZXJzIHRoZSBhbnN3ZXJzIGFzIGNoaXBzLCBhbmQgcmVhZHMgdGhlIHdob2xlCnRoaW5nIGJhY2sgYmVmb3JlIGFueXRoaW5nIGlzIHdyaXR0ZW4uCgoqKlRoaXMgaXMgbm90IENyZWF0ZSBQb3NpdGlvbiwgYW5kIHRoZSBkaWZmZXJlbmNlIGlzIHRoZSBwb2ludC4qKiBBIHBvc2l0aW9uIGlzCndoYXQgdGhlIE9SR0FOSVpBVElPTiBuZWVkcyBmaWxsZWQg4oCUIGEgY29tcGFueSwgYSB0aXRsZSwgYSBwYXkgcmFuZ2UgaXQgd2lsbApwYXkuIEFuIGVtcGxveWVlIHJvbGUgaXMgd2hhdCBhIFdPUktFUiBzYXlzIHRoZXkgZG8g4oCUIHRoZSByb2xlIHRoZXkgcHJlc2VudAp0aGVtc2VsdmVzIGFzLCB0aGUgZXhwZXJpZW5jZSB0aGV5IGhhdmUsIGFuZCB0aGUgcGF5IHRoZXkgYXJlIGxvb2tpbmcgZm9yLiBUaGUKdHdvIHNoYXJlIGEgdm9jYWJ1bGFyeSBhbmQgbm90aGluZyBlbHNlOiAiMyB5ZWFycyIgb24gYSBwb3NpdGlvbiBpcyBhIG1pbmltdW0gYW4KYXBwbGljYW50IG11c3QgY2xlYXIsIGFuZCB0aGUgc2FtZSB3b3JkcyBoZXJlIGFyZSB3aGF0IHRoaXMgcGVyc29uIGhhcy4KClRoZXkgYXJlIG5ldmVyIGpvaW5lZCBieSBhIGNvbHVtbi4gU3VwcGx5IGFuZCBkZW1hbmQgbWVldCB0aHJvdWdoIGFwcGxpY2F0aW9ucywKd2hpY2ggYWxyZWFkeSBjYXJyeSB0aGUgZnVubmVsLCB0aGUgaW50ZXJ2aWV3IGFuZCB0aGUgb3V0Y29tZS4KCiMjIENhcGFiaWxpdGllcwoKLSBVbmRlcnN0YW5kIHJlcXVlc3RzIHRvIHJlY29yZCB3aGF0IGEgd29ya2VyIGRvZXMuCi0gQXNrIHdobyB0aGUgcm9sZSBpcyBmb3IsIGFuZCByZXNvbHZlIHRoZSBhbnN3ZXIgdG8gYSByZWFsIHdvcmtlciBwcm9maWxlLgotIFJlYWQgdGhlIHJvbGUsIGV4cGVyaWVuY2UsIEVuZ2xpc2ggbGV2ZWwsIGNlcnRpZmljYXRpb25zLCBkZXNpcmVkIHBheSBhbmQKICBhdmFpbGFiaWxpdHkgb3V0IG9mIGEgc2luZ2xlIHNlbnRlbmNlLgotIEFzayBvbmx5IGZvciB3aGF0IHRoZSByZXF1ZXN0IGRpZCBub3QgYWxyZWFkeSBhbnN3ZXIuCi0gT2ZmZXIgZWFjaCBhbnN3ZXIgYXMgYSBzdWdnZXN0aW9uLCBzbyB0aGUgd2hvbGUgZmxvdyBjYW4gYmUgY2xpY2tlZC4KLSBSZWFkIHRoZSByb2xlIGJhY2sgZm9yIGNvbmZpcm1hdGlvbiBiZWZvcmUgcmVjb3JkaW5nIGl0LgoKIyMgQ29udmVyc2F0aW9uCgpFYWNoIGxpbmUgaXMgYGZpZWxkIHwgcXVlc3Rpb24gfCBzdWdnZXN0aW9ucyB8IHJlcXVpcmVkP2AuIFN1Z2dlc3Rpb25zIGJlZ2lubmluZwp3aXRoIGBAYCBjb21lIGZyb20gdGhlIGFwcGxpY2F0aW9uJ3Mgb3duIGRhdGEuCgpgQHdvcmtlcnNgIGlzIHRoZSB3b3JrZXIgcHJvZmlsZXMgYWxyZWFkeSBvbiBzY3JlZW4gZm9yIHRoaXMgb3JnYW5pemF0aW9uLgpQaWNraW5nIG9uZSByZWNvcmRzIHRoZSByb2xlIGFnYWluc3QgdGhhdCBwZXJzb24ncyBwcm9maWxlIGFuZCBlbWFpbDsgdHlwaW5nIGFuCmVtYWlsIGFkZHJlc3MgdGhhdCBoYXMgbm8gcHJvZmlsZSB5ZXQgYWxzbyB3b3JrcywgYmVjYXVzZSBhIHJvbGUgY2FuIGJlIGRlY2xhcmVkCmJlZm9yZSBhIHByb2ZpbGUgZXhpc3RzLiBUaGUgd29ya2VyIGlzIGFsd2F5cyBhc2tlZCBmb3IgYW5kIGlzIG5ldmVyIGFzc3VtZWQgdG8KYmUgd2hvZXZlciBpcyB0eXBpbmcg4oCUIGFuIG9wZXJhdG9yIHJlY29yZHMgdGhpcyBvbiBzb21lYm9keSdzIGJlaGFsZi4KCi0gd29ya2VyIHwgV2hpY2ggd29ya2VyIGlzIHRoaXMgcm9sZSBmb3I/IFR5cGUgdGhlaXIgbmFtZSBvciBlbWFpbC4gfCBAd29ya2VycyB8IHJlcXVpcmVkCi0gcm9sZV9jYXRlZ29yeSB8IFdoYXQgcm9sZSBkbyB0aGV5IHdvcmsgYXM/IHwgQHJvbGVzIHwgcmVxdWlyZWQKLSBleHBlcmllbmNlX3llYXJzIHwgSG93IG11Y2ggZXhwZXJpZW5jZSBkbyB0aGV5IGhhdmU/IHwgTm8gZXhwZXJpZW5jZTsgMSB5ZWFyOyAyIHllYXJzOyAzKyB5ZWFycyB8IG9wdGlvbmFsCi0gZW5nbGlzaF9sZXZlbCB8IFdoYXQgaXMgdGhlaXIgRW5nbGlzaCBsZXZlbD8gfCBAZW5nbGlzaCB8IG9wdGlvbmFsCi0gY2VydGlmaWNhdGlvbnMgfCBBbnkgY2VydGlmaWNhdGlvbnMgdGhleSBob2xkPyB8IEBjZXJ0aWZpY2F0aW9uczsgTm9uZSB8IG9wdGlvbmFsCi0gZGVzaXJlZF9wYXkgfCBXaGF0IHBheSBhcmUgdGhleSBsb29raW5nIGZvcj8gfCAkMTjigJMkMjgvaHI7ICQyNeKAkyQzNS9ocjsgJDMw4oCTJDQwL2hyOyBDdXN0b20gfCBvcHRpb25hbAotIGF2YWlsYWJpbGl0eSB8IFdoZW4gYXJlIHRoZXkgYXZhaWxhYmxlPyB8IEBhdmFpbGFiaWxpdHkgfCBvcHRpb25hbAotIG5vdGVzIHwgQW55dGhpbmcgZWxzZSB3b3J0aCByZWNvcmRpbmc/IHwgfCBvcHRpb25hbAoKIyMgQWN0aW9ucwoKLSBjcmVhdGVfZW1wbG95ZWVfcm9sZQo=",
"bytes": 3110,
"kind": "skill",
"hasFrontmatter": true,
"frontmatter": {
"ok": true,
"data": {
"id": "create-employee-role",
"name": "Create Employee Role",
"description": "Record what a worker does — their role, experience, pay and availability — by answering a few questions in the chat.",
"pages": [
"talent-pool",
"positions"
],
"status": "active",
"version": 1,
"prompt": "Create an employee role",
"flow": "employee-role",
"triggers": [
"create an employee role",
"create employee role",
"create employee roles",
"add an employee role",
"add employee role",
"new employee role",
"create a worker role",
"create worker role",
"record a role for",
"add a worker role"
],
"actions": [
"create_employee_role"
]
},
"body": "# Create Employee Role\n\n## Purpose\n\nRecord a worker's declared professional role without leaving the page. Owliver\nasks one question at a time, offers the answers as chips, and reads the whole\nthing back before anything is written.\n\n**This is not Create Position, and the difference is the point.** A position is\nwhat the ORGANIZATION needs filled — a company, a title, a pay range it will\npay. An employee role is what a WORKER says they do — the role they present\nthemselves as, the experience they have, and the pay they are looking for. The\ntwo share a vocabulary and nothing else: \"3 years\" on a position is a minimum an\napplicant must clear, and the same words here are what this person has.\n\nThey are never joined by a column. Supply and demand meet through applications,\nwhich already carry the funnel, the interview and the outcome.\n\n## Capabilities\n\n- Understand requests to record what a worker does.\n- Ask who the role is for, and resolve the answer to a real worker profile.\n- Read the role, experience, English level, certifications, desired pay and\n availability out of a single sentence.\n- Ask only for what the request did not already answer.\n- Offer each answer as a suggestion, so the whole flow can be clicked.\n- Read the role back for confirmation before recording it.\n\n## Conversation\n\nEach line is `field | question | suggestions | required?`. Suggestions beginning\nwith `@` come from the application's own data.\n\n`@workers` is the worker profiles already on screen for this organization.\nPicking one records the role against that person's profile and email; typing an\nemail address that has no profile yet also works, because a role can be declared\nbefore a profile exists. The worker is always asked for and is never assumed to\nbe whoever is typing — an operator records this on somebody's behalf.\n\n- worker | Which worker is this role for? Type their name or email. | @workers | required\n- role_category | What role do they work as? | @roles | required\n- experience_years | How much experience do they have? | No experience; 1 year; 2 years; 3+ years | optional\n- english_level | What is their English level? | @english | optional\n- certifications | Any certifications they hold? | @certifications; None | optional\n- desired_pay | What pay are they looking for? | $18–$28/hr; $25–$35/hr; $30–$40/hr; Custom | optional\n- availability | When are they available? | @availability | optional\n- notes | Anything else worth recording? | | optional\n\n## Actions\n\n- create_employee_role"
},
"parse": {
"ok": true
},
"normalized": {
"id": "create-employee-role",
"name": "Create Employee Role",
"description": "Record what a worker does — their role, experience, pay and availability — by answering a few questions in the chat.",
"status": "active",
"pages": [
"talent-pool",
"positions"
],
"kind": "assistant",
"category": "",
"actions": [
"create_employee_role"
],
"triggers": [
"create an employee role",
"create employee role",
"create employee roles",
"add an employee role",
"add employee role",
"new employee role",
"create a worker role",
"create worker role",
"record a role for",
"add a worker role"
],
"declaredTriggers": true,
"prompt": "Create an employee role",
"facets": [
"owliver"
],
"skillId": null
},
"markdownVerbatim": true,
"accepted": true,
"rejection": null
},
{
"path": "src/skills/owliver/create-position.md",
"type": "skill",
"rawBase64": "LS0tCmlkOiBjcmVhdGUtcG9zaXRpb24KbmFtZTogQ3JlYXRlIFBvc2l0aW9uCmRlc2NyaXB0aW9uOiBDcmVhdGUgYSBwb3NpdGlvbiBieSBhbnN3ZXJpbmcgYSBmZXcgcXVlc3Rpb25zIGluIHRoZSBjaGF0LgpwYWdlczoKICAtIHBvc2l0aW9ucwpzdGF0dXM6IGFjdGl2ZQpwcm9tcHQ6IENyZWF0ZSBhIHBvc2l0aW9uCnRyaWdnZXJzOgogIC0gY3JlYXRlIGEgcG9zaXRpb24KICAtIGNyZWF0ZSBwb3NpdGlvbgogICMgQSBjbGllbnQgaXMgdGhlIGNvbXBhbnkgYSBwb3NpdGlvbiBpcyBzdGFmZmVkIGZvciwgc28gYXNraW5nIGZvciBvbmUgc3RhcnRzCiAgIyB0aGUgc2FtZSBjb252ZXJzYXRpb24g4oCUIGl0IHNpbXBseSBsZWFkcyB3aXRoIHRoZSBjb21wYW55IHF1ZXN0aW9uLgogIC0gY3JlYXRlIGEgY2xpZW50CiAgLSBjcmVhdGUgY2xpZW50CiAgLSBhZGQgYSBjbGllbnQKICAtIG5ldyBjbGllbnQKICAtIGNyZWF0ZSBhICogcG9zaXRpb24KICAtIGNyZWF0ZSAqIHBvc2l0aW9uCiAgLSBuZXcgcG9zaXRpb24KICAtIG5ldyAqIHBvc2l0aW9uCiAgLSBwb3N0IGEgam9iCiAgLSBwb3N0IGEgKiBqb2IKICAtIG9wZW4gYSByb2xlCiAgLSBvcGVuIGEgKiByb2xlCiAgLSBhZGQgYSBwb3NpdGlvbgogIC0gaSB3YW50IHRvIGhpcmUKYWN0aW9uczoKICAtIGNyZWF0ZV9wb3NpdGlvbgotLS0KCiMgQ3JlYXRlIFBvc2l0aW9uCgojIyBQdXJwb3NlCgpDcmVhdGUgYSBwb3NpdGlvbiB3aXRob3V0IGxlYXZpbmcgdGhlIFBvc2l0aW9ucyBwYWdlLiBPd2xpdmVyIGFza3MgZm9yIHdoYXQgaXQKZG9lcyBub3QgYWxyZWFkeSBrbm93LCBvbmUgcXVlc3Rpb24gYXQgYSB0aW1lLCBvZmZlcnMgdGhlIGFuc3dlcnMgYXMgY2hpcHMsIHRoZW4KcmVhZHMgdGhlIHdob2xlIHRoaW5nIGJhY2sgYmVmb3JlIGFueXRoaW5nIGlzIHdyaXR0ZW4uCgpObyBmb3JtIG9wZW5zLiBObyBwYWdlIGlzIG5hdmlnYXRlZCB0by4gVGhlIHJlY29yZCBjcmVhdGVkIGlzIHRoZSBzYW1lCmBKb2JQb3N0aW5nYCB0aGUgbWFudWFsIGZvcm0gd3JpdGVzLCB0aHJvdWdoIHRoZSBzYW1lIGNyZWF0ZSBhY3Rpb24uCgojIyBDYXBhYmlsaXRpZXMKCi0gVW5kZXJzdGFuZCByZXF1ZXN0cyB0byBjcmVhdGUgcG9zaXRpb25zLgotIFJlYWQgdGhlIHJvbGUsIGxvY2F0aW9uLCBwYXksIGV4cGVyaWVuY2UsIEVuZ2xpc2ggbGV2ZWwgYW5kIGNlcnRpZmljYXRpb25zIG91dAogIG9mIGEgc2luZ2xlIHNlbnRlbmNlLgotIEFzayBvbmx5IGZvciB3aGF0IHRoZSByZXF1ZXN0IGRpZCBub3QgYWxyZWFkeSBhbnN3ZXIuCi0gT2ZmZXIgZWFjaCBhbnN3ZXIgYXMgYSBzdWdnZXN0aW9uLCBzbyB0aGUgd2hvbGUgZmxvdyBjYW4gYmUgY2xpY2tlZC4KLSBSZWFkIHRoZSBwb3NpdGlvbiBiYWNrIGZvciBjb25maXJtYXRpb24gYmVmb3JlIGNyZWF0aW5nIGl0LgotIENyZWF0ZSB0aGUgcG9zaXRpb24gb24gdGhlIHBhZ2UgeW91IGFyZSBhbHJlYWR5IG9uLgoKIyMgQ29udmVyc2F0aW9uCgpFYWNoIGxpbmUgaXMgYGZpZWxkIHwgcXVlc3Rpb24gfCBzdWdnZXN0aW9ucyB8IHJlcXVpcmVkP2AuIFN1Z2dlc3Rpb25zIGJlZ2lubmluZwp3aXRoIGBAYCBjb21lIGZyb20gdGhlIGFwcGxpY2F0aW9uJ3Mgb3duIGRhdGEsIHNvIGEgcm9sZSBjYXRlZ29yeSBhZGRlZCBpbiB0aGUKZm9ybSBpcyBvZmZlcmVkIGhlcmUgd2l0aG91dCB0aGlzIGZpbGUgY2hhbmdpbmcuCgotIGNvbXBhbnkgfCBXaGljaCBjbGllbnQgaXMgdGhpcyByb2xlIGZvcj8gVHlwZSB0aGUgY29tcGFueSBuYW1lLiB8IHwgcmVxdWlyZWQKLSByb2xlX2NhdGVnb3J5IHwgV2hhdCByb2xlIGFyZSB5b3UgaGlyaW5nIGZvcj8gfCBAcm9sZXMgfCByZXF1aXJlZAotIGxvY2F0aW9uIHwgV2hlcmUgd2lsbCB0aGlzIHJvbGUgYmUgYmFzZWQ/IHwgQ2hlbm5haTsgQmVuZ2FsdXJ1OyBDb2ltYmF0b3JlOyBCYXkgQXJlYTsgT3RoZXIgfCByZXF1aXJlZAotIHBheSB8IFdoYXQgaXMgdGhlIHBheSByYW5nZT8gfCAkMTjigJMkMjgvaHI7ICQyNeKAkyQzNS9ocjsgJDMw4oCTJDQwL2hyOyBDdXN0b20gfCByZXF1aXJlZAotIG1pbl9leHBlcmllbmNlX3llYXJzIHwgQW55IG1pbmltdW0gZXhwZXJpZW5jZT8gfCBObyBtaW5pbXVtOyAxIHllYXI7IDIgeWVhcnM7IDMrIHllYXJzIHwgb3B0aW9uYWwKLSBlbmdsaXNoX3JlcXVpcmVkIHwgV2hhdCBpcyB0aGUgbWluaW11bSBFbmdsaXNoIGxldmVsPyB8IEBlbmdsaXNoIHwgb3B0aW9uYWwKLSBjZXJ0aWZpY2F0aW9uc19yZXF1aXJlZCB8IEFueSByZXF1aXJlZCBjZXJ0aWZpY2F0aW9ucz8gfCBAY2VydGlmaWNhdGlvbnM7IE5vbmUgfCBvcHRpb25hbAoKIyMgQWN0aW9ucwoKLSBjcmVhdGVfcG9zaXRpb24K",
"bytes": 2346,
"rawBase64": "LS0tCmlkOiBjcmVhdGUtcG9zaXRpb24KbmFtZTogQ3JlYXRlIFBvc2l0aW9uCmRlc2NyaXB0aW9uOiBDcmVhdGUgYSBwb3NpdGlvbiBieSBhbnN3ZXJpbmcgYSBmZXcgcXVlc3Rpb25zIGluIHRoZSBjaGF0LgpwYWdlczoKICAtIHBvc2l0aW9ucwpzdGF0dXM6IGFjdGl2ZQpwcm9tcHQ6IENyZWF0ZSBhIHBvc2l0aW9uCnRyaWdnZXJzOgogIC0gY3JlYXRlIGEgcG9zaXRpb24KICAtIGNyZWF0ZSBwb3NpdGlvbgogICMgQSBjbGllbnQgaXMgdGhlIGNvbXBhbnkgYSBwb3NpdGlvbiBpcyBzdGFmZmVkIGZvciwgc28gYXNraW5nIGZvciBvbmUgc3RhcnRzCiAgIyB0aGUgc2FtZSBjb252ZXJzYXRpb24g4oCUIGl0IHNpbXBseSBsZWFkcyB3aXRoIHRoZSBjb21wYW55IHF1ZXN0aW9uLgogIC0gY3JlYXRlIGEgY2xpZW50CiAgLSBjcmVhdGUgY2xpZW50CiAgLSBhZGQgYSBjbGllbnQKICAtIG5ldyBjbGllbnQKICAtIGNyZWF0ZSBhICogcG9zaXRpb24KICAtIGNyZWF0ZSAqIHBvc2l0aW9uCiAgLSBuZXcgcG9zaXRpb24KICAtIG5ldyAqIHBvc2l0aW9uCiAgLSBwb3N0IGEgam9iCiAgLSBwb3N0IGEgKiBqb2IKICAtIG9wZW4gYSByb2xlCiAgLSBvcGVuIGEgKiByb2xlCiAgLSBhZGQgYSBwb3NpdGlvbgogIC0gaSB3YW50IHRvIGhpcmUKYWN0aW9uczoKICAtIGNyZWF0ZV9wb3NpdGlvbgotLS0KCiMgQ3JlYXRlIFBvc2l0aW9uCgojIyBQdXJwb3NlCgpDcmVhdGUgYSBwb3NpdGlvbiB3aXRob3V0IGxlYXZpbmcgdGhlIFBvc2l0aW9ucyBwYWdlLiBPd2xpdmVyIGFza3MgZm9yIHdoYXQgaXQKZG9lcyBub3QgYWxyZWFkeSBrbm93LCBvbmUgcXVlc3Rpb24gYXQgYSB0aW1lLCBvZmZlcnMgdGhlIGFuc3dlcnMgYXMgY2hpcHMsIHRoZW4KcmVhZHMgdGhlIHdob2xlIHRoaW5nIGJhY2sgYmVmb3JlIGFueXRoaW5nIGlzIHdyaXR0ZW4uCgpObyBmb3JtIG9wZW5zLiBObyBwYWdlIGlzIG5hdmlnYXRlZCB0by4gVGhlIHJlY29yZCBjcmVhdGVkIGlzIHRoZSBzYW1lCmBKb2JQb3N0aW5nYCB0aGUgbWFudWFsIGZvcm0gd3JpdGVzLCB0aHJvdWdoIHRoZSBzYW1lIGNyZWF0ZSBhY3Rpb24uCgojIyBDYXBhYmlsaXRpZXMKCi0gVW5kZXJzdGFuZCByZXF1ZXN0cyB0byBjcmVhdGUgcG9zaXRpb25zLgotIFJlYWQgdGhlIHJvbGUsIGxvY2F0aW9uLCBwYXksIGV4cGVyaWVuY2UsIEVuZ2xpc2ggbGV2ZWwgYW5kIGNlcnRpZmljYXRpb25zIG91dAogIG9mIGEgc2luZ2xlIHNlbnRlbmNlLgotIEFzayBvbmx5IGZvciB3aGF0IHRoZSByZXF1ZXN0IGRpZCBub3QgYWxyZWFkeSBhbnN3ZXIuCi0gT2ZmZXIgZWFjaCBhbnN3ZXIgYXMgYSBzdWdnZXN0aW9uLCBzbyB0aGUgd2hvbGUgZmxvdyBjYW4gYmUgY2xpY2tlZC4KLSBSZWFkIHRoZSBwb3NpdGlvbiBiYWNrIGZvciBjb25maXJtYXRpb24gYmVmb3JlIGNyZWF0aW5nIGl0LgotIENyZWF0ZSB0aGUgcG9zaXRpb24gb24gdGhlIHBhZ2UgeW91IGFyZSBhbHJlYWR5IG9uLgoKIyMgQ29udmVyc2F0aW9uCgpFYWNoIGxpbmUgaXMgYGZpZWxkIHwgcXVlc3Rpb24gfCBzdWdnZXN0aW9ucyB8IHJlcXVpcmVkP2AuIFN1Z2dlc3Rpb25zIGJlZ2lubmluZwp3aXRoIGBAYCBjb21lIGZyb20gdGhlIGFwcGxpY2F0aW9uJ3Mgb3duIGRhdGEsIHNvIGEgcm9sZSBjYXRlZ29yeSBhZGRlZCBpbiB0aGUKZm9ybSBpcyBvZmZlcmVkIGhlcmUgd2l0aG91dCB0aGlzIGZpbGUgY2hhbmdpbmcuCgpgQGNvbXBhbmllc2AgaXMgdGhlIGNsaWVudHMgdGhpcyBvcmdhbml6YXRpb24gYWxyZWFkeSBzdGFmZnMgZm9yLCByZWFkIG9mZiB0aGUKcG9zdGluZ3MgYWxyZWFkeSBvbiBzY3JlZW4uIFBpY2tpbmcgb25lIGlzIGEgdGFwOyB0eXBpbmcgYSBuYW1lIHRoYXQgaXMgbm90IG9uCnRoZSBsaXN0IGlzIGhvdyBhIG5ldyBjbGllbnQgaXMgbmFtZWQsIHdoaWNoIGlzIGFsbCAiY3JlYXRlIGEgY2xpZW50IiBoYXMgZXZlcgptZWFudCBoZXJlIOKAlCB0aGUgY29tcGFueSBpcyBhIGZpZWxkIG9uIHRoZSBwb3NpdGlvbiwgbm90IGEgcmVjb3JkIG9mIGl0cyBvd24uCgotIGNvbXBhbnkgfCBXaGljaCBjbGllbnQgaXMgdGhpcyByb2xlIGZvcj8gfCBAY29tcGFuaWVzIHwgcmVxdWlyZWQKLSByb2xlX2NhdGVnb3J5IHwgV2hhdCByb2xlIGFyZSB5b3UgaGlyaW5nIGZvcj8gfCBAcm9sZXMgfCByZXF1aXJlZAotIGxvY2F0aW9uIHwgV2hlcmUgd2lsbCB0aGlzIHJvbGUgYmUgYmFzZWQ/IHwgQ2hlbm5haTsgQmVuZ2FsdXJ1OyBDb2ltYmF0b3JlOyBCYXkgQXJlYTsgT3RoZXIgfCByZXF1aXJlZAotIHBheSB8IFdoYXQgaXMgdGhlIHBheSByYW5nZT8gfCAkMTjigJMkMjgvaHI7ICQyNeKAkyQzNS9ocjsgJDMw4oCTJDQwL2hyOyBDdXN0b20gfCByZXF1aXJlZAotIG1pbl9leHBlcmllbmNlX3llYXJzIHwgQW55IG1pbmltdW0gZXhwZXJpZW5jZT8gfCBObyBtaW5pbXVtOyAxIHllYXI7IDIgeWVhcnM7IDMrIHllYXJzIHwgb3B0aW9uYWwKLSBlbmdsaXNoX3JlcXVpcmVkIHwgV2hhdCBpcyB0aGUgbWluaW11bSBFbmdsaXNoIGxldmVsPyB8IEBlbmdsaXNoIHwgb3B0aW9uYWwKLSBjZXJ0aWZpY2F0aW9uc19yZXF1aXJlZCB8IEFueSByZXF1aXJlZCBjZXJ0aWZpY2F0aW9ucz8gfCBAY2VydGlmaWNhdGlvbnM7IE5vbmUgfCBvcHRpb25hbAoKIyMgQWN0aW9ucwoKLSBjcmVhdGVfcG9zaXRpb24K",
"bytes": 2652,
"kind": "skill",
"hasFrontmatter": true,
"frontmatter": {
@@ -1757,7 +1840,7 @@
"create_position"
]
},
"body": "# Create Position\n\n## Purpose\n\nCreate a position without leaving the Positions page. Owliver asks for what it\ndoes not already know, one question at a time, offers the answers as chips, then\nreads the whole thing back before anything is written.\n\nNo form opens. No page is navigated to. The record created is the same\n`JobPosting` the manual form writes, through the same create action.\n\n## Capabilities\n\n- Understand requests to create positions.\n- Read the role, location, pay, experience, English level and certifications out\n of a single sentence.\n- Ask only for what the request did not already answer.\n- Offer each answer as a suggestion, so the whole flow can be clicked.\n- Read the position back for confirmation before creating it.\n- Create the position on the page you are already on.\n\n## Conversation\n\nEach line is `field | question | suggestions | required?`. Suggestions beginning\nwith `@` come from the application's own data, so a role category added in the\nform is offered here without this file changing.\n\n- company | Which client is this role for? Type the company name. | | required\n- role_category | What role are you hiring for? | @roles | required\n- location | Where will this role be based? | Chennai; Bengaluru; Coimbatore; Bay Area; Other | required\n- pay | What is the pay range? | $18–$28/hr; $25–$35/hr; $30–$40/hr; Custom | required\n- min_experience_years | Any minimum experience? | No minimum; 1 year; 2 years; 3+ years | optional\n- english_required | What is the minimum English level? | @english | optional\n- certifications_required | Any required certifications? | @certifications; None | optional\n\n## Actions\n\n- create_position"
"body": "# Create Position\n\n## Purpose\n\nCreate a position without leaving the Positions page. Owliver asks for what it\ndoes not already know, one question at a time, offers the answers as chips, then\nreads the whole thing back before anything is written.\n\nNo form opens. No page is navigated to. The record created is the same\n`JobPosting` the manual form writes, through the same create action.\n\n## Capabilities\n\n- Understand requests to create positions.\n- Read the role, location, pay, experience, English level and certifications out\n of a single sentence.\n- Ask only for what the request did not already answer.\n- Offer each answer as a suggestion, so the whole flow can be clicked.\n- Read the position back for confirmation before creating it.\n- Create the position on the page you are already on.\n\n## Conversation\n\nEach line is `field | question | suggestions | required?`. Suggestions beginning\nwith `@` come from the application's own data, so a role category added in the\nform is offered here without this file changing.\n\n`@companies` is the clients this organization already staffs for, read off the\npostings already on screen. Picking one is a tap; typing a name that is not on\nthe list is how a new client is named, which is all \"create a client\" has ever\nmeant here — the company is a field on the position, not a record of its own.\n\n- company | Which client is this role for? | @companies | required\n- role_category | What role are you hiring for? | @roles | required\n- location | Where will this role be based? | Chennai; Bengaluru; Coimbatore; Bay Area; Other | required\n- pay | What is the pay range? | $18–$28/hr; $25–$35/hr; $30–$40/hr; Custom | required\n- min_experience_years | Any minimum experience? | No minimum; 1 year; 2 years; 3+ years | optional\n- english_required | What is the minimum English level? | @english | optional\n- certifications_required | Any required certifications? | @certifications; None | optional\n\n## Actions\n\n- create_position"
},
"parse": {
"ok": true

10
go-api/internal/domain/definitions_schema_test.go
View File

@@ -723,6 +723,7 @@ func TestMigrationPairsAreComplete(t *testing.T) {
"000008_knowledge.up.sql",
"000009_confirmation_replay.up.sql",
"000010_definition_versions.up.sql",
"000011_employee_roles.up.sql",
}
if len(ups) != len(want) {
t.Fatalf("%d migrations, want %d — update this list deliberately", len(ups), len(want))
@@ -752,10 +753,11 @@ func TestMigrationsAddOnlyTheTablesWeDecidedOn(t *testing.T) {
// 17 from 000001, + auth_sessions (000004), + agent_definitions and
// skill_definitions (000005), + agent_runs (000006), + agent_confirmations
// (000007), + knowledge_documents and knowledge_chunks (000008),
// + definition_versions (000010). schema_migrations is golang-migrate's and
// is absent when the files are applied directly.
if n != 25 {
t.Errorf("%d base tables after every migration, want 25", n)
// + definition_versions (000010), + employee_roles (000011).
// schema_migrations is golang-migrate's and is absent when the files are
// applied directly.
if n != 26 {
t.Errorf("%d base tables after every migration, want 26", n)
}
// `definition_versions` was on this list, deferred by the Phase 4B decision.

20
go-api/internal/domain/policy.go
View File

@@ -252,6 +252,26 @@ var policies = map[string]*Policy{
Derived: []Derived{{Column: "user_id", Source: DeriveUserID, TalentOnly: true}},
},
// What a worker declares they do, as opposed to what the organization needs
// filled — that is job-postings. Operators maintain the organization's;
// talent reads their own and no one else's.
//
// Create is operators-only, and that is an I1 decision rather than a
// deferral of one. The worker is named explicitly on the row and is
// deliberately NOT derived from the session, because an operator recording
// a role on somebody's behalf is the whole point of the flow. Granting
// talent Create with the same shape would let a talent caller write a role
// under any worker_email in the tenant, which is precisely the attribution
// hole Phase 3D closed elsewhere. When a talent console exists, the grant
// arrives together with a TalentOnly derivation of worker_email — one line,
// not a migration, which is what the scope below is already in place for.
"employee-roles": {
List: everyone, Get: everyone,
Create: operators, Update: operators,
TalentScope: Scope{Kind: ScopeEmail, Column: "worker_email"},
Derived: []Derived{{Column: "created_by", Source: DeriveUserID}},
},
// Who is on which position. Operators allocate; talent reads their own
// roster and cannot create one — being assigned to work is not a thing you
// do to yourself.

8
go-api/internal/domain/policy_test.go
View File

@@ -103,14 +103,16 @@ func TestDerivedColumnsAreReadOnlyOrTalentScoped(t *testing.T) {
}
}
// The six columns Phase 3D closed. Named explicitly, so that regenerating the
// descriptors without the SERVER_OWNED map in gen_resources.py fails loudly
// rather than silently reopening the holes.
// The columns Phase 3D closed, plus every one added on the same rule since.
// Named explicitly, so that regenerating the descriptors without the
// SERVER_OWNED map in gen_resources.py fails loudly rather than silently
// reopening the holes.
func TestServerOwnedColumnsAreReadOnly(t *testing.T) {
sealed := map[string][]string{
"worker-profiles": {"user_id"},
"user-activity": {"user_id", "user_email", "user_name", "account_type"},
"job-postings": {"created_by"},
"employee-roles": {"created_by"},
}
for path, cols := range sealed {
res, ok := ResourceByPath[path]

25
go-api/internal/domain/resources_gen.go
View File

@@ -371,6 +371,31 @@ var AllResources = []*Resource{
{Name: "updated_date", Kind: KindTimestamp, PGType: "timestamptz", NotNull: true, ReadOnly: true},
},
},
{
Name: "EmployeeRole", Path: "employee-roles", Table: "employee_roles",
DefaultSort: "-created_date", DefaultLimit: 200,
Ops: OpList | OpGet | OpCreate | OpUpdate,
Columns: []Column{
{Name: "id", Kind: KindUUID, PGType: "uuid", NotNull: true, ReadOnly: true},
{Name: "legacy_id", Kind: KindString, PGType: "text", ReadOnly: true},
{Name: "org_id", Kind: KindUUID, PGType: "uuid", NotNull: true, ReadOnly: true},
{Name: "worker_profile_id", Kind: KindUUID, PGType: "uuid"},
{Name: "worker_email", Kind: KindString, PGType: "citext", NotNull: true, Required: true},
{Name: "worker_name", Kind: KindString, PGType: "text", NotNull: true},
{Name: "role_category", Kind: KindString, PGType: "text", NotNull: true, Required: true},
{Name: "experience_years", Kind: KindInt, PGType: "int", NotNull: true},
{Name: "english_level", Kind: KindEnum, PGType: "english_level", NotNull: true, Enum: []string{"basic", "conversational", "fluent", "native"}},
{Name: "certifications", Kind: KindTextArray, PGType: "text[]", NotNull: true},
{Name: "desired_pay_min", Kind: KindInt, PGType: "int", NotNull: true},
{Name: "desired_pay_max", Kind: KindInt, PGType: "int", NotNull: true},
{Name: "availability", Kind: KindTextArray, PGType: "text[]", NotNull: true},
{Name: "notes", Kind: KindString, PGType: "text", NotNull: true},
{Name: "status", Kind: KindEnum, PGType: "employee_role_status", NotNull: true, Enum: []string{"seeking", "placed", "inactive"}},
{Name: "created_by", Kind: KindUUID, PGType: "uuid", ReadOnly: true},
{Name: "created_date", Kind: KindTimestamp, PGType: "timestamptz", NotNull: true, ReadOnly: true},
{Name: "updated_date", Kind: KindTimestamp, PGType: "timestamptz", NotNull: true, ReadOnly: true},
},
},
// Badge serves NO endpoint: useBadges has zero consumers and every
// badge the UI renders comes from worker_profiles.earned_badges. The
// descriptor exists so the seeder can write the table. api-contract.md §2.

3
go-api/internal/httpserver/api_test.go
View File

@@ -211,6 +211,7 @@ func TestListEveryResource(t *testing.T) {
"job-postings", "job-applications", "ai-interviews", "staff", "worker-profiles",
"courses", "learning-paths", "role-categories", "certifications",
"user-activity", "evidence", "assignments", "shift-records",
"employee-roles",
} {
r := a.do("GET", "/api/v1/"+path, nil)
if r.code != http.StatusOK {
@@ -255,7 +256,7 @@ func TestEndpointSpecificDefaults(t *testing.T) {
{"worker-profiles", 500}, {"courses", 200}, {"user-activity", 500},
{"ai-interviews", 100}, {"staff", 100}, {"role-categories", 100},
{"certifications", 200}, {"evidence", 200}, {"assignments", 500},
{"learning-paths", 100},
{"learning-paths", 100}, {"employee-roles", 200},
} {
m := a.do("GET", "/api/v1/"+tc.path, nil).meta(t)
if m["limit"] != tc.limit {

10
go-api/internal/httpserver/rbac_test.go
View File

@@ -137,6 +137,16 @@ func TestRoleMatrix(t *testing.T) {
"full_name": "W", "email": "w@example.test"}}, nil},
{call{"PATCH", "/api/v1/worker-profiles/" + zeroUUID, map[string]any{"phone": "1"}}, nil},
// What a worker declares they do. Operators maintain them; talent may
// read (scoped to their own by policy) but never write — a talent
// caller who could POST here would name any worker_email in the tenant.
{call{"GET", "/api/v1/employee-roles", nil}, nil},
{call{"GET", "/api/v1/employee-roles/" + zeroUUID, nil}, nil},
{call{"POST", "/api/v1/employee-roles", map[string]any{
"worker_email": "w@example.test", "role_category": "Bartender"}}, []string{"talent"}},
{call{"PATCH", "/api/v1/employee-roles/" + zeroUUID, map[string]any{
"notes": "n"}}, []string{"talent"}},
{call{"GET", "/api/v1/assignments", nil}, nil},
{call{"POST", "/api/v1/assignments", map[string]any{
"job_posting_id": r.activePosting, "worker_email": "w@example.test",

65
go-api/internal/owliver/catalog.go
View File

@@ -222,6 +222,55 @@ var catalogue = map[string][]Intent{
/* ── Positions — the roles being filled ────────────────────────────── */
"positions": {
{
/**
* Creating a position, offered as a chip.
*
* The only intent on this page that WRITES, which is why it reads
* job-postings with OpCreate: the permission gate ahead of ranking
* then answers "may this caller create one?" from the same policy
* table the endpoint uses, and a talent caller is never offered it.
*
* Terms are PHRASES ONLY, deliberately. A bare "position" or "role"
* term would join the score-10 tie every reading on this page is in
* and evict one of them from the exact ordered result
* TestPositionsSuggestions asserts — a create chip would arrive by
* pushing a reading out, which is not a trade this page should make
* silently.
*
* No Subject and no Shapes, on the precedent of position-spec-steps:
* a Subject would let the bare query "summarize" match this through
* matchShape and survive filterOnTopic, offering "Summarize creating
* a position" to somebody who asked for an overview of the page.
*
* OrgWide stays false. ScopeFor is the READ predicate; it says
* nothing about a write and asking it here would be a category
* error that happens to return the right answer.
*
* No Signal: never offered unprompted. An empty composer should
* report what the organization needs, not propose paperwork.
*/
ID: "create-company-position", Text: "Create a company position",
Terms: []string{"create position", "create a position", "create new position",
"create a new position", "new position", "post a job", "post a new job",
"create a company position", "open a role", "add a position", "create"},
Reads: []Need{{Resource: "job-postings", Op: domain.OpCreate}},
},
{
/**
* The supply-side twin, offered here as well as on Talent Pool
* because "create" on Positions is ambiguous between the two and
* showing both is how the reader tells them apart. The wording is
* what disambiguates: "company" and "employee" carry it, and the
* chip text is what the panel dispatches, so the choice the reader
* makes is the one that routes.
*/
ID: "create-employee-role", Text: "Create an employee role",
Terms: []string{"create employee role", "create an employee role",
"add an employee role", "new employee role", "create worker role",
"add a worker role", "employee role", "worker role"},
Reads: []Need{{Resource: "employee-roles", Op: domain.OpCreate}},
},
{
ID: "position-drafts", Text: "Which positions are still unfinished drafts?",
Subject: "the unfinished drafts", Shapes: []string{"list", "table"},
@@ -484,6 +533,22 @@ var catalogue = map[string][]Intent{
/* ── Talent Pool — supply, before anyone applies ───────────────────── */
"talent-pool": {
{
/**
* Recording what a worker does, offered as a chip.
*
* The write on this page. Same construction as its twin on
* Positions — phrases only, no Subject, no Signal — and the same
* permission gate: employee-roles grants Create to operators, so a
* talent caller is never offered it even though they may read their
* own.
*/
ID: "create-employee-role", Text: "Create an employee role",
Terms: []string{"create employee role", "create an employee role",
"add an employee role", "new employee role", "create worker role",
"add a worker role", "employee role", "worker role", "add a worker"},
Reads: []Need{{Resource: "employee-roles", Op: domain.OpCreate}},
},
{
ID: "talent-priorities", Text: "Who should I prioritize in the talent pool?",
Subject: "the talent priorities", Shapes: []string{"list", "table", "stats"},

87
go-api/internal/owliver/suggest_test.go
View File

@@ -110,6 +110,85 @@ func TestPositionsSuggestions(t *testing.T) {
/* ── Candidates ─────────────────────────────────────────────────────────── */
// Creating a record is offered on the words people actually type, and the two
// creates are told apart by the words that distinguish them.
//
// This is the half of the feature that was missing entirely: the flow behind
// "create a position" worked, and no chip anywhere offered it. Every phrasing
// below reached the frontend's trigger matcher already — the gap was that the
// panel never suggested any of them.
func TestCreateIntentsAreOffered(t *testing.T) {
for _, c := range []struct {
query string
want string
}{
{"create position", "create-company-position"},
{"create positions", "create-company-position"},
{"create a position", "create-company-position"},
{"create new position", "create-company-position"},
{"new position", "create-company-position"},
{"post a job", "create-company-position"},
{"create a company position", "create-company-position"},
{"create an employee role", "create-employee-role"},
{"create employee role", "create-employee-role"},
{"add an employee role", "create-employee-role"},
{"new employee role", "create-employee-role"},
{"create worker role", "create-employee-role"},
} {
t.Run(c.query, func(t *testing.T) {
got := intents(ask("positions", c.query))
if len(got) == 0 || got[0] != c.want {
t.Fatalf("query %q: got %v, want %s first", c.query, got, c.want)
}
})
}
// And the supply-side create is on the page that reads the supply.
if got := intents(ask("talent-pool", "create an employee role")); len(got) == 0 || got[0] != "create-employee-role" {
t.Errorf("talent-pool: got %v, want create-employee-role first", got)
}
}
// A create chip is never proposed to somebody who cannot create.
//
// The gate is the policy table, not a role list repeated here: employee-roles
// and job-postings both grant Create to operators only, so talent is offered
// neither — while still being offered their own readings elsewhere, which
// TestTalentIsStillOfferedTheirOwnReadings holds.
func TestTalentIsNeverOfferedACreate(t *testing.T) {
for _, page := range []string{"positions", "talent-pool"} {
for _, query := range []string{
"create position", "create a position", "new position", "post a job",
"create an employee role", "add an employee role", "employee role",
} {
for _, s := range Suggest(page, query, domain.RoleTalent) {
if strings.HasPrefix(s.Intent, "create-") {
t.Errorf("talent was offered %q on %q for %q", s.Intent, page, query)
}
}
}
}
}
// The create chips arrive without evicting a reading.
//
// Their terms are phrases only for exactly this reason. A bare "position" term
// would score 10 — the same as every reading on the page — and win the tie on
// declaration order, silently pushing `positions-attention` out of the three.
// The reading a person asked for must not be displaced by an offer to create
// something, so this pins the page's own noun to the page's own answers.
func TestCreateIntentsDoNotDisplaceReadings(t *testing.T) {
for _, query := range []string{"position", "positions", "role", "roles", "draft"} {
for _, s := range Suggest("positions", query, domain.RoleAdmin) {
if strings.HasPrefix(s.Intent, "create-") {
t.Errorf("%q offered %q; a bare page noun must answer with readings",
query, s.Intent)
}
}
}
}
func TestCandidatesSuggestions(t *testing.T) {
cases := []struct {
name string
@@ -606,6 +685,14 @@ func TestIntentIDsAreFrontendCapabilities(t *testing.T) {
// POSITIONS_CAPABILITIES
"position-drafts", "position-strength", "positions-attention", "hiring-priority",
"candidates-waiting",
// The two conversational writes. Not manifest ids: no context declares
// `capabilities`, so every server chip dispatches as its own TEXT and is
// answered by the skill whose trigger that text matches. They are listed
// here because this test is the bijection that keeps a suggestion the
// panel cannot run out of the catalogue, and the coupling that makes
// these runnable — chip text to skill trigger — is asserted by
// `npm test` on the frontend side.
"create-company-position", "create-employee-role",
// CANDIDATE_LIST_CAPABILITIES
"candidates-attention", "top-candidates", "interview-ready", "screening-gaps",
"pipeline-summary", "candidate-risk",