@laurentenhoor/devclaw 0.1.0

package/dist/lib/tiers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Developer level definitions and model resolution.
+ *
+ * Level names are plain: "junior", "senior", "reviewer", etc.
+ * Role context (dev/qa) is always provided by the caller or parent structure.
+ */
+export declare const DEV_LEVELS: readonly ["junior", "medior", "senior"];
+export declare const QA_LEVELS: readonly ["reviewer", "tester"];
+export type DevLevel = (typeof DEV_LEVELS)[number];
+export type QaLevel = (typeof QA_LEVELS)[number];
+export type Level = DevLevel | QaLevel;
+/** Default models, nested by role. */
+export declare const DEFAULT_MODELS: {
+    dev: {
+        junior: string;
+        medior: string;
+        senior: string;
+    };
+    qa: {
+        reviewer: string;
+        tester: string;
+    };
+};
+/** Emoji used in announcements, nested by role. */
+export declare const LEVEL_EMOJI: {
+    dev: {
+        junior: string;
+        medior: string;
+        senior: string;
+    };
+    qa: {
+        reviewer: string;
+        tester: string;
+    };
+};
+/** Check if a level belongs to the dev role. */
+export declare function isDevLevel(value: string): value is DevLevel;
+/** Check if a level belongs to the qa role. */
+export declare function isQaLevel(value: string): value is QaLevel;
+/** Determine the role a level belongs to. */
+export declare function levelRole(level: string): "dev" | "qa" | undefined;
+/** Get the default model for a role + level. */
+export declare function defaultModel(role: "dev" | "qa", level: string): string | undefined;
+/** Get the emoji for a role + level. */
+export declare function levelEmoji(role: "dev" | "qa", level: string): string | undefined;
+/**
+ * Resolve a level to a full model ID.
+ *
+ * Resolution order:
+ * 1. Plugin config `models.<role>.<level>`
+ * 2. DEFAULT_MODELS[role][level]
+ * 3. Passthrough (treat as raw model ID)
+ */
+export declare function resolveModel(role: "dev" | "qa", level: string, pluginConfig?: Record<string, unknown>): string;
+//# sourceMappingURL=tiers.d.ts.map

package/dist/lib/tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../lib/tiers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,UAAU,yCAA0C,CAAC;AAClE,eAAO,MAAM,SAAS,iCAAkC,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvC,sCAAsC;AACtC,eAAO,MAAM,cAAc;;;;;;;;;;CAU1B,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,WAAW;;;;;;;;;;CAUvB,CAAC;AAEF,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAEzD;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAIjE;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElF;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,KAAK,GAAG,IAAI,EAClB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CASR"}

package/dist/lib/tiers.js

@@ -0,0 +1,74 @@
+/**
+ * Developer level definitions and model resolution.
+ *
+ * Level names are plain: "junior", "senior", "reviewer", etc.
+ * Role context (dev/qa) is always provided by the caller or parent structure.
+ */
+export const DEV_LEVELS = ["junior", "medior", "senior"];
+export const QA_LEVELS = ["reviewer", "tester"];
+/** Default models, nested by role. */
+export const DEFAULT_MODELS = {
+    dev: {
+        junior: "anthropic/claude-haiku-4-5",
+        medior: "anthropic/claude-sonnet-4-5",
+        senior: "anthropic/claude-opus-4-5",
+    },
+    qa: {
+        reviewer: "anthropic/claude-sonnet-4-5",
+        tester: "anthropic/claude-haiku-4-5",
+    },
+};
+/** Emoji used in announcements, nested by role. */
+export const LEVEL_EMOJI = {
+    dev: {
+        junior: "⚡",
+        medior: "🔧",
+        senior: "🧠",
+    },
+    qa: {
+        reviewer: "🔍",
+        tester: "👀",
+    },
+};
+/** Check if a level belongs to the dev role. */
+export function isDevLevel(value) {
+    return DEV_LEVELS.includes(value);
+}
+/** Check if a level belongs to the qa role. */
+export function isQaLevel(value) {
+    return QA_LEVELS.includes(value);
+}
+/** Determine the role a level belongs to. */
+export function levelRole(level) {
+    if (isDevLevel(level))
+        return "dev";
+    if (isQaLevel(level))
+        return "qa";
+    return undefined;
+}
+/** Get the default model for a role + level. */
+export function defaultModel(role, level) {
+    return DEFAULT_MODELS[role][level];
+}
+/** Get the emoji for a role + level. */
+export function levelEmoji(role, level) {
+    return LEVEL_EMOJI[role][level];
+}
+/**
+ * Resolve a level to a full model ID.
+ *
+ * Resolution order:
+ * 1. Plugin config `models.<role>.<level>`
+ * 2. DEFAULT_MODELS[role][level]
+ * 3. Passthrough (treat as raw model ID)
+ */
+export function resolveModel(role, level, pluginConfig) {
+    const models = pluginConfig?.models;
+    if (models && typeof models === "object") {
+        const roleModels = models[role];
+        if (roleModels?.[level])
+            return roleModels[level];
+    }
+    return defaultModel(role, level) ?? level;
+}
+//# sourceMappingURL=tiers.js.map

