phronesis 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phronesis",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "private": false,
   "type": "module",
   "description": "Phronesis CLI + daemon. Ports the pming scaffold forward to the three-layer installation layout.",

package/src/act.js

@@ -10,7 +10,7 @@
 // (--session/--domain/--actor/--surface/--dir). The approval signal (D5) is the
 // adapter-set env PHRONESIS_APPROVAL_SOURCE — deliberately not a flag and not payload.
 
-import { resolveInvocationIdForAct, runAction } from '@phronesis/core';
+import { resolveInvocationIdForAct, runAction, describeActionSchema } from '@phronesis/core';
 
 export async function runAct({ type, json, session, domain, actor, surface, dir, invocationId } = {}) {
   if (!type) {
@@ -59,3 +59,64 @@ export async function runAct({ type, json, session, domain, actor, surface, dir,
     return null;
   }
 }
+
+// `phronesis act <type> --schema` — read-only introspection of a type's EFFECTIVE payload
+// schema (change 0045). Pure parse-and-delegate like runAct: all install/registry access
+// lives behind describeActionSchema in @phronesis/core (validate-actions D7b); this handler
+// only formats the plain-data result and prints it. Unlike `registry status`'s terse
+// one-line summary, this renders the enum `values` too — the whole point is that a caller
+// reads the payload contract instead of probing it with empty payloads.
+function formatField(f) {
+  const facets = [f.kind];
+  if (f.nonEmpty) facets.push('non-empty');
+  if (f.kind === 'enum' && Array.isArray(f.values)) facets.push(`one of: ${f.values.join(' | ')}`);
+  return `  ${f.name}${f.required ? ' *' : ''}  —  ${facets.join(', ')}`;
+}
+
+export async function runActSchema({ type, dir } = {}) {
+  if (!type) {
+    console.error('act --schema: name an action <type> (e.g. log_decision).');
+    process.exitCode = 1;
+    return null;
+  }
+
+  const result = await describeActionSchema({ dir, cwd: process.cwd(), type });
+
+  if (result.status === 'error') {
+    console.error(result.message);
+    process.exitCode = 1;
+    return null;
+  }
+  if (result.status === 'invalid-registry') {
+    console.error(
+      'act --schema: the action-type registry is invalid — the action layer is disabled until it is fixed (removing the action_types section restores built-in defaults):',
+    );
+    for (const e of result.errors) console.error(`  - ${e}`);
+    process.exitCode = 1;
+    return null;
+  }
+  if (result.status === 'unknown-type') {
+    console.error(
+      result.isCodeType
+        ? `act --schema: "${result.type}" is a known action type but is not registered in this install, so it refuses to run. Registered types: ${result.knownTypes.join(', ')}`
+        : `act --schema: unknown action type "${result.type}". Known types: ${result.knownTypes.join(', ')}`,
+    );
+    process.exitCode = 1;
+    return null;
+  }
+
+  const sourceLabel =
+    result.source === 'registry' ? '.phronesis/registry.json action_types' : 'built-in defaults';
+  const lines = [
+    `${result.type} — payload schema (source: ${sourceLabel})`,
+    'Semantic inputs go inside --json; * marks a required field.',
+  ];
+  if (!result.fields.length) {
+    lines.push('  (this action type takes no payload fields)');
+  } else {
+    for (const f of result.fields) lines.push(formatField(f));
+  }
+  console.log(lines.join('\n'));
+  process.exitCode = 0;
+  return { type: result.type, source: result.source, fields: result.fields };
+}