@damian87/omp 0.1.0 → 0.3.0

package/dist/src/team/types.d.ts

@@ -43,3 +43,28 @@ export interface OutboxMessage {
     detail?: string;
     timestamp: string;
 }
+/**
+ * A team mailbox message (worker<->worker or worker<->leader).
+ * Mailbox files are append-only JSONL; delivery is tracked via separate
+ * append-only DeliveryReceipt lines, never by rewriting the message line.
+ */
+export interface MailboxMessage {
+    type: "message";
+    id: string;
+    from: string;
+    to: string;
+    body: string;
+    timestamp: string;
+}
+/** Append-only delivery acknowledgement for a MailboxMessage. */
+export interface DeliveryReceipt {
+    type: "delivery-receipt";
+    messageId: string;
+    deliveredAt: string;
+}
+/** A single line in a mailbox JSONL file. */
+export type MailboxLine = MailboxMessage | DeliveryReceipt;
+/** Merged view returned by listMailbox: a message with optional delivery info. */
+export interface MailboxMessageView extends MailboxMessage {
+    deliveredAt?: string;
+}

package/dist/src/team/worker-bootstrap.js

@@ -24,6 +24,22 @@ export function buildInboxMarkdown(opts) {
         to: "failed",
         claim_token: "<claim_token>",
     });
+    const sendToLeaderInput = JSON.stringify({
+        team_name: opts.teamName,
+        from: opts.workerName,
+        to: "leader",
+        body: "<message>",
+    });
+    const sendToPeerInput = JSON.stringify({
+        team_name: opts.teamName,
+        from: opts.workerName,
+        to: "<teammate>",
+        body: "<message>",
+    });
+    const mailboxListInput = JSON.stringify({
+        team_name: opts.teamName,
+        worker: opts.workerName,
+    });
     return [
         "## REQUIRED: Task Lifecycle Commands",
         "You MUST run these commands. Do NOT skip any step.",
@@ -47,6 +63,19 @@ export function buildInboxMarkdown(opts) {
         "## Description",
         opts.task.description,
         "",
+        "## Messaging",
+        "You can message the leader OR any teammate directly. The recipient is auto-nudged.",
+        "Unknown recipient names are rejected with `unknown_recipient`.",
+        "",
+        "Message the leader:",
+        `   omp team api send-message --input '${sendToLeaderInput}' --json`,
+        "",
+        "Message a teammate (replace <teammate> with their worker name):",
+        `   omp team api send-message --input '${sendToPeerInput}' --json`,
+        "",
+        "Check your mailbox:",
+        `   omp team api mailbox-list --input '${mailboxListInput}' --json`,
+        "",
     ].join("\n");
 }
 //# sourceMappingURL=worker-bootstrap.js.map

