@method-ai-hq/sdk 0.17.0 → 0.17.1

package/README.md

@@ -3,7 +3,7 @@
 MIT-licensed JavaScript API and the `method` CLI. Source and releases: https://github.com/method-ai-hq/method-sdk
 
 ```sh
-npm install https://github.com/method-ai-hq/method-sdk/releases/download/v0.17.0/method-ai-hq-sdk-0.17.0.tgz
+npm install https://github.com/method-ai-hq/method-sdk/releases/download/v0.17.1/method-ai-hq-sdk-0.17.1.tgz
 npx method --version
 ```
 

package/dist/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@method-ai-hq/sdk",
-    "version": "0.17.0",
+    "version": "0.17.1",
     "description": "Build and run reusable .method files with checked steps and saved results.",
     "license": "MIT",
     "type": "module",

package/dist/packages/sdk/src/improve.d.ts

@@ -3,7 +3,6 @@ import { type MethodClient } from './method-client.js';
 export type ImproveRequest = {
     step_id?: string;
     note?: string;
-    case_id?: string;
     run_id?: string;
 };
 /** Runs a local Method file; the default is the runtime that `method run FILE` uses. */
@@ -21,10 +20,10 @@ export type ImproveProposal = {
         [key: string]: unknown;
     };
 };
-type ProposalKind = 'change' | 'case' | 'rubric' | 'script' | 'none';
+type ProposalKind = 'change' | 'none';
 /**
  * Read the result of improve.method: {proposal: <SubmitProposal as JSON text>, kind, proposal_id}. A change has the
- * proposed workflow; a case or rubric fix has case_suggestion; a script change has script_change; none has neither.
+ * tested workflow; none has no workflow.
  */
 export declare function readImproveResult(result: unknown): ImproveProposal;
 export declare const judgmentsLine = "Method fixes this Method from your judgments. Record the person's reaction: method judge RUN_ID wrong --note \"...\".";

package/dist/packages/sdk/src/improve.js

@@ -11,10 +11,10 @@ import { methodCache } from './prepare.js';
 import { writePrivateJson } from './files.js';
 import { currentVersion, methodContent } from './versions.js';
 import { localRuns, saveLocalProposal } from './proposals.js';
