@nodeint/migent 0.1.2 → 0.1.4

package/README.md

@@ -17,9 +17,9 @@ where the process is.
   - [Supported CLIs](#supported-clis)
   - [Quickstart](#quickstart)
     - [Install](#install)
-    - [Upgrade](#upgrade)
     - [Create a project](#create-a-project)
     - [Run](#run)
+    - [Next](#next)
   - [Concepts](#concepts)
   - [Current scope](#current-scope)
   - [Documentation](#documentation)
@@ -69,59 +69,56 @@ ones your configuration names.
 
 ## Quickstart
 
-Node.js 22+ on macOS or Linux, and authenticated provider CLIs named by your
-configuration.
+Requires Node.js 22+ (macOS, Linux, or Windows) and the provider CLIs your
+config uses, already signed in.
 
 ### Install
 
 ```bash
 npm install -g @nodeint/migent
+migent --version
 ```
 
-Verify with `migent --version`.
-
-### Upgrade
-
-```bash
-npm install -g @nodeint/migent@latest
-```
+Upgrade with `npm install -g @nodeint/migent@latest`.
 
 ### Create a project
 
-From the project where agents will work:
+From the repository where agents will work:
 
 ```bash
-migent init --preset plan
+migent init
 ```
 
-`init` writes the config, a plan-and-review workflow, and a gitignore for local
-session state:
+In a terminal, `init` walks you through the provider, model, and options, then
+offers to install the Migent skill so agents in the project know how to run it.
+Without a terminal, pass `--provider` and `--model` together. Pass `--skill` to
+install the skill without the prompt.
+
+It creates:
 
 ```text
 .migent/
-├── config.yaml
-├── .gitignore
+├── config.yaml        # models and roles
+├── .gitignore         # keeps sessions/ untracked
 └── workflows/
-    └── plan.yaml
-```
+    └── plan.yaml      # plan-and-review workflow
 
-In a terminal, pick the provider, model, and prompted options from the lists.
-Pass `--provider` and `--model` together when input is not a terminal. Commit
-`config.yaml` and `workflows/`. Leave `.migent/sessions/` untracked.
+.agents/skills/migent/ # only if you install the skill
+```
 
-Model and role shape is in [Providers and model configuration](https://github.com/nodeint/migent/blob/main/docs/providers.md).
-A full plan workflow is in [Writing workflows](https://github.com/nodeint/migent/blob/main/docs/workflows.md#complete-example).
+Commit `config.yaml` and `workflows/`. To add the skill later, run
+`migent skill install`.
 
 ### Run
 
-From that project or any of its subdirectories:
+From the project or any subdirectory:
 
 ```bash
 migent start plan --task "Plan the account settings redesign"
 ```
 
-Migent runs the next eligible stage until the workflow completes or stops.
-Progress goes to stderr. Stdout is one JSON result.
+Migent runs each eligible stage until the workflow completes or stops. Progress
+goes to stderr; stdout is a single JSON result. Then inspect or resume:
 
 ```bash
 migent sessions
@@ -129,9 +126,12 @@ migent watch <session-id>
 migent continue <session-id>
 ```
 
-Command fields and exit codes are in
-[CLI commands and execution controls](https://github.com/nodeint/migent/blob/main/docs/cli.md). Session files are in
-[Sessions and workflow composition](https://github.com/nodeint/migent/blob/main/docs/sessions.md).
+### Next
+
+- [Providers and model configuration](https://github.com/nodeint/migent/blob/main/docs/providers.md)
+- [Writing workflows](https://github.com/nodeint/migent/blob/main/docs/workflows.md#complete-example)
+- [CLI commands and exit codes](https://github.com/nodeint/migent/blob/main/docs/cli.md)
+- [Sessions and workflow composition](https://github.com/nodeint/migent/blob/main/docs/sessions.md)
 
 ## Concepts
 
@@ -185,22 +185,8 @@ pnpm test
 pnpm migent --help   # run the local build
 ```
 
-### Releasing
-
-All four packages share one version. Bump it, commit, and push a matching tag:
-
-```bash
-pnpm -r exec npm pkg set version=0.2.0
-pnpm install
-git commit -am "Release 0.2.0"
-git tag v0.2.0
-git push origin main v0.2.0
-```
-
-The tag runs `.github/workflows/release.yml`, which builds, tests, packs, and
-stages each package through npm trusted publishing. Nothing goes live until a
-maintainer approves the staged versions on npmjs.com (Staged Packages tab) or
-with `npm stage approve`, kernel first and `@nodeint/migent` last.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for testing rules, platform notes, and
+the release process.
 
 ## License
 

package/dist/commands/init.d.ts

@@ -18,6 +18,7 @@ export declare function runInit(workspace: string, options?: {
     model?: string | null;
     options?: readonly string[];
     preset?: string;
+    skill?: boolean;
     interactive?: boolean;
     adapters?: Record<string, AgentAdapter> | null;
     which?: Which | null;

package/dist/commands/init.js

@@ -5,12 +5,14 @@ import { diagnose, whichSync, yamlScalar } from "@nodeint/migent-kernel";
 import { printAlreadyInitialized, printCreated, printError, printInitConflicts, } from "../display.js";
 import { cliHooks } from "../hooks.js";
 import { runDoctor } from "./doctor.js";
+import { installSkill } from "./skill.js";
 import { acceptedOptions, adapterMap, asCatalog, detected, knownModel, loadCatalog, loadOptionValues, parseOptions, requireAdapter, runProviderCommand, } from "../provider.js";
 export const PRESETS = ["implement", "plan"];
 export async function runInit(workspace, options = {}) {
     const provider = options.provider ?? null;
     const model = options.model ?? null;
     const preset = options.preset ?? "implement";
+    const skill = options.skill === true;
     const interactive = options.interactive ?? false;
     const chosen = options.adapters ?? adapterMap();
     const resolve = options.which ?? cliHooks.which ?? whichSync;
@@ -36,6 +38,8 @@ export async function runInit(workspace, options = {}) {
     const classified = classify(workspace, chosen, resolve);
     if (classified.state === "ready") {
         printAlreadyInitialized();
+        if (skill)
+            return installSkill(workspace);
         return 0;
     }
     if (classified.state === "conflict") {
@@ -43,14 +47,11 @@ export async function runInit(workspace, options = {}) {
         return 1;
     }
     let primary;
-    let reviewer;
     try {
-        [primary, reviewer] = await choices(chosen, resolve, prompt, {
+        primary = await choices(chosen, resolve, prompt, {
             provider,
             model,
             options: parseOptions(optionPairs),
-            preset,
-            interactive,
             runCommand: execute,
         });
     }
@@ -58,7 +59,19 @@ export async function runInit(workspace, options = {}) {
         printError(error instanceof Error ? error.message : String(error));
         return 2;
     }
-    const paths = writeProject(workspace, preset, primary, reviewer);
+    let install = skill;
+    if (!install && interactive) {
+        try {
+            install = await prompt.confirm("Install the Migent skill in .agents/skills/migent?");
+        }
+        catch (error) {
+            printError(error instanceof Error ? error.message : String(error));
+            return 2;
+        }
+    }
+    if (install && installSkill(workspace) !== 0)
+        return 1;
+    const paths = writeProject(workspace, preset, primary);
     printCreated(paths, `migent start ${preset} --task "..."`);
     return runDoctor(workspace, { which: resolve });
 }
@@ -87,19 +100,7 @@ async function choices(adapters, which, prompt, args) {
     if (model.trim() === "")
         throw new Error("Model is required.");
     const primary = { provider, model: model.trim(), options: stored };
-    if (args.preset !== "plan" || !args.interactive)
-        return [primary, null];
-    if (await prompt.confirm("Use the default model for both planner and reviewer?"))
-        return [primary, null];
-    const rows = detected(adapters, which);
-    const reviewerProvider = await prompt.selectProvider(rows, "Reviewer provider");
-    const reviewerAdapter = adapters[reviewerProvider];
-    if (reviewerAdapter === undefined)
-        throw new Error(`Unknown provider: ${reviewerProvider}.`);
-    const reviewerCatalog = await loadCatalog(reviewerAdapter, which, args.runCommand);
-    const reviewerModel = (await prompt.selectModel(reviewerProvider, reviewerCatalog, "Reviewer model")).trim();
-    const reviewerOptions = await promptOptions(reviewerAdapter, reviewerModel, reviewerCatalog, which, args.runCommand, prompt);
-    return [primary, { provider: reviewerProvider, model: reviewerModel, options: reviewerOptions }];
+    return primary;
 }
 function classify(workspace, adapters, which) {
     const root = path.join(workspace, ".migent");
@@ -133,27 +134,23 @@ function classify(workspace, adapters, which) {
     }
     return { state: "conflict", conflicts: owned };
 }
-function writeProject(workspace, preset, primary, reviewer) {
+function writeProject(workspace, preset, primary) {
     const root = path.join(workspace, ".migent");
     const workflows = path.join(root, "workflows");
     mkdirSync(workflows, { recursive: true });
-    writeFileSync(path.join(root, "config.yaml"), renderConfig(preset, primary, reviewer), "utf8");
+    writeFileSync(path.join(root, "config.yaml"), renderConfig(preset, primary), "utf8");
     const workflowName = `${preset}.yaml`;
     writeFileSync(path.join(workflows, workflowName), renderWorkflow(preset), "utf8");
     writeFileSync(path.join(root, ".gitignore"), "sessions/\n", "utf8");
     return [".migent/config.yaml", `.migent/workflows/${workflowName}`, ".migent/.gitignore"];
 }
-function renderConfig(preset, primary, reviewer) {
+function renderConfig(preset, primary) {
     const models = [["default", primary]];
     let roles;
     if (preset === "implement")
         roles = [["developer", "default"]];
-    else if (reviewer === null)
+    else
         roles = [["planner", "default"], ["reviewer", "default"]];
-    else {
-        models.push(["review", reviewer]);
-        roles = [["planner", "default"], ["reviewer", "review"]];
-    }
     const lines = ["schema_version: 1", "models:"];
     for (const [name, choice] of models) {
         lines.push(`  ${name}:`, `    provider: ${yamlScalar(choice.provider)}`, `    model: ${yamlScalar(choice.model)}`);

package/dist/program.js

@@ -120,6 +120,7 @@ export function createProgram(status) {
         .option("--model <model>", "Model id for the default model. Pass with --provider.")
         .option("--option <pair>", "KEY=VALUE stored under models.*.options.", collect, [])
         .option("--preset <preset>", "Workflow to create: implement or plan. Default: implement.", "implement")
+        .option("--skill", "Install the Migent skill at .agents/skills/migent.")
         .action((options) => settle(status, () => {
         const provider = optionalText(options.provider);
         const model = optionalText(options.model);
@@ -129,6 +130,7 @@ export function createProgram(status) {
             model,
             options: stringList(options.option),
             preset: typeof options.preset === "string" ? options.preset : "implement",
+            skill: options.skill === true,
             interactive,
         });
     }));

package/dist/provider.d.ts

@@ -1,5 +1,5 @@
 import { ModelCatalog } from "@nodeint/migent-adapters";
-import type { AgentAdapter, ProviderOption } from "@nodeint/migent-kernel";
+import { type AgentAdapter, type ProviderOption } from "@nodeint/migent-kernel";
 export interface CatalogAdapter extends AgentAdapter {
     modelCatalogCommand(): string[];
     parseModelCatalog(stdout: string): ModelCatalog;

package/dist/provider.js

@@ -1,5 +1,5 @@
-import { spawnSync } from "node:child_process";
 import { ModelCatalog, defaultAdapters } from "@nodeint/migent-adapters";
+import { spawnProviderSync } from "@nodeint/migent-kernel";
 export class ProviderCommandFailed extends Error {
 }
 export function adapterMap() {
@@ -124,7 +124,7 @@ export function runProviderCommand(argv) {
     const [command, ...args] = argv;
     if (command === undefined)
         throw new ProviderCommandFailed("Provider command is empty.");
-    const completed = spawnSync(command, args, { encoding: "utf8", timeout: 60_000 });
+    const completed = spawnProviderSync(command, args, { encoding: "utf8", timeout: 60_000, windowsHide: true });
     if (completed.error) {
         throw new Error(completed.error.message);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodeint/migent",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Compose AI coding agents into repeatable engineering workflows.",
   "keywords": [
     "ai",
@@ -38,18 +38,14 @@
   "engines": {
     "node": ">=22"
   },
-  "os": [
-    "darwin",
-    "linux"
-  ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
     "@clack/prompts": "^1.8.1",
-    "@nodeint/migent-adapters": "0.1.2",
-    "@nodeint/migent-kernel": "0.1.2",
-    "@nodeint/migent-registry": "0.1.2",
+    "@nodeint/migent-adapters": "0.1.4",
+    "@nodeint/migent-kernel": "0.1.4",
+    "@nodeint/migent-registry": "0.1.4",
     "commander": "^14.0.2",
     "picocolors": "^1.1.1"
   },