package/dist/lib/tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../lib/tiers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAU,CAAC;AAMzD,sCAAsC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE;QACH,MAAM,EAAE,4BAA4B;QACpC,MAAM,EAAE,6BAA6B;QACrC,MAAM,EAAE,2BAA2B;KACpC;IACD,EAAE,EAAE;QACF,QAAQ,EAAE,6BAA6B;QACvC,MAAM,EAAE,4BAA4B;KACrC;CACF,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,EAAE;QACH,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;KACb;IACD,EAAE,EAAE;QACF,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAQ,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAQ,SAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,IAAkB,EAAE,KAAa;IAC5D,OAAQ,cAAc,CAAC,IAAI,CAA4B,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,KAAa;IAC1D,OAAQ,WAAW,CAAC,IAAI,CAA4B,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAkB,EAClB,KAAa,EACb,YAAsC;IAEtC,MAAM,MAAM,GAAI,YAAqD,EAAE,MAAM,CAAC;IAE9E,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAuC,CAAC;QACtE,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC;AAC5C,CAAC"}

package/dist/lib/tool-helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * tool-helpers.ts — Shared resolution helpers for tool execute() functions.
+ *
+ * Eliminates repeated boilerplate across tools: workspace validation,
+ * project resolution, provider creation.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { ToolContext } from "./types.js";
+import { type Project, type ProjectsData } from "./projects.js";
+import { type ProviderWithType } from "./providers/index.js";
+import { type TickAction } from "./services/tick.js";
+/**
+ * Require workspaceDir from context or throw a clear error.
+ */
+export declare function requireWorkspaceDir(ctx: ToolContext): string;
+/**
+ * Resolve project by groupId, throw if not found.
+ */
+export declare function resolveProject(workspaceDir: string, groupId: string): Promise<{
+    data: ProjectsData;
+    project: Project;
+}>;
+/**
+ * Create an issue provider for a project.
+ */
+export declare function resolveProvider(project: Project): ProviderWithType;
+/**
+ * Get plugin config as a typed record (or undefined).
+ */
+export declare function getPluginConfig(api: OpenClawPluginApi): Record<string, unknown> | undefined;
+/**
+ * Run projectTick (non-fatal) and send workerStart notifications for any pickups.
+ * Returns the pickups array (empty on failure).
+ */
+export declare function tickAndNotify(opts: {
+    workspaceDir: string;
+    groupId: string;
+    agentId?: string;
+    pluginConfig?: Record<string, unknown>;
+    sessionKey?: string;
+    targetRole?: "dev" | "qa";
+    channel?: string;
+}): Promise<TickAction[]>;
+//# sourceMappingURL=tool-helpers.d.ts.map

package/dist/lib/tool-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../lib/tool-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAA4B,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGlE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAK5D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAOnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE3F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBxB"}

package/dist/lib/tool-helpers.js

