@aiassesstech/sam 0.1.1 → 0.2.0

package/dist/tools/sam-request.js

@@ -0,0 +1,91 @@
+/**
+ * sam_request — Create, update, or close Engineering Requests
+ *
+ * Side effects: writes memory files (when MemoryWriter available),
+ * sends fleet-bus task/status (when fleet-bus available).
+ */
+export function createRequestTool(pipeline) {
+    return {
+        name: 'sam_request',
+        description: 'Create, update, or close Engineering Requests in the pipeline. ' +
+            'Create: requires description and requester. ' +
+            'Update: requires er_id and at least one of stage, blocker, or notes. ' +
+            'Close: requires er_id (marks as DELIVERED).',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['create', 'update', 'close'],
+                    description: 'Action: create a new ER, update an existing ER, or close (deliver) an ER',
+                },
+                er_id: {
+                    type: 'string',
+                    description: 'Engineering Request ID (required for update and close, e.g. ER-2026-001)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'What needs to be built (required for create)',
+                },
+                requester: {
+                    type: 'string',
+                    description: 'Who is requesting the work (required for create)',
+                },
+                stage: {
+                    type: 'string',
+                    enum: ['INTAKE', 'ANALYSIS', 'BUILD', 'SELF-REVIEW', 'ARCHIE-REVIEW', 'DELIVERED'],
+                    description: 'New pipeline stage (for update)',
+                },
+                blocker: {
+                    type: 'string',
+                    description: 'Set blocker reason (for update). Empty string to unblock.',
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Add a note to the ER timeline',
+                },
+            },
+            required: ['action'],
+        },
+        async execute(_toolCallId, params) {
+            try {
+                const action = {
+                    action: params.action,
+                    er_id: params.er_id,
+                    description: params.description,
+                    requester: params.requester,
+                    stage: params.stage,
+                    blocker: params.blocker,
+                    notes: params.notes,
+                };
+                const result = await pipeline.handleRequest(action);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: result.success,
+                                message: result.message,
+                                ...(result.er ? {
+                                    er: {
+                                        id: result.er.id,
+                                        stage: result.er.stage,
+                                        blocked: result.er.blocked,
+                                        buildAttempts: result.er.buildAttempts,
+                                        updatedAt: result.er.updatedAt,
+                                    },
+                                } : {}),
+                            }, null, 2),
+                        }],
+                    ...(result.success ? {} : { isError: true }),
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: `sam_request error: ${err instanceof Error ? err.message : String(err)}` }],
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=sam-request.js.map

package/dist/tools/sam-request.js.map

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

package/dist/tools/sam-status.d.ts

@@ -0,0 +1,29 @@
+/**
+ * sam_status — Report Sam's current state
+ *
+ * Called by: Jessie (morning briefing), Mighty Mark (health checks), Greg
+ */
+import type { PipelineManager } from '../pipeline/pipeline-manager.js';
+import type { SamPluginConfig } from '../pipeline/types.js';
+export declare function createStatusTool(pipeline: PipelineManager, config: SamPluginConfig, fleetBusStatus: () => string): {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {};
+    };
+    execute(_toolCallId: string, _params: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};
+//# sourceMappingURL=sam-status.d.ts.map

package/dist/tools/sam-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sam-status.d.ts","sourceRoot":"","sources":["../../src/tools/sam-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,sBAAsB,CAAC;AAE7E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM;;;;;;;yBAMlF,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;EA+BtE"}

package/dist/tools/sam-status.js

