@useorgx/openclaw-plugin 0.4.8 → 0.7.0

package/dist/agent-suite.js

@@ -3,6 +3,7 @@ import { existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { writeFileAtomicSync } from "./fs-utils.js";
+import { parseJsonSafe } from "./json-utils.js";
 import { getOpenClawDir } from "./paths.js";
 export const ORGX_AGENT_SUITE_PACK_ID = "orgx-agent-suite";
 export const ORGX_AGENT_SUITE_AGENTS = [
@@ -29,14 +30,6 @@ const SUITE_FILES = [
 function isRecord(value) {
     return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function parseJsonSafe(raw) {
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
 function isSafeAgentId(value) {
     const trimmed = value.trim();
     if (!trimmed)
@@ -116,6 +109,19 @@ function loadTextFile(path) {
 function normalizeNewlines(value) {
     return value.replace(/\r\n/g, "\n");
 }
+function readFileMtimeMs(path) {
+    try {
+        if (!existsSync(path))
+            return null;
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+function roundRate(value) {
+    return Number(value.toFixed(3));
+}
 function domainPersona(domain) {
     switch (domain) {
         case "engineering":
@@ -124,7 +130,12 @@ function domainPersona(domain) {
                 voice: ["Direct, calm, technical.", "Prefer concrete evidence over confidence."],
                 autonomy: ["Default to implementing the fix.", "Escalate only when a decision is truly required."],
                 care: ["Respect time: minimize churn and surprises.", "Explain tradeoffs without lecturing."],
-                defaults: ["Reproduce before fixing.", "Add tests when feasible.", "Keep diffs small."],
+                defaults: [
+                    "Reproduce before fixing.",
+                    "Add tests when feasible.",
+                    "Keep diffs small.",
+                    "Register artifacts as engineering.commit with commit_sha and verification signals.",
+                ],
             };
         case "product":
             return {
@@ -132,7 +143,12 @@ function domainPersona(domain) {
                 voice: ["Clear, structured, user-centered.", "Make decisions explicit; avoid fuzzy scope."],
                 autonomy: ["Propose a smallest viable slice.", "Write acceptance criteria before building."],
                 care: ["Call out risks and non-goals early.", "Optimize for the user's confidence and clarity."],
-                defaults: ["Define success metrics.", "Document assumptions.", "Keep language concrete."],
+                defaults: [
+                    "Define success metrics.",
+                    "Document assumptions.",
+                    "Keep language concrete.",
+                    "Register artifacts as product.spec with acceptance_criteria and success_metric.",
+                ],
             };
         case "design":
             return {
@@ -140,7 +156,12 @@ function domainPersona(domain) {
                 voice: ["Precise, opinionated, kind.", "Avoid generic UI patterns and 'AI slop'."],
                 autonomy: ["Iterate fast with constraints.", "Verify mobile + critical states."],
                 care: ["Protect coherence of the design system.", "Prioritize accessibility as a baseline."],
-                defaults: ["Use tokens.", "Avoid new visual language.", "Capture QA evidence."],
+                defaults: [
+                    "Use tokens.",
+                    "Avoid new visual language.",
+                    "Capture QA evidence.",
+                    "Register artifacts as design.component with evidence_url and tokens_referenced.",
+                ],
             };
         case "marketing":
             return {
@@ -148,7 +169,11 @@ function domainPersona(domain) {
                 voice: ["Specific, energetic, grounded in reality.", "No generic claims without proof."],
                 autonomy: ["Pick a target audience and promise.", "Deliver channel-ready outputs."],
                 care: ["Avoid hype that creates trust debt.", "Respect brand voice; keep it crisp."],
-                defaults: ["Audience -> promise -> proof -> CTA.", "Include measurement hooks."],
+                defaults: [
+                    "Audience -> promise -> proof -> CTA.",
+                    "Include measurement hooks.",
+                    "Register artifacts as marketing.asset with audience, channel, and measurement_hook.",
+                ],
             };
         case "sales":
             return {
@@ -156,7 +181,11 @@ function domainPersona(domain) {
                 voice: ["Concise, empathetic, commercially sharp.", "Anticipate objections; answer plainly."],
                 autonomy: ["Start with ICP + disqualifiers.", "Write talk tracks that sound human."],
                 care: ["Never overclaim.", "Optimize for trust and next steps."],
-                defaults: ["MEDDIC-style qualification.", "Objection handling + CTA."],
+                defaults: [
+                    "MEDDIC-style qualification.",
+                    "Objection handling + CTA.",
+                    "Register artifacts as sales.qualification with buyer_stage and next_action.",
+                ],
             };
         case "operations":
             return {
@@ -164,7 +193,12 @@ function domainPersona(domain) {
                 voice: ["Cautious, thorough, pragmatic.", "Prefer runbooks over heroics."],
                 autonomy: ["Default to reversible changes.", "Add guardrails before speed."],
                 care: ["Assume production is fragile unless proven otherwise.", "Reduce on-call burden."],
-                defaults: ["Rollback paths.", "Detection + alerting.", "Post-incident learning."],
+                defaults: [
+                    "Rollback paths.",
+                    "Detection + alerting.",
+                    "Post-incident learning.",
+                    "Register artifacts as operations.runbook with rollback_path and affected_systems.",
+                ],
             };
         case "orchestration":
             return {
@@ -172,7 +206,12 @@ function domainPersona(domain) {
                 voice: ["Structured, decisive, transparent.", "Keep boundaries straight (OrgX vs OpenClaw vs plugin)."],
                 autonomy: ["Decompose into verifiable tasks.", "Sequence work to keep momentum."],
                 care: ["Minimize context switching.", "Keep stakeholders informed."],
-                defaults: ["One unverified item at a time.", "Reference the canonical plan.", "Update statuses with proof."],
+                defaults: [
+                    "One unverified item at a time.",
+                    "Reference the canonical plan.",
+                    "Update statuses with proof.",
+                    "Register artifacts as orchestration.routing with rationale and unblocked_work.",
+                ],
             };
         default:
             return {
@@ -225,6 +264,11 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                 ],
                 product: [
                     "orgx_status",
@@ -234,6 +278,11 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                 ],
                 design: [
                     "orgx_status",
@@ -243,6 +292,11 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                 ],
                 marketing: [
                     "orgx_status",
@@ -252,6 +306,11 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                 ],
                 sales: [
                     "orgx_status",
@@ -261,6 +320,11 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                 ],
                 operations: [
                     "orgx_status",
@@ -270,7 +334,13 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                     "orgx_apply_changeset",
+                    "orgx_reassign_stream",
                 ],
                 orchestration: [
                     "orgx_status",
@@ -280,7 +350,13 @@ function buildManagedFileContent(input) {
                     "orgx_register_artifact",
                     "orgx_request_decision",
                     "orgx_spawn_check",
+                    "orgx_quality_score",
+                    "orgx_proof_status",
+                    "orgx_record_outcome",
+                    "orgx_get_outcome_attribution",
+                    "orgx_verify_completion",
                     "orgx_apply_changeset",
+                    "orgx_reassign_stream",
                 ],
             };
             const scopeKey = `orgx-openclaw-${input.agent.domain}`;
@@ -295,6 +371,12 @@ function buildManagedFileContent(input) {
                 "- orgx_register_artifact",
                 "- orgx_request_decision",
                 "- orgx_spawn_check",
+                "- orgx_quality_score",
+                "- orgx_proof_status",
+                "- orgx_record_outcome",
+                "- orgx_get_outcome_attribution",
+                "- orgx_verify_completion",
+                "- orgx_reassign_stream",
                 "",
                 "## Scoped MCP (Recommended)",
                 `If your client supports MCP server selection, prefer the scoped server key: \`${scopeKey}\`.`,
@@ -306,6 +388,7 @@ function buildManagedFileContent(input) {
                 "Rules:",
                 "- Return structured JSON for tool outputs when applicable.",
                 "- Do not print secrets (API keys, tokens, cookies). Mask as `oxk_...abcd`.",
+                "- When calling `orgx_register_artifact`, self-assess and include `confidence_score` in [0,1].",
                 "- If a tool fails, capture the exact error and fix root cause.",
                 "- Prefer dry-run/previews when writing to user config.",
                 "",
@@ -400,6 +483,12 @@ function buildManagedFileContent(input) {
                 "- Avoid destructive git ops unless explicitly requested.",
                 "- Keep scope tight: do the asked work, then stop.",
                 "",
+                "## Team Awareness",
+                "- Your prompt may include a \"Team Activity\" section showing other agents' recent work.",
+                "- Reference team outputs naturally when relevant (\"Building on the auth endpoints\" not \"The Engineering agent completed...\").",
+                "- If your task connects to recent team work, mention the connection briefly.",
+                "- Do not duplicate work another agent has completed.",
+                "",
                 "## Provenance",
                 `- ${provenance}`,
                 "",
@@ -473,7 +562,7 @@ export function computeOrgxAgentSuitePlan(input) {
     const { path: cfgPath, parsed } = readOpenclawConfig(openclawDir);
     const suiteWorkspaceRoot = resolveSuiteWorkspaceRoot(parsed);
     const upsert = upsertSuiteAgentsIntoConfig({ openclaw: parsed, suiteWorkspaceRoot });
-    const agents = ORGX_AGENT_SUITE_AGENTS.map((agent) => {
+    const baseAgents = ORGX_AGENT_SUITE_AGENTS.map((agent) => {
         const workspace = join(suiteWorkspaceRoot, agent.id);
         const list = Array.isArray(parsed?.agents?.list) ? parsed?.agents?.list : [];
         const configured = list.some((entry) => String(entry?.id ?? "").trim() === agent.id);
@@ -485,7 +574,8 @@ export function computeOrgxAgentSuitePlan(input) {
         };
     });
     const workspaceFiles = [];
-    for (const agent of agents) {
+    const healthStats = new Map();
+    for (const agent of baseAgents) {
         for (const file of SUITE_FILES) {
             const managedPath = join(agent.workspace, SUITE_MANAGED_DIR, file);
             const localPath = join(agent.workspace, SUITE_LOCAL_DIR, file);
@@ -516,8 +606,51 @@ export function computeOrgxAgentSuitePlan(input) {
                 compositePath,
                 action,
             });
+            const stats = healthStats.get(agent.id) ?? {
+                totalChecks: 0,
+                passedChecks: 0,
+                failedChecks: 0,
+                lastChangedMs: null,
+            };
+            stats.totalChecks += 1;
+            if (action === "noop") {
+                stats.passedChecks += 1;
+            }
+            if (action === "conflict") {
+                stats.failedChecks += 1;
+            }
+            const changedMs = readFileMtimeMs(compositePath);
+            if (typeof changedMs === "number" && (stats.lastChangedMs == null || changedMs > stats.lastChangedMs)) {
+                stats.lastChangedMs = changedMs;
+            }
+            healthStats.set(agent.id, stats);
         }
     }
+    const agents = baseAgents.map((agent) => {
+        const stats = healthStats.get(agent.id) ?? {
+            totalChecks: 0,
+            passedChecks: 0,
+            failedChecks: 0,
+            lastChangedMs: null,
+        };
+        const status = stats.failedChecks > 0
+            ? "conflict"
+            : stats.totalChecks > 0 && stats.passedChecks === stats.totalChecks
+                ? "healthy"
+                : "needs_apply";
+        const evalPassRate = stats.totalChecks > 0 ? roundRate(stats.passedChecks / stats.totalChecks) : 0;
+        return {
+            ...agent,
+            configHealth: {
+                status,
+                lastChangedAt: stats.lastChangedMs == null ? null : new Date(stats.lastChangedMs).toISOString(),
+                evalPassRate,
+                totalChecks: stats.totalChecks,
+                passedChecks: stats.passedChecks,
+                failedChecks: stats.failedChecks,
+            },
+        };
+    });
     return {
         packId: ORGX_AGENT_SUITE_PACK_ID,
         packVersion,

package/dist/artifacts/artifact-domain-schemas.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Domain artifact metadata schemas for the OrgX Proof Ladder.
+ *
+ * Each domain has one or more canonical "atomic unit types" with required
+ * metadata fields. Validation is warn-only in phase 1 — artifacts that fail
+ * schema checks are still registered but tagged with `schema_validated: false`.
+ */
+import type { OrgxAgentDomain } from "../contracts/types.js";
+export declare const ATOMIC_UNIT_TYPES: readonly ["engineering.commit", "engineering.pr", "product.spec", "product.decision", "design.component", "design.a11y", "marketing.asset", "marketing.experiment", "sales.qualification", "sales.proposal", "operations.runbook", "operations.incident", "orchestration.routing", "orchestration.decomp"];
+export type AtomicUnitType = (typeof ATOMIC_UNIT_TYPES)[number];
+export interface QueueRef {
+    initiative_id?: string;
+    workstream_id?: string;
+    task_id?: string;
+    queue_snapshot?: Record<string, unknown>;
+}
+export interface RunRef {
+    run_id?: string;
+    correlation_id?: string;
+    session_id?: string;
+}
+export interface QualityGateRef {
+    passed: boolean;
+    score: number;
+    threshold: number;
+}
+interface FieldSpec {
+    /** Human-readable name */
+    label: string;
+    /** When true, warn if missing */
+    required: boolean;
+}
+type SchemaFields = Record<string, FieldSpec>;
+export interface DomainArtifactSchema {
+    atomicUnitType: AtomicUnitType;
+    domain: OrgxAgentDomain;
+    receiptName: string;
+    fields: SchemaFields;
+}
+export declare const DOMAIN_ARTIFACT_SCHEMAS: Record<AtomicUnitType, DomainArtifactSchema>;
+export declare const DOMAIN_DEFAULT_ATOMIC_TYPES: Record<OrgxAgentDomain, AtomicUnitType[]>;
+export declare const DOMAIN_QUALITY_THRESHOLDS: Record<OrgxAgentDomain, number>;
+export interface ArtifactValidationResult {
+    valid: boolean;
+    atomicUnitType: string;
+    missingRequired: string[];
+    missingOptional: string[];
+    warnings: string[];
+}
+/**
+ * Validate artifact metadata against its domain schema.
+ *
+ * Returns validation result with missing fields listed. In phase 1 this is
+ * advisory (warn-only); callers should not block artifact registration.
+ */
+export declare function validateArtifactMetadata(atomicUnitType: string, metadata: Record<string, unknown>): ArtifactValidationResult;
+/**
+ * Infer the canonical atomic unit type from a freeform artifact_type string.
+ *
+ * Maps existing artifact_type conventions (e.g. "eng.diff_pack",
+ * "shared.project_handbook") into one of the 14 canonical types.
+ * Returns null if no mapping is found — the artifact still registers
+ * but won't be schema-validated.
+ */
+export declare function normalizeArtifactType(artifactType: string): AtomicUnitType | null;
+export {};