@@ -0,0 +1,65 @@
+import { readProjects, getProject } from "./projects.js";
+import { createProvider } from "./providers/index.js";
+import { projectTick } from "./services/tick.js";
+import { notifyTickPickups, getNotificationConfig } from "./notify.js";
+/**
+ * Require workspaceDir from context or throw a clear error.
+ */
+export function requireWorkspaceDir(ctx) {
+    if (!ctx.workspaceDir) {
+        throw new Error("No workspace directory available in tool context");
+    }
+    return ctx.workspaceDir;
+}
+/**
+ * Resolve project by groupId, throw if not found.
+ */
+export async function resolveProject(workspaceDir, groupId) {
+    const data = await readProjects(workspaceDir);
+    const project = getProject(data, groupId);
+    if (!project) {
+        throw new Error(`Project not found for groupId ${groupId}. Run project_register first.`);
+    }
+    return { data, project };
+}
+/**
+ * Create an issue provider for a project.
+ */
+export function resolveProvider(project) {
+    return createProvider({ repo: project.repo });
+}
+/**
+ * Get plugin config as a typed record (or undefined).
+ */
+export function getPluginConfig(api) {
+    return api.pluginConfig;
+}
+/**
+ * Run projectTick (non-fatal) and send workerStart notifications for any pickups.
+ * Returns the pickups array (empty on failure).
+ */
+export async function tickAndNotify(opts) {
+    let pickups = [];
+    try {
+        const result = await projectTick({
+            workspaceDir: opts.workspaceDir,
+            groupId: opts.groupId,
+            agentId: opts.agentId,
+            pluginConfig: opts.pluginConfig,
+            sessionKey: opts.sessionKey,
+            targetRole: opts.targetRole,
+        });
+        pickups = result.pickups;
+    }
+    catch { /* non-fatal: tick failure shouldn't break the caller */ }
+    if (pickups.length) {
+        const notifyConfig = getNotificationConfig(opts.pluginConfig);
+        await notifyTickPickups(pickups, {
+            workspaceDir: opts.workspaceDir,
+            config: notifyConfig,
+            channel: opts.channel,
+        });
+    }
+    return pickups;
+}
+//# sourceMappingURL=tool-helpers.js.map

package/dist/lib/tool-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.js","sourceRoot":"","sources":["../../lib/tool-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAmC,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAyB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAClD,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC,YAAY,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,OAAe;IAEf,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,+BAA+B,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,OAAO,GAAG,CAAC,YAAmD,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAQnC;IACC,IAAI,OAAO,GAAiB,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC,CAAC,wDAAwD,CAAC,CAAC;IAEpE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9D,MAAM,iBAAiB,CAAC,OAAO,EAAE;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/tools/health.d.ts

@@ -0,0 +1,28 @@
+import type { ToolContext } from "../types.js";
+export declare function createHealthTool(): (ctx: ToolContext) => {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            projectGroupId: {
+                type: string;
+                description: string;
+            };
+            fix: {
+                type: string;
+                description: string;
+            };
+            activeSessions: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+    };
+    execute(_id: string, params: Record<string, unknown>): Promise<import("@mariozechner/pi-agent-core").AgentToolResult<unknown>>;
+};
+//# sourceMappingURL=health.d.ts.map

package/dist/lib/tools/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../lib/tools/health.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,wBAAgB,gBAAgB,KACtB,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;iBAaH,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA0C7D"}

package/dist/lib/tools/health.js