-const kinds = ['change', 'case', 'rubric', 'script', 'none'];
+const kinds = ['change', 'none'];
 /**
  * Read the result of improve.method: {proposal: <SubmitProposal as JSON text>, kind, proposal_id}. A change has the
- * proposed workflow; a case or rubric fix has case_suggestion; a script change has script_change; none has neither.
+ * tested workflow; none has no workflow.
  */
 export function readImproveResult(result) {
     const value = result;
@@ -36,18 +36,11 @@ export function readImproveResult(result) {
         throw Error(`The improvement run says kind ${String(value.kind)}, but its proposal is kind ${evidence.kind}.`);
     if (evidence.kind === 'change' && (!proposal.workflow || typeof proposal.workflow !== 'object'))
         throw Error('The improvement proposal is a change without a workflow.');
-    if ((evidence.kind === 'case' || evidence.kind === 'rubric') && !evidence.case_suggestion)
-        throw Error(`The improvement proposal is a ${evidence.kind} fix without case_suggestion.`);
-    if (evidence.kind === 'script' && !evidence.script_change)
-        throw Error('The improvement proposal is a script change without script_change.');
     return { cause: proposal.cause.trim(), workflow: evidence.kind === 'change' ? proposal.workflow : null, evidence };
 }
 const nextStep = (file, id, kind) => ({
-    change: `Read the proposal, then run method apply ${file} ${id}. It does not publish.`,
-    case: `Run method apply ${file} ${id} to see the case to record.`,
-    rubric: `Run method apply ${file} ${id} to see the case rubric to fix.`,
-    script: `Run method apply ${file} ${id} to see the script change.`,
-    none: 'No safe change was found.',
+    change: `Read the change, then run method apply ${file} ${id}. It does not publish.`,
+    none: 'No change passed the tests.',
 })[kind];
 const print = (value) => process.stdout.write(JSON.stringify(value, null, 2) + '\n');
 export const judgmentsLine = 'Method fixes this Method from your judgments. Record the person\'s reaction: method judge RUN_ID wrong --note "...".';
@@ -58,17 +51,15 @@ export const judgmentsLine = 'Method fixes this Method from your judgments. Reco
  * and saves a local proposal.
  */
 export async function improveCommand(args, clientFactory, run) {
-    const { values, positionals } = parseArgs({ args, allowPositionals: true, options: { case: { type: 'string' }, note: { type: 'string' }, step: { type: 'string' }, server: { type: 'string' } } });
+    const { values, positionals } = parseArgs({ args, allowPositionals: true, options: { note: { type: 'string' }, step: { type: 'string' }, server: { type: 'string' } } });
     if (positionals.length !== 1)
-        throw Error('Use method improve FILE [--case ID] [--note TEXT] [--step ID].');
+        throw Error('Use method improve FILE [--note TEXT] [--step ID].');
     const file = authoringPath(positionals[0]), document = readDocument(file), workflow = loadWorkflow(methodContent(document));
     if (values.step && !Object.hasOwn(workflow.steps, values.step))
         throw Error(`Step ${values.step} is not in ${positionals[0]}.`);
-    if (values.case && !/^[a-z0-9][a-z0-9-]{0,79}$/.test(values.case))
-        throw Error('Use a case ID: lowercase letters, digits, and hyphens.');
     if (values.note !== undefined && !values.note.trim())
         throw Error('Write the correction after --note.');
-    const request = { ...(values.step ? { step_id: values.step } : {}), ...(values.note ? { note: values.note.trim() } : {}), ...(values.case ? { case_id: values.case } : {}) };
+    const request = { ...(values.step ? { step_id: values.step } : {}), ...(values.note ? { note: values.note.trim() } : {}) };
     const client = clientFactory(values.server ?? DEFAULT_SERVER);
     if (!client.token())
         await client.login();
@@ -119,7 +110,7 @@ export async function improveOnDevice(client, file, request, run) {
     const improve = await cachedImproveMethod(client);
     const runDir = join(methodCache(), 'runs', randomUUID());
     const inputs = join(runDir, 'improve-inputs.json');
-    writePrivateJson(inputs, { method_file: file, case_id: request.case_id ?? '', note: request.note ?? '', step_id: request.step_id ?? '', grant_id: '', run_id: request.run_id ?? '', make_case: false });
+    writePrivateJson(inputs, { method_file: file, note: request.note ?? '', step_id: request.step_id ?? '', grant_id: '', judgment_id: '', run_id: request.run_id ?? '' });
     const runFile = run ?? (await import('./current-runtime.js')).runCurrentFile;
     process.stderr.write(`Improving ${file} on this computer. Its run content stays here.\n`);
     // The run prints its own result; send it to stderr so that stdout holds only the proposal.

package/dist/packages/sdk/src/method-help.js

@@ -38,7 +38,7 @@ export const commandHelp = {
     publish: { usage: "method publish FILE [--reason TEXT] [--accept-failing-case ID[,ID]] [--cloud|--workers] [--env NAME] [--server URL]", purpose: "Mark a version as published, for sharing, schedules, and production runs.", arguments: "Runs the Method's cases first; a version that breaks an approved case is refused unless --accept-failing-case names it, and the version records that. Uses the version of the file's current content: it finishes that upload (no time limit while bytes move), checks the cases, then marks it published with the reason (default: Published.). --accept-failing-case needs --reason. The first save of a new file creates the Method. --cloud runs the production runs of the environment on Method Cloud; --workers runs them on your workers again. --env NAME selects the environment (default production).", result: "JSON with workflow_id, version_id, url, published_at, the cases line, and the open warnings and notes (issues). With --cloud or --workers: placement. Warnings and notes never block a publish.", errors: "An error issue (nothing is published), failing case, --accept-failing-case without --reason, or no network.", example: "method publish task.method --reason 'Shorter introduction'", remote: true },
     judge: { usage: "method judge RUN_ID right|wrong [--step STEP_ID] [--note TEXT] [--corrected FILE] [--json] [--server URL]", purpose: "Record the person's reaction to a run's result.", arguments: "RUN_ID is the run_id of the run's start line, or the run ID on the dashboard. right: the person used or approved the result. wrong: the person corrected it, or asked to change the Method because of it. --note: the person's words (at most 4000 characters). --corrected FILE: the result that the person says is right; JSON is sent as JSON, other text as text (at most 1 MB). --step: the step whose output was wrong. A wrong judgment makes Method fix the Method in the background: it applies a tested change that the person can undo, or changes nothing. Do not ask the person to confirm a judgment.", result: "One line, for example Recorded: wrong on step choose. Method is fixing it in the background. --json prints the judgment and fixing.", errors: "An unknown run, a run of a Method that is not in your account, or no sign-in.", example: "method judge 6f1c… wrong --step summary --note 'Name the customer in the first sentence.'", remote: true },
     changes: { usage: "method changes FILE [--json] [--server URL]", purpose: "List the changes that Method applied to a Method.", arguments: "Lists the changes that Method made from wrong judgments, newest first, and the local proposals applied on this computer. Commands that take a signed-in FILE merge a new change into the file first and print one line.", result: "One line per change: its date, its version, and its cause. --json prints {file, method_id, changes: [{id, source, cause, date, version_id, steps}]}. No changes.", errors: "No id: line and no local change.", example: "method changes task.method", remote: true },
-    improve: { usage: "method improve FILE [--case ID] [--note TEXT] [--step ID] [--server URL]", purpose: "Improve a Method that keeps its run content on this computer.", arguments: "For a Method with run_data: device, or in an organization that keeps run content on devices: runs Method's improvement on this computer, so the run content stays here. --note: the correction, in the person's words; it is about the newest run of the Method on this computer, which the improvement reads and a suggested case records. --step: improve only this step. --case: the case the change must pass. For a Method that keeps run content in the account, it starts nothing and says to use method judge: Method fixes those Methods from the person's judgments.", result: "JSON with the local proposal ID and the next step; the proposal is in .method/proposals/. Nothing is published, and the file does not change. For an account Method, one line.", errors: "An unknown step, or a step of the improvement that fails.", example: "method improve task.method --step summary --note 'Name the customer in the first sentence.'", remote: true },
+    improve: { usage: "method improve FILE [--note TEXT] [--step ID] [--server URL]", purpose: "Improve a Method that keeps its run content on this computer.", arguments: "For a Method with run_data: device, or in an organization that keeps run content on devices: runs Method's improvement on this computer, so the run content stays here. --note: the correction, in the person's words; it is about the newest run of the Method on this computer, which the improvement reads. --step: improve only this step. For a Method that keeps run content in the account, it starts nothing and says to use method judge: Method fixes those Methods from the person's judgments.", result: "JSON with the local proposal ID and the next step; the proposal is in .method/proposals/. Nothing is published, and the file does not change. For an account Method, one line.", errors: "An unknown step, or a step of the improvement that fails.", example: "method improve task.method --step summary --note 'Name the customer in the first sentence.'", remote: true },
     apply: { usage: "method apply FILE [PROPOSAL_ID] [--resolved] [--server URL]", purpose: "Merge a local proposal from method improve into the file.", arguments: "Default: the newest open local proposal. The merge is per step: a part that only the proposal changed takes the change; a part that you and the proposal both changed is a conflict. --resolved: you merged a conflict by hand; this marks the proposal applied. When a change that Method applied conflicts with your edits, the line before the command names it; give its ID to see both versions.", result: "JSON with status applied and the changed steps; the file changes and the proposal is marked applied. Nothing is published. A conflict lists each part with the base, your, and the proposed value, changes nothing, and exits 1.", errors: "No open proposal, or a conflict.", example: "method apply task.method", remote: true },
     secret: { usage: "method secret find [FILE]\nmethod secret import FILE NAME...\nmethod secret set NAME\nmethod secret list [NAME...]", purpose: "Give this computer the values of a Method's declared secrets.", arguments: "find lists the KEY=VALUE files in this folder (3 levels down) and in the parent folder (2 levels down) with the key names in each, never values; for the Method FILE (or the only Method here) it says which declared secrets each file holds and prints the import command. import copies the named values from a KEY=VALUE file that the user names, without printing them. set opens a private form on 127.0.0.1 in the browser for one value. list shows names and where each value is found (shell, this computer, or missing), never values. Values are kept in ~/.config/method/secrets.json (mode 0600) and are never sent to Method. A value exported in the shell is used first. Every script of the Method receives all of its declared secrets.", result: "JSON with the saved names, or the list.", errors: "A name is missing from the file, or no value was entered.", example: "method secret find\nmethod secret import ../service/.env ARCHIVE_TOKEN" },
     connect: { usage: "method connect [APP_FOLDER] [--file METHOD_FILE]", purpose: "Connect an app to the Method in this folder, so the app runs it in production.", arguments: "Run it in the Method's folder. APP_FOLDER (default: this folder) is the app's folder. It makes a service key named after the app folder and writes METHOD_API_KEY to the app's .env (a new file, or a new or replaced line); it never prints the key. It adds .env to .gitignore in a git repository. When the Method has no published version, it publishes the current file. It detects Node (package.json) or Python (pyproject.toml, requirements.txt), and prints the install line and the code to add. Run it again: an app with a working key keeps it.", result: "JSON with the method_id, the published version, where the key is, install, code, secrets_to_set_on_the_host, and next.", errors: "No or several .method files (give --file), an app folder with no language marker, or a failing case at publish.", example: "method connect ../app", remote: true },

package/dist/packages/sdk/src/proposals.js

@@ -184,17 +184,6 @@ export async function localRuns(file) {
     }
     return runs;
 }
-/** What the coding agent does for a proposal that is not a change to the Method document. runFolder is the folder of the suggested case's run, when it is on this computer. */
-function manualStep(file, proposal, runFolder) {
-    const evidence = proposal.evidence ?? {};
-    if (evidence.case_suggestion) {
-        const c = evidence.case_suggestion, quote = (value) => JSON.stringify(value);
-        return `Record the case: method case new ${file} --id ${c.id} --note ${quote(c.note)} --run ${runFolder ? quote(runFolder) : 'RUN_FOLDER'}${(c.rubric ?? []).map((r) => ` --rubric ${quote(r)}`).join('')}${runFolder ? '' : ', where RUN_FOLDER is the folder of the run that went wrong'}. Then run method improve ${file} --case ${c.id}, show the proposal, apply it, and run again.`;
-    }
-    if (evidence.script_change)
-        return `Change the script, then run method test ${file}: ${evidence.script_change}`;
-    return 'This proposal has no change to apply.';
-}
 const print = (value) => process.stdout.write(JSON.stringify(value, null, 2) + '\n');
 const changeLine = (change) => `${change.date.slice(0, 10)}  ${change.version_id ?? 'not saved as a version'}  ${change.cause}`;
 /** `method changes FILE`: the changes that Method applied to the Method, newest first, and those applied on this computer. */
@@ -246,13 +235,8 @@ export async function proposalCommand(args, clientFactory) {
         throw Error(`Proposal ${proposal.id} is ${proposal.status}.`);
     if (values.resolved)
         return print({ status: 'applied', file, proposal_id: proposal.id, ...await markApplied(client, file, proposal), next: `Run method test ${target}. Publish it when it is right.` });
-    if (!proposal.proposed_workflow) {
-        // The suggested case's run is a local folder (a local improvement) or an account run ID (an account improvement).
-        const runId = proposal.evidence?.case_suggestion?.run_id;
-        const runFolder = runId ? (await localRuns(file)).find(run => run.dir === runId || run.account_run_id === runId)?.dir : undefined;
-        process.exitCode = 1;
-        return print({ status: 'manual', file, proposal_id: proposal.id, kind: proposal.evidence?.kind ?? null, cause: proposal.cause, next: manualStep(target, proposal, runFolder) });
-    }
+    if (!proposal.proposed_workflow)
+        return print({ status: 'none', file, proposal_id: proposal.id, cause: proposal.cause, next: 'No change passed the tests; there is nothing to apply.' });
     const result = await applyProposal(client, file, proposal);
     if (result.status === 'applied')
         return print({ ...result, file, proposal_id: proposal.id, cause: proposal.cause, next: `Run method test ${target}. Publish it when it is right.` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@method-ai-hq/sdk",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Build and run reusable .method files with checked steps and saved results.",
   "license": "MIT",
   "type": "module",