package/dist/src/team/worker-bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-bootstrap.js","sourceRoot":"","sources":["../../../src/team/worker-bootstrap.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3C,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,aAAa;QACnB,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,eAAe;QAC5B,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QACvC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,aAAa;QACnB,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,eAAe;KAC7B,CAAC,CAAC;IACH,OAAO;QACL,sCAAsC;QACtC,oDAAoD;QACpD,EAAE;QACF,qBAAqB;QACrB,uCAAuC,UAAU,UAAU;QAC3D,4CAA4C;QAC5C,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,iDAAiD;QACjD,mDAAmD,qBAAqB,UAAU;QAClF,EAAE;QACF,gBAAgB;QAChB,mDAAmD,iBAAiB,UAAU;QAC9E,EAAE;QACF,oBAAoB;QACpB,YAAY,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;QAC1B,WAAW,IAAI,CAAC,UAAU,EAAE;QAC5B,EAAE;QACF,gBAAgB;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW;QACrB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"worker-bootstrap.js","sourceRoot":"","sources":["../../../src/team/worker-bootstrap.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3C,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,aAAa;QACnB,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,eAAe;QAC5B,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QACvC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,aAAa;QACnB,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,eAAe;KAC7B,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QACvC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,WAAW;KAClB,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,WAAW;KAClB,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC;QACtC,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,MAAM,EAAE,IAAI,CAAC,UAAU;KACxB,CAAC,CAAC;IACH,OAAO;QACL,sCAAsC;QACtC,oDAAoD;QACpD,EAAE;QACF,qBAAqB;QACrB,uCAAuC,UAAU,UAAU;QAC3D,4CAA4C;QAC5C,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,iDAAiD;QACjD,mDAAmD,qBAAqB,UAAU;QAClF,EAAE;QACF,gBAAgB;QAChB,mDAAmD,iBAAiB,UAAU;QAC9E,EAAE;QACF,oBAAoB;QACpB,YAAY,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;QAC1B,WAAW,IAAI,CAAC,UAAU,EAAE;QAC5B,EAAE;QACF,gBAAgB;QAChB,IAAI,CAAC,IAAI,CAAC,WAAW;QACrB,EAAE;QACF,cAAc;QACd,oFAAoF;QACpF,gEAAgE;QAChE,EAAE;QACF,qBAAqB;QACrB,yCAAyC,iBAAiB,UAAU;QACpE,EAAE;QACF,iEAAiE;QACjE,yCAAyC,eAAe,UAAU;QAClE,EAAE;QACF,qBAAqB;QACrB,yCAAyC,gBAAgB,UAAU;QACnE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/test/catalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/catalog.test.js

@@ -0,0 +1,21 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { loadCapabilityCatalog, loadSkillCatalog, validateCatalog } from '../src/catalog.js';
+test('catalog contains approved MVP skills and valid projections', () => {
+    const catalog = loadSkillCatalog();
+    assert.deepEqual(validateCatalog(), []);
+    const names = catalog.skills.map((skill) => skill.name);
+    assert.deepEqual(names, ['grill', 'verify', 'jira-ticket', 'code-review', 'qa']);
+    assert.ok(catalog.projectionCommands.includes('grill-me'));
+    assert.ok(catalog.projectionCommands.includes('team'));
+    assert.ok(catalog.projectionCommands.includes('ralph'));
+});
+test('team and ralph stay thin handoff capabilities for Copilot', () => {
+    const capabilities = loadCapabilityCatalog();
+    for (const name of ['team', 'ralph']) {
+        const capability = capabilities.capabilities.find((entry) => entry.name === name);
+        assert.ok(capability, `${name} capability exists`);
+        assert.equal(capability.support.copilot, 'thin-handoff');
+    }
+});
+//# sourceMappingURL=catalog.test.js.map

package/dist/test/catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.test.js","sourceRoot":"","sources":["../../test/catalog.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7F,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACtE,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IACjF,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,YAAY,GAAG,qBAAqB,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAClF,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/test/jira.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/jira.test.js

@@ -0,0 +1,26 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { commentPayload, createIssuePayload, discoverJiraConfig, isJiraConfigured, linkFallbackPayload, safeUpdatePayload, transitionFallbackPayload } from '../src/jira.js';
+test('jira config discovery supports env and configuration detection', () => {
+    const config = discoverJiraConfig('/tmp/no-such-root', {
+        JIRA_SITE_URL: 'https://example.atlassian.net',
+        JIRA_EMAIL: 'agent@example.com',
+        JIRA_API_TOKEN: 'secret-token',
+        JIRA_PROJECT_KEY: 'OMC'
+    });
+    assert.equal(config.siteUrl, 'https://example.atlassian.net');
+    assert.equal(config.projectKey, 'OMC');
+    assert.equal(isJiraConfigured(config), true);
+});
+test('jira adapter renders create, comment, update, and fallback payloads', () => {
+    const config = discoverJiraConfig('/tmp/no-such-root', { JIRA_PROJECT_KEY: 'OMC' });
+    const create = createIssuePayload(config, { summary: 'Implement slice', description: 'Body' });
+    assert.equal(create.operation, 'create');
+    assert.equal(create.configured, false);
+    assert.match(JSON.stringify(create.body), /Implement slice/);
+    assert.equal(commentPayload(config, 'OMC-1', 'Evidence').operation, 'comment');
+    assert.equal(safeUpdatePayload(config, 'OMC-1', { summary: 'New' }).method, 'PUT');
+    assert.equal(transitionFallbackPayload(config, 'OMC-1', 'Done').configured, false);
+    assert.equal(linkFallbackPayload(config, 'OMC-1', 'OMC-2').operation, 'link-fallback');
+});
+//# sourceMappingURL=jira.test.js.map

package/dist/test/jira.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.test.js","sourceRoot":"","sources":["../../test/jira.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE7K,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,MAAM,GAAG,kBAAkB,CAAC,mBAAmB,EAAE;QACrD,aAAa,EAAE,+BAA+B;QAC9C,UAAU,EAAE,mBAAmB;QAC/B,cAAc,EAAE,cAAc;QAC9B,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,+BAA+B,CAAC,CAAC;IAC9D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qEAAqE,EAAE,GAAG,EAAE;IAC/E,MAAM,MAAM,GAAG,kBAAkB,CAAC,mBAAmB,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpF,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/F,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE7D,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC/E,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACnF,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACnF,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AACzF,CAAC,CAAC,CAAC"}

package/dist/test/lint.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/lint.test.js

@@ -0,0 +1,9 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { lintSkills } from '../src/lint.js';
+import { workspaceRoot } from '../src/project.js';
+test('workspace skills satisfy Phase 1 catalog lint', () => {
+    const issues = lintSkills(workspaceRoot('..'));
+    assert.deepEqual(issues.filter((issue) => issue.level === 'error'), []);
+});
+//# sourceMappingURL=lint.test.js.map

package/dist/test/lint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.test.js","sourceRoot":"","sources":["../../test/lint.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC,CAAC"}

package/dist/test/sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/sync.test.js

@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { projectCopilotCommands } from '../src/sync.js';
+test('dry-run projects skill aliases and thin runtime handoffs', () => {
+    const files = projectCopilotCommands();
+    const paths = files.map((file) => file.path);
+    assert.ok(paths.includes('.github/copilot/commands/grill.md'));
+    assert.ok(paths.includes('.github/copilot/commands/grill-me.md'));
+    assert.ok(paths.includes('.github/copilot/commands/team.md'));
+    assert.ok(paths.includes('.github/copilot/commands/ralph.md'));
+    const team = files.find((file) => file.path.endsWith('/team.md'));
+    assert.ok(team?.content.includes('thin capability handoff'));
+    assert.ok(team?.content.includes('not a Copilot-native durable runtime'));
+});
+//# sourceMappingURL=sync.test.js.map

package/dist/test/sync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.test.js","sourceRoot":"","sources":["../../test/sync.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC,CAAC;IAE/D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC"}

package/docs/general-skills.md

@@ -6,14 +6,14 @@ The canonical skill source is the repo-local `.github/skills` directory. This is
 
 | Skill | Capability IDs | Purpose |
 | --- | --- | --- |
-| `/codebase-research` | `codebase-research`, `research.codebase` | Read repo evidence before planning or asking. |
+| `/research-codebase` | `research-codebase`, `research.codebase` | Comprehensive codebase research with tiered effort. |
 | `/grill-me` | `grill-me`, `planning.challenge` | Ask one sharp clarification question when ambiguity remains. |
 | `/ralplan` | `ralplan`, `planning.consensus` | Produce implementation-ready plan, tests, and risks. |
-| `/team` | `team`, `execution.parallel` | Split approved work into parallel lanes. |
+| `/team` | `team`, `execution.parallel` | Split approved work into parallel tmux panes running interactive agents. |
 | `/ralph` | `ralph`, `execution.single-owner` | Single-owner execute-fix-verify loop. |
 | `/ultrawork` | `ultrawork`, `execution.parallel` | Batch many independent small tasks. |
 | `/ultraqa` | `ultraqa`, `qa.behavioral` | Adversarial behavior and regression QA. |
-| `/omc-autopilot` | `omc-autopilot`, `execution.autonomous` | Lightweight end-to-end flow across the other skills. (Renamed from `/autopilot` to avoid Copilot CLI built-in collision.) |
+| `/omp-autopilot` | `omp-autopilot`, `execution.autonomous` | Lightweight end-to-end flow across the other skills. (Renamed from `/autopilot` to avoid Copilot CLI built-in collision.) |
 | `/code-review` | `code-review`, `review.independent` | Review completed changes before merge or handoff. |
 | `/verify` | `verify`, `verification.evidence` | Prove completion claims with evidence. |
 | `/jira-ticket` | `jira-ticket`, `tracker.ticket` | Render Jira create/comment/safe-update payloads. |
@@ -21,6 +21,7 @@ The canonical skill source is the repo-local `.github/skills` directory. This is
 | `/caveman` | `caveman`, `communication.compact` | Ultra-compact response mode. |
 | `/debug` | `debug`, `debug.systematic` | Reproduce, diagnose, fix, and regression-test bugs. |
 | `/tdd` | `tdd`, `testing.tdd` | Red-green-refactor for behavior changes. |
+| `/worktree` | `worktree`, `workflow.worktree` | Git worktree-based parallel branch work. |
 
 ## Repo-local layout
 
@@ -52,7 +53,7 @@ It does not imply a durable execution runtime. Phase 1 execution skills such as
 ## Phase 1 flow
 
 ```text
-/codebase-research
+/research-codebase
   -> /grill-me when unclear or risky
   -> /ralplan
   -> /team if lanes are independent, otherwise /ralph or /ultrawork

package/docs/plans/2026-05-29-team-messaging-and-nudge-gating-design.md

@@ -0,0 +1,170 @@
+# Design: Team messaging (worker↔worker / worker↔leader) + nudge gating
+
+> Status: **Design only — no implementation yet.** Target repo: `oh-my-copilot`.
+> Date: 2026-05-29
+
+## 1. Problem & evidence
+
+Two related gaps in `src/team`:
+
+**A. Workers cannot message anyone.** The entire `team api` surface (`src/cli.ts:35`) is:
+
+- `team api claim-task`
+- `team api transition-task-status`
+
+There is **no `send-message`, `broadcast`, or mailbox** anywhere in `src`. The only
+worker→lead signal is an outbox line auto-appended on task transition
+(`src/team/api.ts:55-65`), consumed by the monitor (`readNewOutbox`). So a worker
+cannot ask the lead a question, hand off to a peer, or nudge a teammate. This is the
+"teams says limitation can't message" behavior.
+
+This must work **without MCP** (Copilot CLI; MCP is disabled in the target org). The
+existing design is already file + CLI based, so this is the natural fit.
+
+**B. Nudge is ungated.** `NudgeTracker` runs only inside `monitorTeam`
+(`src/team/runtime.ts:224`) and is **default-on** (`:213`). `monitorTeam` is not yet
+wired into any command, so nudge effectively never fires today — but when it is wired
+in, default-on would nudge every monitored team run (including read-only polling).
+Desired: **off by default, but ON for `/team` orchestration runs and for active
+ralph/loop modes.** Plain read-only polling (`team status`) and library/one-shot use
+stay quiet.
+
+## 2. What already exists (reuse, don't rebuild)
+
+- `state-paths.ts` already defines `mailboxDir` (`.omp/state/team/<team>/mailbox`) and
+  `dispatchDir`, and `ensureTeamDirs` already creates them. Workers already have
+  `inboxFile` (`workers/<name>/inbox.md`), `outboxFile`, `heartbeatFile`, pane id in
+  config (`Worker.paneId`).
+- `tmux.ts` exposes `sendToWorker(api, paneId, text, …)` — the nudge transport.
+- `outbox.ts` has a robust byte-cursor JSONL reader we can mirror for mailbox reads.
+
+## 3. Feature A — messaging
+
+### 3.1 Data model
+
+New file `src/team/mailbox.ts`. One JSONL file per recipient:
+`.omp/state/team/<team>/mailbox/<recipient>.jsonl`, plus a `.<recipient>.offset` cursor
+(mirror `outbox.ts`). `leader` is the reserved recipient name for the lead.
+
+```ts
+export interface MailboxMessage {
+  id: string;          // uuid
+  from: string;        // worker name or "leader"
+  to: string;          // worker name or "leader"
+  body: string;
+  timestamp: string;   // ISO
+  deliveredAt?: string;
+}
+```
+
+Functions: `appendMailbox`, `readNewMailbox`/`peekMailbox` (cursor-based),
+`listMailbox`, `markDelivered`.
+
+### 3.2 API surface (additions to `src/team/api.ts` + `cli.ts`)
+
+- `team api send-message --input '{team_name, from, to, body, cwd?}'`
+  → validates `to` is `leader` or a registered worker (`config.workers`), rejects
+  unknown recipients with `unknown_recipient` (no phantom mailbox), appends to the
+  recipient mailbox, then **nudges the recipient pane** (see 3.3).
+- `team api broadcast --input '{team_name, from, body, cwd?}'`
+  → fans out to **every worker except `from`, PLUS the `leader` mailbox**.
+  Reuses oh-my-claudecode's mechanism (`teamBroadcast`, `team-ops.ts:604`: loop
+  recipients → `send` to each), but oh-my-claudecode skips the lead (it only iterates
+  `cfg.workers`); here we additionally append `leader` to the recipient set so the lead
+  receives broadcasts too. Sender is always excluded (no self-message, no echo loop).
+- `team api mailbox-list --input '{team_name, worker, cwd?}'` → list (optionally
+  undelivered only).
+- `team api mailbox-mark-delivered --input '{team_name, worker, message_id, cwd?}'`.
+
+All pure file ops, callable directly in tests (no MCP, no tmux required for persistence).
+
+### 3.3 Delivery / nudge
+
+After persisting, look up the recipient's `paneId` from `config.workers` (or
+`leader_pane_id` in config). If present and a tmux session is live, call
+`sendToWorker(...)` with a short trigger. If no pane (worker not spawned / headless
+test), persistence still succeeds — delivery is pull-based via `mailbox-list`.
+**Nudge-on-send reuses the same `sendToWorker` transport, independent of the
+idle-`NudgeTracker`.**
+
+**Throttle/coalesce — reuse what already exists, build nothing new:**
+- The idle `NudgeTracker` (`idle-nudge.ts`) already carries the same throttle as
+  oh-my-claudecode (`scanIntervalMs: 5000`, `maxCount: 3`) — unchanged.
+- For send-nudge, mirror oh-my-claudecode's `generateMailboxTriggerMessage(count)`:
+  the trigger states the **unread count** (`listMailbox(...).filter(!deliveredAt).length`)
+  — "N new msg(s): read your mailbox …". Multiple messages arriving before the worker
+  reads simply raise the count in the next poke rather than spamming distinct triggers.
+  No separate coalescing/debounce machinery.
+
+### 3.4 Worker overlay (`worker-bootstrap.ts buildInboxMarkdown`)
+
+Add a "Messaging" section teaching workers they may message the **lead OR any teammate**:
+
+```
+omp team api send-message --input '{"team_name":…,"from":"<me>","to":"leader","body":"…"}' --json
+omp team api send-message --input '{"team_name":…,"from":"<me>","to":"<teammate>","body":"…"}' --json
+omp team api mailbox-list   --input '{"team_name":…,"worker":"<me>"}' --json
+```
+
+State that the recipient is auto-nudged, and that unknown names return `unknown_recipient`.
+
+### 3.5 Tests (Vitest, file-based, no MCP)
+
+`test/team/mailbox.test.ts` + `test/team/api.messaging.test.ts`:
+worker→leader, worker→peer, broadcast-excludes-sender, mailbox-list/mark-delivered,
+unknown-recipient rejection, cursor advance. A nudge unit test mocks `tmux`/`sendToWorker`
+to assert the recipient pane is poked.
+
+## 4. Feature B — nudge gating
+
+Change `monitorTeam` so nudge is **off by default**, but **ON for `/team`
+orchestration runs and active ralph/loop modes**:
+
+- Default `opts.nudge?.enabled` to **`false`** (flip current `!== false`).
+- Add `resolveNudgeEnabled(opts, cwd)` → `true` when ANY of:
+  1. `opts.nudge?.enabled === true` — set by the **`/team` command's monitor loop**
+     (the orchestration spawn+monitor path in `cli.ts` passes `nudge:{enabled:true}`).
+     This is what makes nudge ON for `/team`.
+  2. A loop-mode state file is active: `readRalph(cwd)?.active`, or the equivalent
+     `ultrawork`/`ultraqa` state (modes live at `.omp/state/<mode>.json`,
+     `src/mode-state/paths.ts`).
+  3. Falls back to `false` otherwise.
+- Add a small `isLoopModeActive(cwd)` helper in `mode-state` (reads the three mode
+  files) so condition 2 is one source of truth.
+
+Result:
+- **`/team` orchestration** → nudge ON (condition 1).
+- **ralph / ultrawork / ultraqa loops** → nudge ON (condition 2).
+- **Read-only `team status` / library one-shot use** → nudge OFF (no `enabled:true`,
+  no active loop mode).
+
+### Tests
+
+`test/team/runtime.test.ts` additions: nudge off by default; ON when `enabled:true`
+(the `/team` path); ON when a ralph/loop mode state is active; OFF when neither signal
+is present (e.g. `team status` polling).
+
+## 5. Build sequence
+
+1. `mailbox.ts` + tests (red→green).
+2. `api.ts` messaging fns + `cli.ts` wiring + tests.
+3. `worker-bootstrap.ts` overlay docs + test.
+4. Nudge gating in `runtime.ts` + `mode-state` helper + tests.
+5. Update `.github/skills/team/SKILL.md` to document messaging + nudge gating.
+
+## 6. Out of scope (YAGNI)
+
+- No dispatch-queue/retry state machine (the richer oh-my-claudecode design) — pull-based
+  mailbox + best-effort nudge is enough here.
+- No leader registered as a team member; `leader` stays a reserved mailbox name.
+- No cross-team messaging.
+
+## 7. Resolved decisions
+
+- **Broadcast reaches workers AND the lead** (every worker except sender + the `leader`
+  mailbox). Extends oh-my-claudecode's workers-only `teamBroadcast`.
+- **Nudge throttling reuses existing mechanisms** (idle `NudgeTracker` scan/maxCount +
+  an unread-count in the send trigger, mirroring `generateMailboxTriggerMessage`).
+  No new debounce/coalesce layer.
+- **Nudge gating:** off by default; ON for `/team` orchestration runs and active
+  ralph/ultrawork/ultraqa loop modes.

package/docs/self-evolve.md

@@ -2,7 +2,7 @@
 
 A two-file mechanism that turns repeated user corrections into draft project skills.
 
-- `AGENTS.md` instructs the agent to invoke `/self-evolve` before ending a session.
+- `.github/copilot-instructions.md` ships with the plugin and instructs the agent to invoke `/self-evolve` before ending a session — so the trigger fires in every project where the plugin is active, not only inside this repo.
 - `.github/skills/self-evolve/SKILL.md` is the loop itself: log corrections to `.oh-my-copilot/self-evolve/log.md`, count repeats per topic, and when a topic recurs three times draft `.oh-my-copilot/self-evolve/drafts/<slug>/SKILL.md` with `status: draft`.
 
 ## Why drafts live outside `.github/skills/`
@@ -19,4 +19,4 @@ Move the draft directory from `.oh-my-copilot/self-evolve/drafts/<slug>/` to `.g
 
 ## Why agent-driven, not a CLI
 
-Copilot CLI exposes no user-installable hook surface. The cheapest reliable trigger is the agent itself: `AGENTS.md` is loaded into every session, and the instruction there ensures `/self-evolve` runs at wrap-up without any binary, dependency, or shell modification.
+Copilot CLI exposes no user-installable hook surface. The cheapest reliable trigger is the agent itself: `.github/copilot-instructions.md` is loaded into every session where the plugin is active, and the instruction there ensures `/self-evolve` runs at wrap-up without any binary, dependency, or shell modification.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damian87/omp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "GitHub Copilot project skills catalog and Jira handoff tools.",
   "type": "module",
   "publishConfig": {

package/scripts/lib/version-check.mjs

@@ -0,0 +1,82 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 2000;
+const PACKAGE_NAME = "@damian87/omp";
+
+export function isNewer(latest, current) {
+  if (!latest || !current) return false;
+  const [a = 0, b = 0, c = 0] = String(latest).split(".").map((n) => Number.parseInt(n, 10));
+  const [x = 0, y = 0, z = 0] = String(current).split(".").map((n) => Number.parseInt(n, 10));
+  if ([a, b, c, x, y, z].some(Number.isNaN)) return false;
+  if (a !== x) return a > x;
+  if (b !== y) return b > y;
+  return c > z;
+}
+
+export function formatUpdateNotice(current, latest) {
+  return `[OMP UPDATE AVAILABLE]\n\nA new version of ${PACKAGE_NAME} is available: v${latest} (current: v${current})\nTo update, run: npm i -g ${PACKAGE_NAME}@latest`;
+}
+
+export function readCurrentVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(here, "..", "..", "package.json");
+    return JSON.parse(readFileSync(pkgPath, "utf8")).version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+async function fetchLatestVersion() {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: controller.signal,
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data?.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export async function checkForUpdate({ stateDir, now = Date.now(), fetchLatest = fetchLatestVersion } = {}) {
+  const current = readCurrentVersion();
+  if (!current || !stateDir) return null;
+
+  const cachePath = join(stateDir, "version-check.json");
+  let latest = null;
+
+  if (existsSync(cachePath)) {
+    try {
+      const cache = JSON.parse(readFileSync(cachePath, "utf8"));
+      if (cache?.checkedAt && now - cache.checkedAt < CACHE_TTL_MS && typeof cache.latest === "string") {
+        latest = cache.latest;
+      }
+    } catch {
+      // ignore corrupt cache
+    }
+  }
+
+  if (!latest) {
+    latest = await fetchLatest();
+    if (latest) {
+      try {
+        mkdirSync(stateDir, { recursive: true });
+        writeFileSync(cachePath, JSON.stringify({ checkedAt: now, latest }));
+      } catch {
+        // best-effort cache write
+      }
+    }
+  }
+
+  if (!latest || !isNewer(latest, current)) return null;
+  return { current, latest };
+}

package/scripts/session-start.mjs

@@ -2,6 +2,7 @@
 import { appendFileSync, mkdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { readStdin } from "./lib/stdin.mjs";
+import { checkForUpdate, formatUpdateNotice } from "./lib/version-check.mjs";
 
 const HOOK_NAME = "SessionStart";
 
@@ -11,7 +12,8 @@ const HOOK_NAME = "SessionStart";
     const data = raw ? JSON.parse(raw) : {};
     const sessionId = data.sessionId ?? data.session_id ?? "unknown";
     const directory = data.directory ?? process.cwd();
-    const logFile = join(directory, ".omp", "state", "hooks.log");
+    const stateDir = join(directory, ".omp", "state");
+    const logFile = join(stateDir, "hooks.log");
     mkdirSync(dirname(logFile), { recursive: true });
     const line = JSON.stringify({
       ts: new Date().toISOString(),
@@ -20,10 +22,14 @@ const HOOK_NAME = "SessionStart";
       directory,
     });
     appendFileSync(logFile, `${line}\n`);
+
+    const update = await checkForUpdate({ stateDir });
+    const additionalContext = update ? formatUpdateNotice(update.current, update.latest) : "";
+
     console.log(
       JSON.stringify({
         continue: true,
-        hookSpecificOutput: { hookEventName: HOOK_NAME, additionalContext: "" },
+        hookSpecificOutput: { hookEventName: HOOK_NAME, additionalContext },
       }),
     );
   } catch (err) {

package/.github/skills/codebase-research/SKILL.md

@@ -1,20 +0,0 @@
----
-name: codebase-research
-description: Read the repo first, map evidence, and return the smallest useful implementation context. Use with /codebase-research before planning or asking when repo facts matter.
----
-
-# Codebase Research
-
-Use `/codebase-research` before planning or asking when repo facts matter.
-
-Do:
-- Find relevant files, symbols, tests, docs, and existing patterns.
-- Separate evidence from inference.
-- Name the likely change surface and risks.
-- Ask nothing if the repo can answer it.
-
-Output:
-- `Evidence` — file paths and facts.
-- `Likely path` — what should change.
-- `Unknowns` — blockers only.
-- `Next skill` — usually `/grill-me`, `/ralplan`, `/debug`, or `/tdd`.