@@ -0,0 +1,42 @@
+/**
+ * sam_status — Report Sam's current state
+ *
+ * Called by: Jessie (morning briefing), Mighty Mark (health checks), Greg
+ */
+export function createStatusTool(pipeline, config, fleetBusStatus) {
+    return {
+        name: 'sam_status',
+        description: 'Get Sam\'s current state — active ERs, blocked ERs, sandbox status, fleet-bus status. Use for morning briefings and health checks.',
+        parameters: { type: 'object', properties: {} },
+        async execute(_toolCallId, _params) {
+            try {
+                const summary = pipeline.getSummary();
+                const lastActivity = pipeline.getLastActivity();
+                const result = {
+                    agent: {
+                        name: 'Sam',
+                        role: 'Chief Engineer',
+                        version: '0.2.0',
+                        internalName: 'SAM2',
+                    },
+                    pipeline: summary,
+                    lastActivity,
+                    sandbox: {
+                        status: config.sandboxEnabled ? 'available' : 'unavailable',
+                    },
+                    fleetBus: fleetBusStatus(),
+                };
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: `sam_status error: ${err instanceof Error ? err.message : String(err)}` }],
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=sam-status.js.map

package/dist/tools/sam-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sam-status.js","sourceRoot":"","sources":["../../src/tools/sam-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,UAAU,gBAAgB,CAAC,QAAyB,EAAE,MAAuB,EAAE,cAA4B;IAC/G,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,oIAAoI;QACtI,UAAU,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE;QACvD,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,OAAgC;YACjE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACtC,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;gBAEhD,MAAM,MAAM,GAAoB;oBAC9B,KAAK,EAAE;wBACL,IAAI,EAAE,KAAK;wBACX,IAAI,EAAE,gBAAgB;wBACtB,OAAO,EAAE,OAAO;wBAChB,YAAY,EAAE,MAAM;qBACrB;oBACD,QAAQ,EAAE,OAAO;oBACjB,YAAY;oBACZ,OAAO,EAAE;wBACP,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;qBAC5D;oBACD,QAAQ,EAAE,cAAc,EAAiC;iBAC1D,CAAC;gBAEF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;iBACnE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBAC1G,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/openclaw.plugin.json

@@ -1,11 +1,47 @@
 {
   "id": "sam",
-  "name": "Sam — Engineering Agent",
-  "description": "Sandboxed engineering agent plugin — receives tasks via fleet-bus, reports status and completion. No outbound fleet tools (by design).",
+  "name": "Sam — Chief Engineer",
+  "description": "Chief Engineer plugin — engineering pipeline management, Docker sandbox execution, autonomous build/test/deliver lifecycle, fleet-bus communications, and searchable engineering memory.",
+  "version": "0.2.0",
+  "entry": "dist/plugin.js",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "properties": {},
+    "properties": {
+      "dataDir": {
+        "type": "string",
+        "description": "Directory for Sam's pipeline data storage",
+        "default": ".sam-data"
+      },
+      "sandboxEnabled": {
+        "type": "boolean",
+        "description": "Enable Docker sandbox execution tools (Phase 2)",
+        "default": false
+      },
+      "sandboxImage": {
+        "type": "string",
+        "description": "Docker image name for the sandbox container",
+        "default": "sam-sandbox:latest"
+      },
+      "artifactDir": {
+        "type": "string",
+        "description": "Directory for build artifacts",
+        "default": ".sam-artifacts"
+      },
+      "artifactRetentionDays": {
+        "type": "number",
+        "description": "Days to retain build artifacts before cleanup (default: 7)",
+        "default": 7
+      },
+      "telegramToken": {
+        "type": "string",
+        "description": "@sam_gidanc_bot Telegram bot token"
+      },
+      "telegramChatId": {
+        "type": "string",
+        "description": "Telegram chat ID for engineering updates to Greg"
+      }
+    },
     "required": []
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aiassesstech/sam",
-  "version": "0.1.1",
-  "description": "Sam — Engineering Agent plugin for OpenClaw. Sandboxed task receiver with fleet-bus integration.",
+  "version": "0.2.0",
+  "description": "Sam — Chief Engineer plugin for OpenClaw. Engineering pipeline, Docker sandbox, autonomous execution, fleet-bus communications.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,6 +10,9 @@
       "./dist/plugin.js"
     ]
   },
+  "bin": {
+    "sam": "./dist/cli/bin.js"
+  },
   "files": [
     "dist",
     "agent",
@@ -20,16 +23,21 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm run build"
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
   },
   "keywords": [
     "sam",
+    "sam2",
+    "chief-engineer",
     "engineering-agent",
-    "sandboxed",
     "openclaw",
-    "fleet-bus"
+    "fleet-bus",
+    "pipeline"
   ],
   "author": "GiDanc AI LLC",
   "license": "MIT",
@@ -43,16 +51,21 @@
     "url": "https://github.com/spar65/compsi/issues"
   },
   "peerDependencies": {
-    "@aiassesstech/fleet-bus": ">=0.1.0"
+    "@aiassesstech/fleet-bus": ">=0.1.3",
+    "@aiassesstech/mighty-mark": ">=0.3.0"
   },
   "peerDependenciesMeta": {
     "@aiassesstech/fleet-bus": {
       "optional": true
+    },
+    "@aiassesstech/mighty-mark": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.1"
   },
   "engines": {
     "node": ">=18.0.0"