@@ -0,0 +1,61 @@
+/**
+ * health — Worker health scan with optional auto-fix.
+ *
+ * Read-only by default (surfaces issues). Pass fix=true to apply fixes.
+ */
+import { jsonResult } from "openclaw/plugin-sdk";
+import { readProjects, getProject } from "../projects.js";
+import { log as auditLog } from "../audit.js";
+import { checkWorkerHealth } from "../services/health.js";
+import { requireWorkspaceDir, resolveProvider } from "../tool-helpers.js";
+export function createHealthTool() {
+    return (ctx) => ({
+        name: "health",
+        label: "Health",
+        description: `Scan worker health across projects. Detects zombies, stale workers, orphaned state. Pass fix=true to auto-fix. Context-aware: auto-filters in group chats.`,
+        parameters: {
+            type: "object",
+            properties: {
+                projectGroupId: { type: "string", description: "Filter to specific project. Omit for all." },
+                fix: { type: "boolean", description: "Apply fixes for detected issues. Default: false (read-only)." },
+                activeSessions: { type: "array", items: { type: "string" }, description: "Active session IDs for zombie detection." },
+            },
+        },
+        async execute(_id, params) {
+            const workspaceDir = requireWorkspaceDir(ctx);
+            const fix = params.fix ?? false;
+            const activeSessions = params.activeSessions ?? [];
+            const groupId = params.projectGroupId;
+            const data = await readProjects(workspaceDir);
+            const projectIds = groupId ? [groupId] : Object.keys(data.projects);
+            const issues = [];
+            for (const pid of projectIds) {
+                const project = getProject(data, pid);
+                if (!project)
+                    continue;
+                const { provider } = resolveProvider(project);
+                for (const role of ["dev", "qa"]) {
+                    const fixes = await checkWorkerHealth({
+                        workspaceDir, groupId: pid, project, role, activeSessions,
+                        autoFix: fix, provider,
+                    });
+                    issues.push(...fixes.map((f) => ({ ...f, project: project.name, role })));
+                }
+            }
+            await auditLog(workspaceDir, "health", {
+                projectCount: projectIds.length,
+                fix,
+                issuesFound: issues.length,
+                issuesFixed: issues.filter((i) => i.fixed).length,
+            });
+            return jsonResult({
+                success: true,
+                fix,
+                projectsScanned: projectIds.length,
+                issues,
+                note: activeSessions.length === 0 ? "No activeSessions provided — zombie detection skipped." : undefined,
+            });
+        },
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/lib/tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../lib/tools/health.ts"],"names":[],"mappings":"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"}

package/dist/lib/tools/onboard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * onboard — Conversational DevClaw onboarding.
+ *
+ * Returns step-by-step guidance. Call this before setup.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { ToolContext } from "../types.js";
+export declare function createOnboardTool(api: OpenClawPluginApi): (ctx: ToolContext) => {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+    };
+    execute(_id: string, params: Record<string, unknown>): Promise<import("@mariozechner/pi-agent-core").AgentToolResult<unknown>>;
+};
+//# sourceMappingURL=onboard.d.ts.map

package/dist/lib/tools/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../../lib/tools/onboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,IAC9C,KAAK,WAAW;;;;;;;;;;;;;;iBAWH,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAc7D"}

package/dist/lib/tools/onboard.js

@@ -0,0 +1,27 @@
+import { jsonResult } from "openclaw/plugin-sdk";
+import { isPluginConfigured, hasWorkspaceFiles, buildOnboardToolContext, buildReconfigContext } from "../onboarding.js";
+export function createOnboardTool(api) {
+    return (ctx) => ({
+        name: "onboard",
+        label: "Onboard",
+        description: "Start DevClaw onboarding workflow. Returns step-by-step QA-style guidance. Call this first, then setup with collected answers.",
+        parameters: {
+            type: "object",
+            properties: {
+                mode: { type: "string", enum: ["first-run", "reconfigure"], description: "Auto-detected if omitted." },
+            },
+        },
+        async execute(_id, params) {
+            const configured = isPluginConfigured(api.pluginConfig);
+            const hasWorkspace = await hasWorkspaceFiles(ctx.workspaceDir);
+            const mode = params.mode ? params.mode
+                : configured && hasWorkspace ? "reconfigure" : "first-run";
+            const instructions = mode === "first-run" ? buildOnboardToolContext() : buildReconfigContext(api.pluginConfig);
+            return jsonResult({
+                success: true, mode, configured, instructions,
+                nextSteps: ["Follow instructions above", "Call setup with collected answers", mode === "first-run" ? "Register a project afterward" : null].filter(Boolean),
+            });
+        },
+    });
+}
+//# sourceMappingURL=onboard.js.map

package/dist/lib/tools/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../../lib/tools/onboard.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExH,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,OAAO,CAAC,GAAgB,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,gIAAgI;QAC7I,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE;aACvG;SACF;QAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAA+B;YACxD,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,YAAuC,CAAC,CAAC;YACnF,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,MAAM,CAAC,IAAoC;gBACrE,CAAC,CAAC,UAAU,IAAI,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;YAE7D,MAAM,YAAY,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAuC,CAAC,CAAC;YAE1I,OAAO,UAAU,CAAC;gBAChB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY;gBAC7C,SAAS,EAAE,CAAC,2BAA2B,EAAE,mCAAmC,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;aAC5J,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/tools/project-register.d.ts

@@ -0,0 +1,51 @@
+import type { ToolContext } from "../types.js";
+export declare function createProjectRegisterTool(): (ctx: ToolContext) => {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        type: string;
+        required: string[];
+        properties: {
+            projectGroupId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            channel: {
+                type: string;
+                description: string;
+            };
+            groupName: {
+                type: string;
+                description: string;
+            };
+            baseBranch: {
+                type: string;
+                description: string;
+            };
+            deployBranch: {
+                type: string;
+                description: string;
+            };
+            deployUrl: {
+                type: string;
+                description: string;
+            };
+            roleExecution: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+    };
+    execute(_id: string, params: Record<string, unknown>): Promise<import("@mariozechner/pi-agent-core").AgentToolResult<unknown>>;
+};
+//# sourceMappingURL=project-register.d.ts.map

package/dist/lib/tools/project-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-register.d.ts","sourceRoot":"","sources":["../../../lib/tools/project-register.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAuC/C,wBAAgB,yBAAyB,KAC/B,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDH,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA+F7D"}

package/dist/lib/tools/project-register.js

@@ -0,0 +1,172 @@
+/**
+ * project_register — Register a new project with DevClaw.
+ *
+ * Atomically: validates repo, detects GitHub/GitLab provider, creates all 8 state labels (idempotent),
+ * adds project entry to projects.json, and logs the event.
+ *
+ * Replaces the manual steps of running glab/gh label create + editing projects.json.
+ */
+import { jsonResult } from "openclaw/plugin-sdk";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { readProjects, writeProjects, emptyWorkerState } from "../projects.js";
+import { resolveRepoPath } from "../projects.js";
+import { createProvider } from "../providers/index.js";
+import { log as auditLog } from "../audit.js";
+import { DEV_LEVELS, QA_LEVELS } from "../tiers.js";
+import { DEFAULT_DEV_INSTRUCTIONS, DEFAULT_QA_INSTRUCTIONS } from "../templates.js";
+/**
+ * Scaffold project-specific prompt files.
+ * Returns true if files were created, false if they already existed.
+ */
+async function scaffoldPromptFiles(workspaceDir, projectName) {
+    const projectDir = path.join(workspaceDir, "projects", "roles", projectName);
+    await fs.mkdir(projectDir, { recursive: true });
+    const projectDev = path.join(projectDir, "dev.md");
+    const projectQa = path.join(projectDir, "qa.md");
+    let created = false;
+    try {
+        await fs.access(projectDev);
+    }
+    catch {
+        await fs.writeFile(projectDev, DEFAULT_DEV_INSTRUCTIONS, "utf-8");
+        created = true;
+    }
+    try {
+        await fs.access(projectQa);
+    }
+    catch {
+        await fs.writeFile(projectQa, DEFAULT_QA_INSTRUCTIONS, "utf-8");
+        created = true;
+    }
+    return created;
+}
+export function createProjectRegisterTool() {
+    return (ctx) => ({
+        name: "project_register",
+        label: "Project Register",
+        description: `Register a new project with DevClaw. Creates state labels, adds to projects.json. One-time setup per project.`,
+        parameters: {
+            type: "object",
+            required: ["projectGroupId", "name", "repo", "baseBranch"],
+            properties: {
+                projectGroupId: {
+                    type: "string",
+                    description: "Project group ID (e.g. Telegram/WhatsApp group ID)",
+                },
+                name: {
+                    type: "string",
+                    description: "Short project name (e.g. 'my-webapp')",
+                },
+                repo: {
+                    type: "string",
+                    description: "Path to git repo (e.g. '~/git/my-project')",
+                },
+                channel: {
+                    type: "string",
+                    description: "Channel type (e.g. 'telegram', 'whatsapp'). Defaults to 'telegram'.",
+                },
+                groupName: {
+                    type: "string",
+                    description: "Group display name (optional - defaults to 'Project: {name}')",
+                },
+                baseBranch: {
+                    type: "string",
+                    description: "Base branch for development (e.g. 'development', 'main')",
+                },
+                deployBranch: {
+                    type: "string",
+                    description: "Branch that triggers deployment. Defaults to baseBranch.",
+                },
+                deployUrl: {
+                    type: "string",
+                    description: "Deployment URL for the project",
+                },
+                roleExecution: {
+                    type: "string",
+                    enum: ["parallel", "sequential"],
+                    description: "Project-level role execution mode: parallel (DEV and QA can work simultaneously) or sequential (only one role active at a time). Defaults to parallel.",
+                },
+            },
+        },
+        async execute(_id, params) {
+            const groupId = params.projectGroupId;
+            const name = params.name;
+            const repo = params.repo;
+            const channel = params.channel ?? "telegram";
+            const groupName = params.groupName ?? `Project: ${name}`;
+            const baseBranch = params.baseBranch;
+            const deployBranch = params.deployBranch ?? baseBranch;
+            const deployUrl = params.deployUrl ?? "";
+            const roleExecution = params.roleExecution ?? "parallel";
+            const workspaceDir = ctx.workspaceDir;
+            if (!workspaceDir) {
+                throw new Error("No workspace directory available in tool context");
+            }
+            // 1. Check project not already registered (allow re-register if incomplete)
+            const data = await readProjects(workspaceDir);
+            const existing = data.projects[groupId];
+            if (existing && existing.dev?.sessions && Object.keys(existing.dev.sessions).length > 0) {
+                throw new Error(`Project already registered for this group: "${existing.name}". Remove the existing entry first or use a different group.`);
+            }
+            // 2. Resolve repo path
+            const repoPath = resolveRepoPath(repo);
+            // 3. Create provider and verify it works
+            const { provider, type: providerType } = createProvider({ repo });
+            const healthy = await provider.healthCheck();
+            if (!healthy) {
+                const cliName = providerType === "github" ? "gh" : "glab";
+                const cliInstallUrl = providerType === "github"
+                    ? "https://cli.github.com"
+                    : "https://gitlab.com/gitlab-org/cli";
+                throw new Error(`${providerType.toUpperCase()} health check failed for ${repoPath}. ` +
+                    `Detected provider: ${providerType}. ` +
+                    `Ensure '${cliName}' CLI is installed, authenticated (${cliName} auth status), ` +
+                    `and the repo has a ${providerType.toUpperCase()} remote. ` +
+                    `Install ${cliName} from: ${cliInstallUrl}`);
+            }
+            // 4. Create all 8 state labels (idempotent)
+            await provider.ensureAllStateLabels();
+            // 5. Add project to projects.json
+            data.projects[groupId] = {
+                name,
+                repo,
+                groupName,
+                deployUrl,
+                baseBranch,
+                deployBranch,
+                channel,
+                roleExecution,
+                dev: emptyWorkerState([...DEV_LEVELS]),
+                qa: emptyWorkerState([...QA_LEVELS]),
+            };
+            await writeProjects(workspaceDir, data);
+            // 6. Scaffold prompt files
+            const promptsCreated = await scaffoldPromptFiles(workspaceDir, name);
+            // 7. Audit log
+            await auditLog(workspaceDir, "project_register", {
+                project: name,
+                groupId,
+                repo,
+                baseBranch,
+                deployBranch,
+                deployUrl: deployUrl || null,
+            });
+            // 8. Return announcement
+            const promptsNote = promptsCreated ? " Prompt files scaffolded." : "";
+            const announcement = `Project "${name}" registered for group ${groupName}. Labels created.${promptsNote} Ready for tasks.`;
+            return jsonResult({
+                success: true,
+                project: name,
+                groupId,
+                repo,
+                baseBranch,
+                deployBranch,
+                labelsCreated: 8,
+                promptsScaffolded: promptsCreated,
+                announcement,
+            });
+        },
+    });
+}
+//# sourceMappingURL=project-register.js.map