@formlm/cli 0.1.3 → 0.2.0

package/dist/commands/scale.js

@@ -0,0 +1,289 @@
+import { execCommand } from '../exec.js';
+import { output } from '../output.js';
+function normBool(v) {
+    if (v === undefined)
+        return undefined;
+    if (typeof v === 'boolean')
+        return v;
+    return v === 'true' || v === '1';
+}
+export function registerScaleCommand(parent) {
+    const scale = parent.command('scale').description('Scale dimensions, field associations & score ranges');
+    // ========== Dimension Management ==========
+    scale
+        .command('query')
+        .alias('list')
+        .description('List all scale dimensions (use --md for token-efficient markdown)')
+        .requiredOption('--app <appId>', 'App ID')
+        .option('--md', 'Markdown table output (for AI)')
+        .option('--human', 'Humanized display (hides system IDs)')
+        .option('--filter <keyword>', 'Keyword filter (matches id/name/keys)')
+        .action(async (opts) => {
+        let cmd = `assess scale query --app ${opts.app}`;
+        if (opts.md)
+            cmd += ' --md';
+        if (opts.human)
+            cmd += ' --human';
+        if (opts.filter)
+            cmd += ` --filter "${opts.filter}"`;
+        if (!opts.md && !opts.human)
+            cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('find')
+        .description('Find a single scale dimension by ID or keyword (returns full details)')
+        .requiredOption('--app <appId>', 'App ID')
+        .option('--id <scaleId>', 'Scale dimension ID')
+        .option('--filter <keyword>', 'Keyword filter')
+        .action(async (opts) => {
+        let cmd = `assess scale find --app ${opts.app}`;
+        if (opts.id)
+            cmd += ` --id ${opts.id}`;
+        if (opts.filter)
+            cmd += ` --filter "${opts.filter}"`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('add')
+        .description('Add a scale dimension (or update if ID exists). Required before adding score ranges')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--id <scaleId>', 'Dimension ID')
+        .requiredOption('--name <name>', 'Dimension name')
+        .option('--format <format>', 'Calculation: sum (total) / avg (average) / count (item count)', 'sum')
+        .option('--direction <direction>', 'Scale direction: positive (high=good) / negative (symptom, high=bad)')
+        .option('--weight <weight>', 'Dimension weight', parseFloat)
+        .option('--kbText <text>', 'Knowledge base text (required by server, max 500 chars)')
+        .action(async (opts) => {
+        let cmd = `assess scale add --app ${opts.app} --id ${opts.id} --name "${opts.name}" --format ${opts.format}`;
+        if (opts.direction)
+            cmd += ` --direction ${opts.direction}`;
+        if (opts.weight !== undefined)
+            cmd += ` --weight ${opts.weight}`;
+        if (opts.kbText)
+            cmd += ` --kbText "${opts.kbText}"`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('update')
+        .description('Update a scale dimension')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--id <scaleId>', 'Dimension ID')
+        .option('--name <name>', 'Dimension name')
+        .option('--format <format>', 'Calculation: sum / avg / count')
+        .option('--direction <direction>', 'Scale direction: positive / negative')
+        .option('--weight <weight>', 'Dimension weight', parseFloat)
+        .option('--kbText <text>', 'Knowledge base text (max 500 chars)')
+        .action(async (opts) => {
+        let cmd = `assess scale update --app ${opts.app} --id ${opts.id}`;
+        if (opts.name)
+            cmd += ` --name "${opts.name}"`;
+        if (opts.format)
+            cmd += ` --format ${opts.format}`;
+        if (opts.direction)
+            cmd += ` --direction ${opts.direction}`;
+        if (opts.weight !== undefined)
+            cmd += ` --weight ${opts.weight}`;
+        if (opts.kbText)
+            cmd += ` --kbText "${opts.kbText}"`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('set')
+        .description('Set a single property on a scale dimension (name/format/direction/weight/kbText/maxScore/minScore/negKeys/data.<id>.value)')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--id <scaleId>', 'Dimension ID')
+        .requiredOption('--property <property>', 'Property path (e.g. name, format, direction, data.<dataId>.value)')
+        .requiredOption('--value <value>', 'New value')
+        .action(async (opts) => {
+        const cmd = `assess scale set --app ${opts.app} --id ${opts.id} --property ${opts.property} --value "${opts.value}" --json`;
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('remove')
+        .description('Remove a scale dimension')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--id <scaleId>', 'Dimension ID')
+        .action(async (opts) => {
+        const cmd = `assess scale remove --app ${opts.app} --id ${opts.id} --json`;
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('clear')
+        .description('Clear all scale dimensions')
+        .requiredOption('--app <appId>', 'App ID')
+        .action(async (opts) => {
+        const cmd = `assess scale clear --app ${opts.app} --json`;
+        output(await execCommand(cmd));
+    });
+    scale
+        .command('config')
+        .description('Configure global scale options (enableSingle / enableOption)')
+        .requiredOption('--app <appId>', 'App ID')
+        .option('--enable-single [value]', 'Single display mode: only show matched dimension result (true/false)')
+        .option('--enable-option [value]', 'Expand option sub-items when associating dimensions (true/false)')
+        .action(async (opts) => {
+        let cmd = `assess scale config --app ${opts.app}`;
+        const es = normBool(opts.enableSingle);
+        if (es !== undefined)
+            cmd += ` --enable-single=${es}`;
+        const eo = normBool(opts.enableOption);
+        if (eo !== undefined)
+            cmd += ` --enable-option=${eo}`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    // ========== Keys (Field Association) Management ==========
+    const keys = scale.command('keys').description('Associate fields with scale dimensions');
+    keys
+        .command('add')
+        .description('Associate fields with a scale dimension (via Field key). Supports --fields for batch, --polarities for auto reverse-scored fields')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .option('--field <fieldKey>', 'Single field key (use with --fields for batch)')
+        .option('--fields <fieldKeys>', 'Batch field keys, comma-separated (e.g. X1,X2,X3)')
+        .option('--polarities <polarities>', 'Field polarity declarations: fieldKey:positive/symptom,... (auto-computes reverse-scored fields)')
+        .option('--negFields <fieldKeys>', '[Deprecated] Reverse-scored field keys, comma-separated. Use --polarities instead')
+        .action(async (opts) => {
+        let cmd = `assess scale keys add --app ${opts.app} --scale ${opts.scale}`;
+        if (opts.field)
+            cmd += ` --field ${opts.field}`;
+        if (opts.fields)
+            cmd += ` --fields ${opts.fields}`;
+        if (opts.polarities)
+            cmd += ` --polarities ${opts.polarities}`;
+        if (opts.negFields)
+            cmd += ` --negFields ${opts.negFields}`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    keys
+        .command('remove')
+        .description('Disassociate fields from a scale dimension')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .option('--field <fieldKey>', 'Single field key')
+        .option('--fields <fieldKeys>', 'Batch field keys, comma-separated')
+        .action(async (opts) => {
+        let cmd = `assess scale keys remove --app ${opts.app} --scale ${opts.scale}`;
+        if (opts.field)
+            cmd += ` --field ${opts.field}`;
+        if (opts.fields)
+            cmd += ` --fields ${opts.fields}`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    keys
+        .command('list')
+        .description('List fields associated with a scale dimension')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .action(async (opts) => {
+        const cmd = `assess scale keys list --app ${opts.app} --scale ${opts.scale} --json`;
+        output(await execCommand(cmd));
+    });
+    keys
+        .command('set')
+        .description('Set scoring direction for associated fields (negScore=true=reverse, false=normal)')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .requiredOption('--fields <fieldKeys>', 'Field keys, comma-separated')
+        .requiredOption('--negScore <bool>', 'true=reverse-scored (high score inverted), false=normal', (v) => v === 'true')
+        .action(async (opts) => {
+        const cmd = `assess scale keys set --app ${opts.app} --scale ${opts.scale} --fields ${opts.fields} --negScore ${opts.negScore} --json`;
+        output(await execCommand(cmd));
+    });
+    // ========== Data (Score Ranges) Management ==========
+    const data = scale.command('data').description('Score range (result tier) management');
+    data
+        .command('add')
+        .description('Add score ranges. Batch mode: --ranges "0-7:Normal,8-14:Mild,15-21:Severe". Single mode: --min --max --value')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .option('--ranges <ranges>', 'Batch format: min-max:value[:desc], comma-separated. e.g. "0-7:Normal,8-14:Mild,15-21:Severe"')
+        .option('--id <dataId>', 'Range ID (auto-generated if omitted, single mode only)')
+        .option('--min <min>', 'Min score (single mode)', parseFloat)
+        .option('--max <max>', 'Max score (single mode)', parseFloat)
+        .option('--value <value>', 'Result label (single mode)')
+        .option('--desc <description>', 'Range description')
+        .option('--unique [value]', 'Unique display in enableSingle mode (true/false)')
+        .action(async (opts) => {
+        let cmd = `assess scale data add --app ${opts.app} --scale ${opts.scale}`;
+        if (opts.ranges)
+            cmd += ` --ranges "${opts.ranges}"`;
+        if (opts.id)
+            cmd += ` --id ${opts.id}`;
+        if (opts.min !== undefined)
+            cmd += ` --min ${opts.min}`;
+        if (opts.max !== undefined)
+            cmd += ` --max ${opts.max}`;
+        if (opts.value)
+            cmd += ` --value "${opts.value}"`;
+        if (opts.desc)
+            cmd += ` --desc "${opts.desc}"`;
+        const u = normBool(opts.unique);
+        if (u !== undefined)
+            cmd += ` --unique=${u}`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    data
+        .command('update')
+        .description('Update a score range')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .requiredOption('--id <dataId>', 'Range ID')
+        .option('--min <min>', 'Min score', parseFloat)
+        .option('--max <max>', 'Max score', parseFloat)
+        .option('--value <value>', 'Result label')
+        .option('--desc <description>', 'Range description')
+        .option('--unique [value]', 'Unique display (true/false)')
+        .action(async (opts) => {
+        let cmd = `assess scale data update --app ${opts.app} --scale ${opts.scale} --id ${opts.id}`;
+        if (opts.min !== undefined)
+            cmd += ` --min ${opts.min}`;
+        if (opts.max !== undefined)
+            cmd += ` --max ${opts.max}`;
+        if (opts.value)
+            cmd += ` --value "${opts.value}"`;
+        if (opts.desc)
+            cmd += ` --desc "${opts.desc}"`;
+        const u = normBool(opts.unique);
+        if (u !== undefined)
+            cmd += ` --unique=${u}`;
+        cmd += ' --json';
+        output(await execCommand(cmd));
+    });
+    data
+        .command('remove')
+        .description('Remove a score range')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .requiredOption('--id <dataId>', 'Range ID')
+        .action(async (opts) => {
+        const cmd = `assess scale data remove --app ${opts.app} --scale ${opts.scale} --id ${opts.id} --json`;
+        output(await execCommand(cmd));
+    });
+    data
+        .command('list')
+        .description('List all score ranges for a dimension')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .action(async (opts) => {
+        const cmd = `assess scale data list --app ${opts.app} --scale ${opts.scale} --json`;
+        output(await execCommand(cmd));
+    });
+    data
+        .command('clear')
+        .description('Clear all score ranges for a dimension')
+        .requiredOption('--app <appId>', 'App ID')
+        .requiredOption('--scale <scaleId>', 'Dimension ID')
+        .action(async (opts) => {
+        const cmd = `assess scale data clear --app ${opts.app} --scale ${opts.scale} --json`;
+        output(await execCommand(cmd));
+    });
+}
+//# sourceMappingURL=scale.js.map

package/dist/commands/scale.js.map

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

package/dist/commands/share.js

@@ -1,7 +1,7 @@
 import { execCommand } from '../exec.js';
 import { output } from '../output.js';
 export function registerShareCommand(parent) {
-    const share = parent.command('share').description('Share & publish management');
+    const share = parent.command('share').description('Share & publish management — set command is naturally idempotent (safe to re-run)');
     share
         .command('publish')
         .description('Publish the form for public access (each respondent can submit once; unlimited respondents; stays open until unpublished)')

package/dist/commands/share.js.map

@@ -1 +1 @@
-{"version":3,"file":"share.js","sourceRoot":"","sources":["../../src/commands/share.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;IAEhF,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2HAA2H,CAAC;SACxI,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,0BAA0B,IAAI,CAAC,GAAG,0DAA0D,CAAC;QACzG,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,mBAAmB,CAAC;SAChC,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,0BAA0B,IAAI,CAAC,GAAG,wBAAwB,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sBAAsB,CAAC;SACnC,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,4BAA4B,IAAI,CAAC,GAAG,SAAS,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,0BAA0B,CAAC;SACvC,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,0BAA0B,IAAI,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../../src/commands/share.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,mFAAmF,CAAC,CAAC;IAEvI,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2HAA2H,CAAC;SACxI,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,0BAA0B,IAAI,CAAC,GAAG,0DAA0D,CAAC;QACzG,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,mBAAmB,CAAC;SAChC,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,0BAA0B,IAAI,CAAC,GAAG,wBAAwB,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sBAAsB,CAAC;SACnC,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,4BAA4B,IAAI,CAAC,GAAG,SAAS,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,0BAA0B,CAAC;SACvC,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,0BAA0B,IAAI,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+/**
+ * Skill Command — Fetch SKILL.md Domain Knowledge
+ *
+ * Returns the full SKILL.md content for a given skill module. These are the same
+ * skill documents that newapp.html's AssessAgent/BuilderAgent loads internally to
+ * enforce P0/P1/P2 constraints when generating CLI commands.
+ *
+ * AI agents should read the relevant skill document BEFORE constructing commands
+ * to ensure they follow all domain constraints.
+ *
+ * Available skills: form, scale, connect, report, expert, share
+ */
+export declare function registerSkillCommand(parent: Command): void;
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAe1D"}

package/dist/commands/skill.js

@@ -0,0 +1,31 @@
+import { execCommand } from '../exec.js';
+import { output } from '../output.js';
+/**
+ * Skill Command — Fetch SKILL.md Domain Knowledge
+ *
+ * Returns the full SKILL.md content for a given skill module. These are the same
+ * skill documents that newapp.html's AssessAgent/BuilderAgent loads internally to
+ * enforce P0/P1/P2 constraints when generating CLI commands.
+ *
+ * AI agents should read the relevant skill document BEFORE constructing commands
+ * to ensure they follow all domain constraints.
+ *
+ * Available skills: form, scale, connect, report, expert, share
+ */
+export function registerSkillCommand(parent) {
+    parent
+        .command('skill')
+        .description('Get SKILL.md domain knowledge for a skill module (form/scale/connect/report/expert/share)')
+        .argument('<skillId>', 'Skill ID: form / scale / connect / report / expert / share')
+        .action(async (skillId) => {
+        const valid = ['form', 'scale', 'connect', 'report', 'expert', 'share'];
+        if (!valid.includes(skillId)) {
+            console.error(`❌ Invalid skill ID "${skillId}". Valid: ${valid.join(', ')}`);
+            process.exit(1);
+        }
+        const cmd = `assess skill ${skillId}`;
+        const result = await execCommand(cmd);
+        output(result);
+    });
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,2FAA2F,CAAC;SACxG,QAAQ,CAAC,WAAW,EAAE,4DAA4D,CAAC;SACnF,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,uBAAuB,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,GAAG,gBAAgB,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/smart.d.ts

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+/**
+ * Smart Pipeline Commands
+ *
+ * Wraps the server-side AssessAgent / BuilderAgent intelligent pipelines:
+ * - smart create: AssessAgent.plan() + execute() — natural language → full app
+ * - smart plan: AssessAgent.plan() only — preview plan without executing
+ * - smart modify: BuilderAgent Think → Plan → Execute → Reflect — modify existing app
+ *
+ * These are the RECOMMENDED entry points for AI agents (works with any MCP-compatible
+ * platform: Claude / Cursor / Codex CLI / Windsurf / etc., or direct CLI usage)
+ * because they embed the full SKILL.md domain knowledge, reference data injection,
+ * and multi-step orchestration that newapp.html uses internally.
+ */
+export declare function registerSmartCommand(parent: Command): void;
+//# sourceMappingURL=smart.d.ts.map

package/dist/commands/smart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart.d.ts","sourceRoot":"","sources":["../../src/commands/smart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAkE1D"}

package/dist/commands/smart.js

@@ -0,0 +1,81 @@
+import { execCommand } from '../exec.js';
+import { output } from '../output.js';
+/**
+ * Smart Pipeline Commands
+ *
+ * Wraps the server-side AssessAgent / BuilderAgent intelligent pipelines:
+ * - smart create: AssessAgent.plan() + execute() — natural language → full app
+ * - smart plan: AssessAgent.plan() only — preview plan without executing
+ * - smart modify: BuilderAgent Think → Plan → Execute → Reflect — modify existing app
+ *
+ * These are the RECOMMENDED entry points for AI agents (works with any MCP-compatible
+ * platform: Claude / Cursor / Codex CLI / Windsurf / etc., or direct CLI usage)
+ * because they embed the full SKILL.md domain knowledge, reference data injection,
+ * and multi-step orchestration that newapp.html uses internally.
+ */
+export function registerSmartCommand(parent) {
+    const smart = parent.command('smart').description('Intelligent pipeline — natural language to live app (recommended for AI agents)');
+    // ── smart create ──────────────────────────────────────────────
+    smart
+        .command('create')
+        .description('Create a complete app from natural language description. The server runs AssessAgent: plan → execute → reflect. This is the fastest way to get a production-ready assessment app')
+        .requiredOption('--input <text>', 'Natural language description of the app you want to build (e.g. "a mental health screening questionnaire for college students")')
+        .option('--plan-type <type>', 'Plan type: assessment / consultation / survey / exam / quiz / learn (default: auto-detected by AI)')
+        .option('--style <style>', 'Visual style preference (e.g. "深色科技风" or "warm and friendly")')
+        .option('--question-count <count>', 'Question count range: 10-15 / 15-20 / 20-30')
+        .action(async (opts) => {
+        let cmd = `assess smart create --input "${opts.input}"`;
+        if (opts.planType)
+            cmd += ` --plan-type ${opts.planType}`;
+        if (opts.style)
+            cmd += ` --style "${opts.style}"`;
+        if (opts.questionCount)
+            cmd += ` --question-count ${opts.questionCount}`;
+        cmd += ' --json';
+        const result = await execCommand(cmd);
+        output(result);
+    });
+    // ── smart plan ───────────────────────────────────────────────
+    smart
+        .command('plan')
+        .description('Preview the execution plan WITHOUT executing it. Returns the task list for user review. Equivalent to newapp.html review stage')
+        .requiredOption('--input <text>', 'Natural language description of the app you want to build')
+        .option('--plan-type <type>', 'Plan type: assessment / consultation / survey / exam / quiz / learn (default: auto-detected by AI)')
+        .option('--style <style>', 'Visual style preference (e.g. "深色科技风" or "warm and friendly")')
+        .option('--question-count <count>', 'Question count range: 10-15 / 15-20 / 20-30')
+        .action(async (opts) => {
+        let cmd = `assess smart plan --input "${opts.input}"`;
+        if (opts.planType)
+            cmd += ` --plan-type ${opts.planType}`;
+        if (opts.style)
+            cmd += ` --style "${opts.style}"`;
+        if (opts.questionCount)
+            cmd += ` --question-count ${opts.questionCount}`;
+        cmd += ' --json';
+        const result = await execCommand(cmd);
+        output(result);
+    });
+    // ── smart modify ──────────────────────────────────────────────
+    smart
+        .command('modify')
+        .description('Modify an existing app using natural language. The server runs BuilderAgent: think → plan → execute → reflect. Automatically queries current state, generates precise modification commands, and validates results')
+        .requiredOption('--app <appId>', 'App ID to modify')
+        .requiredOption('--input <text>', 'Natural language description of the change (e.g. "add a depression subscale" or "change the cover page to a dark blue gradient")')
+        .action(async (opts) => {
+        const cmd = `assess smart modify --app ${opts.app} --input "${opts.input}" --json`;
+        const result = await execCommand(cmd);
+        output(result);
+    });
+    // ── smart confirm ───────────────────────────────────
+    smart
+        .command('confirm')
+        .description('Confirm and execute a medium/high risk plan previously returned by smart modify with planPreview=true. Pass the exact "plan" JSON unmodified. No web UI required')
+        .requiredOption('--app <appId>', 'App ID (same as used for smart modify)')
+        .requiredOption('--plan-json <json>', 'The exact "plan" field returned by smart modify (unmodified JSON)')
+        .action(async (opts) => {
+        const cmd = `assess smart confirm --app ${opts.app} --plan-json "${opts.planJson}" --json`;
+        const result = await execCommand(cmd);
+        output(result);
+    });
+}
+//# sourceMappingURL=smart.js.map

package/dist/commands/smart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart.js","sourceRoot":"","sources":["../../src/commands/smart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,iFAAiF,CAAC,CAAC;IAErI,iEAAiE;IAEjE,KAAK;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kLAAkL,CAAC;SAC/L,cAAc,CAAC,gBAAgB,EAAE,iIAAiI,CAAC;SACnK,MAAM,CAAC,oBAAoB,EAAE,oGAAoG,CAAC;SAClI,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;SAC1F,MAAM,CAAC,0BAA0B,EAAE,6CAA6C,CAAC;SACjF,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,GAAG,GAAG,gCAAgC,IAAI,CAAC,KAAK,GAAG,CAAC;QACxD,IAAI,IAAI,CAAC,QAAQ;YAAE,GAAG,IAAI,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,IAAI,aAAa,IAAI,CAAC,KAAK,GAAG,CAAC;QAClD,IAAI,IAAI,CAAC,aAAa;YAAE,GAAG,IAAI,qBAAqB,IAAI,CAAC,aAAa,EAAE,CAAC;QACzE,GAAG,IAAI,SAAS,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,gEAAgE;IAEhE,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gIAAgI,CAAC;SAC7I,cAAc,CAAC,gBAAgB,EAAE,2DAA2D,CAAC;SAC7F,MAAM,CAAC,oBAAoB,EAAE,oGAAoG,CAAC;SAClI,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;SAC1F,MAAM,CAAC,0BAA0B,EAAE,6CAA6C,CAAC;SACjF,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,GAAG,GAAG,8BAA8B,IAAI,CAAC,KAAK,GAAG,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ;YAAE,GAAG,IAAI,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,IAAI,aAAa,IAAI,CAAC,KAAK,GAAG,CAAC;QAClD,IAAI,IAAI,CAAC,aAAa;YAAE,GAAG,IAAI,qBAAqB,IAAI,CAAC,aAAa,EAAE,CAAC;QACzE,GAAG,IAAI,SAAS,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,iEAAiE;IAEjE,KAAK;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oNAAoN,CAAC;SACjO,cAAc,CAAC,eAAe,EAAE,kBAAkB,CAAC;SACnD,cAAc,CAAC,gBAAgB,EAAE,kIAAkI,CAAC;SACpK,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,6BAA6B,IAAI,CAAC,GAAG,aAAa,IAAI,CAAC,KAAK,UAAU,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL,uDAAuD;IAEvD,KAAK;SACF,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,kKAAkK,CAAC;SAC/K,cAAc,CAAC,eAAe,EAAE,wCAAwC,CAAC;SACzE,cAAc,CAAC,oBAAoB,EAAE,mEAAmE,CAAC;SACzG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,8BAA8B,IAAI,CAAC,GAAG,iBAAiB,IAAI,CAAC,QAAQ,UAAU,CAAC;QAC3F,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+/**
+ * Snapshot Command — Aggregated App State Query
+ *
+ * Fetches the current state of ALL 6 modules (form, scale, connect, report, expert, share)
+ * in a single command, returning a unified JSON snapshot. This is the equivalent of
+ * newapp.html's "reference data injection" step — it gives the AI agent full context
+ * about the current app state before generating modification commands.
+ *
+ * For each module, the query uses --md (markdown) format for token efficiency.
+ */
+export declare function registerSnapshotCommand(parent: Command): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/commands/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAqD7D"}

package/dist/commands/snapshot.js

@@ -0,0 +1,61 @@
+import { execCommand } from '../exec.js';
+/**
+ * Snapshot Command — Aggregated App State Query
+ *
+ * Fetches the current state of ALL 6 modules (form, scale, connect, report, expert, share)
+ * in a single command, returning a unified JSON snapshot. This is the equivalent of
+ * newapp.html's "reference data injection" step — it gives the AI agent full context
+ * about the current app state before generating modification commands.
+ *
+ * For each module, the query uses --md (markdown) format for token efficiency.
+ */
+export function registerSnapshotCommand(parent) {
+    parent
+        .command('snapshot')
+        .description('Get aggregated snapshot of ALL app modules (form + scale + connect + report + expert + share) — one call, full context')
+        .requiredOption('--app <appId>', 'App ID')
+        .option('--module <name>', 'Get only a specific module: form / scale / connect / report / expert / share (default: all)')
+        .action(async (opts) => {
+        const modules = opts.module
+            ? [opts.module]
+            : ['form', 'scale', 'connect', 'report', 'expert', 'share'];
+        const commands = {
+            form: `assess form query --app ${opts.app} --json`,
+            scale: `assess scale query --app ${opts.app} --md`,
+            connect: `assess connect query --app ${opts.app} --md`,
+            report: `assess report query --app ${opts.app} --md`,
+            expert: `assess expert query --app ${opts.app} --md`,
+            share: `assess share query --app ${opts.app} --json`,
+        };
+        // Execute requested modules in parallel
+        const entries = modules.filter((m) => commands[m]);
+        const results = await Promise.all(entries.map((m) => execCommand(commands[m]).then((r) => [m, r])));
+        const snapshot = { appId: opts.app };
+        const errors = [];
+        for (const [module, result] of results) {
+            if (result.code === 0) {
+                // Try to parse as JSON for structured modules, keep raw text for md modules
+                if (module === 'form' || module === 'share') {
+                    try {
+                        snapshot[module] = JSON.parse(result.data);
+                    }
+                    catch {
+                        snapshot[module] = result.data || result.message;
+                    }
+                }
+                else {
+                    snapshot[module] = result.data || result.message;
+                }
+            }
+            else {
+                snapshot[module] = null;
+                errors.push(`${module}: ${result.message}`);
+            }
+        }
+        if (errors.length > 0) {
+            snapshot['_errors'] = errors;
+        }
+        console.log(JSON.stringify(snapshot, null, 2));
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/commands/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAe;IACrD,MAAM;SACH,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,wHAAwH,CAAC;SACrI,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC;SACzC,MAAM,CAAC,iBAAiB,EAAE,6FAA6F,CAAC;SACxH,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM;YACzB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACf,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAA2B;YACvC,IAAI,EAAE,2BAA2B,IAAI,CAAC,GAAG,SAAS;YAClD,KAAK,EAAE,4BAA4B,IAAI,CAAC,GAAG,OAAO;YAClD,OAAO,EAAE,8BAA8B,IAAI,CAAC,GAAG,OAAO;YACtD,MAAM,EAAE,6BAA6B,IAAI,CAAC,GAAG,OAAO;YACpD,MAAM,EAAE,6BAA6B,IAAI,CAAC,GAAG,OAAO;YACpD,KAAK,EAAE,4BAA4B,IAAI,CAAC,GAAG,SAAS;SACrD,CAAC;QAEF,wCAAwC;QACxC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAU,CAAC,CAAC,CAC1E,CAAC;QAEF,MAAM,QAAQ,GAA4B,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,4EAA4E;gBAC5E,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC5C,IAAI,CAAC;wBACH,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC7C,CAAC;oBAAC,MAAM,CAAC;wBACP,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC;oBACnD,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;QAC/B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/exec.d.ts

@@ -5,9 +5,15 @@ export interface ExecResult {
 }
 /**
  * POST /api/v1/mcp/exec
- * Send CLI command to server for execution
+ * Send CLI command to server for execution.
+ *
+ * @param cmd         Full CLI command string (e.g. "assess form add --app xxx ...")
+ * @param profileName Optional profile name override
+ * @param timeoutMs   Request timeout in milliseconds.
+ *                    Default: 60_000 (60s) for most commands.
+ *                    Smart pipeline commands (assess smart create/modify) should use 300_000 (5min).
  */
-export declare function execCommand(cmd: string, profileName?: string): Promise<ExecResult>;
+export declare function execCommand(cmd: string, profileName?: string, timeoutMs?: number): Promise<ExecResult>;
 /**
  * POST /api/v1/mcp/auth/login
  */

package/dist/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;CACX;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CxF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsCpF;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCtE"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;CACX;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,UAAU,CAAC,CAgErB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsCpF;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCtE"}