@geraldmaron/construct 1.2.0 → 1.2.1

package/lib/mcp/server.mjs

@@ -58,7 +58,7 @@ import {
   profileCreate, profileArchive, sandboxList, learningStatus,
   knowledgeGraphAsk,
 } from './tools/profile.mjs';
-import { modelResolve, triageRecommend, workflowInvoke, capabilityDescribe, executionResolve } from './tools/embedded-contract.mjs';
+import { modelResolve, triageRecommend, workflowInvoke, capabilityDescribe, executionResolve, artifactWorkflow } from './tools/embedded-contract.mjs';
 
 const DEFAULT_ROOT_DIR = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
 const ROOT_DIR = resolve(process.env.CX_TOOLKIT_DIR || DEFAULT_ROOT_DIR);
@@ -1134,6 +1134,23 @@ const ALL_TOOL_DEFS = [
         },
       },
     },
+    {
+      name: 'artifact_workflow',
+      description: 'Plan a manifest-backed document artifact workflow and return a truthful provenance report. It separates planned steps from locally executed validation/export and never claims a host-planned specialist review or rewrite was completed. Durable local export requires approval_mode=allow-durable-write.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          input: { type: 'string', description: 'Natural-language artifact request.' },
+          artifact_type: { type: 'string', description: 'Registered manifest document class.' },
+          file_path: { type: 'string', description: 'Optional existing source document for local validation/export.' },
+          format: { type: 'string', description: 'Distribution format such as pdf, docx, html, deck, or pptx.' },
+          output_path: { type: 'string', description: 'Optional output destination when locally exporting.' },
+          branding: { type: 'string', enum: ['construct', 'plain'], description: 'Construct is default; plain is an explicit opt-out.' },
+          overrides: { type: 'object', description: 'Per-invocation manifest workflow overrides.' },
+          approval_mode: { type: 'string', enum: ['proposal-only', 'requires-human-approval', 'allow-durable-write'], description: 'Only allow-durable-write performs local validation/export.' },
+        },
+      },
+    },
     {
       name: 'model_resolve',
       description: 'Resolve which model an embedded Construct workflow should use given the host/IDE provider context. Precedence: host model → same-provider-family fallback → Construct tier default → structured config error. Never reads or returns credential values (requiresCredential is a boolean) and never claims unverified provider health. Read-only; performs no writes.',
@@ -1421,6 +1438,7 @@ export async function dispatchToolByName(name, args = {}) {
     else if (name === 'workflow_invoke') result = await workflowInvoke(args);
     else if (name === 'capability_describe') result = capabilityDescribe(args);
     else if (name === 'construct_execution_resolve') result = executionResolve(args);
+    else if (name === 'artifact_workflow') result = artifactWorkflow(args);
     else if (name === 'orchestration_run') { const m = await import('./tools/orchestration-run.mjs'); result = await m.orchestrationRun(args); }
     else if (name === 'orchestration_status') { const m = await import('./tools/orchestration-run.mjs'); result = await m.orchestrationStatus(args); }
     else if (name === 'construct_call') {

package/lib/mcp/tools/embedded-contract.mjs

@@ -14,6 +14,7 @@ import { invokeWorkflow as invokeWorkflowCore } from '../../embedded-contract/wo
 import { buildCapabilityContract } from '../../embedded-contract/capability.mjs';
 import { resolveExecution as resolveExecutionCore } from '../../embedded-contract/execution.mjs';
 import { resolveInput } from '../../embedded-contract/ingest.mjs';
+import { runArtifactWorkflow as runArtifactWorkflowCore } from '../../artifact-workflow.mjs';
 
 async function ingestArgs(args) {
   if (args.input || !args.file_path) return { input: args.input, ingestion: undefined };
@@ -91,3 +92,16 @@ export function executionResolve(args = {}) {
   };
   return wrapContractResult(resolveExecutionCore(request), { surface: 'mcp' });
 }
+
+export function artifactWorkflow(args = {}) {
+  return wrapContractResult(runArtifactWorkflowCore({
+    input: args.input || args.request,
+    artifactType: args.artifact_type,
+    filePath: args.file_path,
+    format: args.format,
+    outputPath: args.output_path,
+    branding: args.branding,
+    overrides: args.overrides,
+    approvalMode: args.approval_mode,
+  }), { surface: 'mcp' });
+}

package/lib/playwright-demo.mjs

@@ -80,6 +80,8 @@ export function transcodeWebmToMp4(src, dest) {
   const result = spawnSync(ffmpeg, [
     '-y', '-i', src,
     '-c:v', 'libx264',
+    '-crf', '18',
+    '-preset', 'medium',
     '-pix_fmt', 'yuv420p',
     '-movflags', '+faststart',
     dest,

package/lib/server/index.mjs

@@ -704,7 +704,9 @@ const server = createServer(async (req, res) => {
   const rateTier = url.pathname === '/api/chat/stream' || url.pathname === '/api/chat'
     || url.pathname === '/api/chat/loop/stream'
     ? 'chat'
-    : (req.method !== 'GET' && req.method !== 'HEAD' ? 'write' : 'read');
+    : url.pathname === '/api/chat/loop/command'
+      ? 'command'
+      : (req.method !== 'GET' && req.method !== 'HEAD' ? 'write' : 'read');
   if (checkRateLimit) {
     const limit = checkRateLimit(req, rateTier, { env: process.env });
     if (!limit.allowed) {
@@ -1580,6 +1582,32 @@ const server = createServer(async (req, res) => {
     return;
   }
 
+  if (url.pathname === '/api/sources' && req.method === 'GET') {
+    try {
+      const { loadProjectConfig } = await import('../config/project-config.mjs');
+      const {
+        resolveEffectiveSourceTargetsFromConfig,
+        legacyEnvSourceTargets,
+        normalizeConfigTarget,
+      } = await import('../config/source-targets.mjs');
+      const loaded = loadProjectConfig(ROOT_DIR, process.env);
+      const configTargets = (loaded.config.sources?.targets ?? []).map(normalizeConfigTarget);
+      const envTargets = legacyEnvSourceTargets(process.env);
+      const effective = resolveEffectiveSourceTargetsFromConfig(loaded.config, process.env);
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({
+        path: loaded.path,
+        configTargets,
+        envTargets,
+        effective,
+      }));
+    } catch (err) {
+      res.writeHead(500, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: err.message }));
+    }
+    return;
+  }
+
   if (url.pathname === '/api/intake/config' && req.method === 'GET') {
     try {
       const { loadIntakeConfig, INTAKE_DEPTH_GUIDANCE, INTAKE_HARD_MAX_DEPTH } = await import('../intake/intake-config.mjs');
@@ -1592,7 +1620,7 @@ const server = createServer(async (req, res) => {
         rootDir: ROOT_DIR,
         guidance: INTAKE_DEPTH_GUIDANCE,
         hardMaxDepth: INTAKE_HARD_MAX_DEPTH,
-        defaults: { projectInbox: '.cx/inbox', docsIntake: 'docs/intake' },
+        defaults: { projectInbox: '.cx/inbox', docsIntake: 'docs/intake', rootInbox: 'inbox/' },
         label: rebrand.intakeQueueLabel,
         itemNoun: rebrand.signalNoun,
       }));
@@ -2341,6 +2369,7 @@ const server = createServer(async (req, res) => {
             maxDepth: data.maxDepth,
             includeProjectInbox: data.includeProjectInbox,
             includeDocsIntake: data.includeDocsIntake,
+            includeRootInbox: data.includeRootInbox ?? data.includeArchetypeInbox,
           });
           res.writeHead(200, { 'Content-Type': 'application/json' });
           res.end(JSON.stringify({ success: true, config: next }));

package/lib/server/rate-limit.mjs

@@ -3,9 +3,10 @@
  *
  * Three tiers, configurable via env:
  *
- *   read    60 req/min/key  (dashboard polling, list endpoints)
- *   chat    10 req/min/key  (/api/chat/stream — bursty + expensive)
- *   write    5 req/min/key  (state-mutating endpoints — approvals, config)
+ *   read     60 req/min/key  (dashboard polling, list endpoints)
+ *   chat     10 req/min/key  (/api/chat/stream — bursty + expensive)
+ *   command 120 req/min/key  (/api/chat/loop/command — slash cmds, no LLM)
+ *   write     5 req/min/key  (state-mutating endpoints — approvals, config)
  *
  * `key` is by default the request's source IP, with the active session id
  * mixed in when present so two users behind the same NAT get separate
@@ -18,6 +19,7 @@
 const DEFAULT_TIERS = {
   read:  { capacity: 60, refillPerMs: 60 / 60_000 },
   chat:  { capacity: 10, refillPerMs: 10 / 60_000 },
+  command: { capacity: 120, refillPerMs: 120 / 60_000 },
   write: { capacity:  5, refillPerMs:  5 / 60_000 },
 };
 

package/lib/server/webhook.mjs

@@ -306,8 +306,9 @@ async function runSnapshotForSlack() {
     const { SnapshotEngine, renderMarkdown } = await import('../embed/snapshot.mjs');
     const { EMPTY_CONFIG } = await import('../embed/config.mjs');
 
-    const registry = ProviderRegistry.fromEnv(env);
-    const sources = registry.autoSources(env);
+    const registry = await ProviderRegistry.fromEnv(env);
+    const { resolveAutoEmbedSources } = await import('../embed/auto-sources.mjs');
+    const sources = resolveAutoEmbedSources({ cwd: process.cwd(), env, registry });
     if (!sources.length) return '⚠️ No embed sources configured. Add credentials to config.env.';
 
     const config = { ...EMPTY_CONFIG, sources, snapshot: { maxItems: 10 } };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geraldmaron/construct",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "packageManager": "npm@11.5.1",
   "description": "Construct — agent orchestration layer for OpenCode, Claude Code, and other coding surfaces",

package/specialists/artifact-manifest.json

@@ -1,7 +1,16 @@
 {
   "$schema": "./artifact-manifest.schema.json",
-  "version": 1,
-  "description": "Single source of truth for document types: template, owners, workflow skill, tone, structure, visuals, and release gates.",
+  "version": 2,
+  "description": "Single source of truth for registered document classes: template, author and reviewer chains, workflow skill, validation, output capability, tone, structure, visuals, and release gates.",
+  "workflowDefaults": {
+    "validation": {
+      "releaseGate": true
+    },
+    "outputs": {
+      "formats": ["pdf", "docx", "doc", "deck", "pptx", "html", "rtf", "odt", "epub", "tex", "txt", "md", "mdx"],
+      "branding": "construct"
+    }
+  },
   "artifacts": {
     "prd": {
       "template": "templates/docs/prd.md",

package/specialists/artifact-manifest.schema.json

@@ -8,6 +8,7 @@
   "properties": {
     "version": { "type": "integer", "minimum": 1 },
     "description": { "type": "string" },
+    "workflowDefaults": { "$ref": "#/$defs/workflowDefaults" },
     "artifacts": {
       "type": "object",
       "additionalProperties": { "$ref": "#/$defs/artifactEntry" }
@@ -34,6 +35,29 @@
         "optionalReviewers": { "type": "array", "items": { "type": "string" } }
       }
     },
+    "workflowDefaults": {
+      "type": "object",
+      "properties": {
+        "authorChain": { "type": "array", "items": { "type": "string" } },
+        "reviewerChain": { "type": "array", "items": { "type": "string" } },
+        "validation": { "$ref": "#/$defs/validation" },
+        "outputs": { "$ref": "#/$defs/outputs" }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "releaseGate": { "type": "boolean" },
+        "requiredChecks": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "outputs": {
+      "type": "object",
+      "properties": {
+        "formats": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "branding": { "type": "string", "enum": ["construct", "plain"] }
+      }
+    },
     "artifactEntry": {
       "type": "object",
       "required": ["template", "primaryOwners", "toneDefault", "releaseGate"],
@@ -46,7 +70,13 @@
         "structureRequirements": { "type": "array", "items": { "type": "string" } },
         "visualRequirements": { "type": "array", "items": { "$ref": "#/$defs/visualRequirement" } },
         "researchProfile": { "type": ["string", "null"] },
-        "releaseGate": { "$ref": "#/$defs/releaseGate" }
+        "releaseGate": { "$ref": "#/$defs/releaseGate" },
+        "documentClass": { "type": "string" },
+        "aliases": { "type": "array", "items": { "type": "string" } },
+        "authorChain": { "type": "array", "items": { "type": "string" } },
+        "reviewerChain": { "type": "array", "items": { "type": "string" } },
+        "validation": { "$ref": "#/$defs/validation" },
+        "outputs": { "$ref": "#/$defs/outputs" }
       }
     }
   }