@nseng-ai/areg 0.1.1

package/package.json

@@ -0,0 +1,29 @@
+{
+	"name": "@nseng-ai/areg",
+	"version": "0.1.1",
+	"type": "module",
+	"files": [
+		"src"
+	],
+	"engines": {
+		"node": ">=24.12.0",
+		"pnpm": ">=11.8.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"bin": {
+		"areg": "src/cli.ts"
+	},
+	"exports": {
+		".": "./src/index.ts"
+	},
+	"dependencies": {
+		"@nseng-ai/capability-kit": "0.1.1",
+		"@nseng-ai/clinkr": "0.1.1",
+		"@nseng-ai/command-backed-skill-registry": "0.1.1",
+		"@nseng-ai/foundation": "0.1.1",
+		"smol-toml": "^1.6.1",
+		"zod": "^4.4.3"
+	}
+}

package/src/cli.ts

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+
+import { ClinkrGroup } from "@nseng-ai/clinkr";
+import { defineCli, type CliEntrypointDeps } from "@nseng-ai/foundation/cli-runtime";
+
+import { createRealAregContext, type AregCliContext } from "./context.ts";
+import {
+	doctorSkillsRequestSchema,
+	doctorSkillsResultSchema,
+	runDoctorSkills,
+} from "./operations/doctor-skills.ts";
+import { renderDoctorSkills } from "./operations/doctor-skills-report.ts";
+import {
+	checkRequestSchema,
+	checkResultSchema,
+	renderCheck,
+	runCheck,
+} from "./operations/check.ts";
+import { initRequestSchema, initResultSchema, renderInit, runInit } from "./operations/init.ts";
+import { buildSkillGroup } from "./operations/skill-kind.ts";
+import { buildSkillxGroup } from "./operations/skillx.ts";
+import {
+	renderUpdateSkills,
+	runUpdateSkills,
+	updateSkillsRequestSchema,
+	updateSkillsResultSchema,
+} from "./operations/update-skills.ts";
+
+export interface CliDeps extends Pick<CliEntrypointDeps, "cwd" | "env" | "stdout" | "stderr"> {
+	context?: AregCliContext;
+	interaction?: AregCliContext["interaction"];
+}
+
+const entry = defineCli<AregCliContext, CliDeps, undefined>({
+	metaUrl: import.meta.url,
+	runtime: "typescript",
+	description: "Manage ns agent registry projects.",
+	prepareRun: ({ deps, cwd, env }) => {
+		const context = deps.context ?? createRealAregContext({ cwd, env });
+		const runContext: AregCliContext = {
+			...context,
+			cwd,
+			env: deps.env ?? context.env,
+			interaction: deps.interaction ?? context.interaction,
+		};
+		return { type: "run", context: runContext, buildState: undefined };
+	},
+	configureCli: ({ root }) => {
+		root.command({
+			name: "init",
+			description: "Initialize an existing Git project for areg skill workflows.",
+			schema: initRequestSchema,
+			positionals: { target: { position: 0 } },
+			options: { yes: { short: "-y" } },
+			resultSchema: initResultSchema,
+			handler: runInit,
+			renderHuman: renderInit,
+		});
+		root.command({
+			name: "check",
+			description: "Check that skills follow areg conventions.",
+			schema: checkRequestSchema,
+			resultSchema: checkResultSchema,
+			handler: runCheck,
+			renderHuman: renderCheck,
+		});
+		root.command({
+			name: "update-skills",
+			description: "Refresh GitHub-sourced skills recorded in skills-lock.json.",
+			schema: updateSkillsRequestSchema,
+			resultSchema: updateSkillsResultSchema,
+			handler: runUpdateSkills,
+			renderHuman: renderUpdateSkills,
+		});
+		const doctorGroup = new ClinkrGroup<AregCliContext>({
+			name: "doctor",
+			description: "Diagnose areg project drift.",
+		});
+		doctorGroup.command({
+			name: "skills",
+			description: "Diagnose skill registry, Pi inventory, and replacement-command drift.",
+			schema: doctorSkillsRequestSchema,
+			resultSchema: doctorSkillsResultSchema,
+			handler: runDoctorSkills,
+			renderHuman: renderDoctorSkills,
+		});
+		root.group(doctorGroup);
+		root.group(buildSkillGroup());
+		const execGroup = new ClinkrGroup<AregCliContext>({
+			name: "exec",
+			description: "Commands for use by skills (not interactive users).",
+			isHidden: true,
+		});
+		execGroup.group(buildSkillxGroup());
+		root.group(execGroup);
+	},
+});
+
+export const VERSION = entry.version;
+
+export function buildCli(): ClinkrGroup<AregCliContext> {
+	return entry.buildCli(undefined);
+}
+
+export async function runCli(args: readonly string[], deps: CliDeps = {}): Promise<number> {
+	return await entry.run(args, deps);
+}
+
+await entry.runIfMain({ isImportMetaMain: import.meta.main });

package/src/context.ts

@@ -0,0 +1,59 @@
+import { resolveClinkrInteraction, type ClinkrInteraction } from "@nseng-ai/clinkr";
+import { NodeCommandExecApi } from "@nseng-ai/foundation/exec";
+import { RealGitGateway } from "@nseng-ai/capability-kit/git";
+import type { GitGateway } from "@nseng-ai/capability-kit/git";
+import { readStdinLine } from "@nseng-ai/foundation/cli-runtime";
+
+import type {
+	AregGithubGateway,
+	AregHostGateway,
+	AregNpxSkillsGateway,
+	AregProjectGateway,
+	AregPromptGateway,
+	AregSkillxWorkspaceGateway,
+} from "./gateways.ts";
+import {
+	RealAregGithubGateway,
+	RealAregHostGateway,
+	RealAregNpxSkillsGateway,
+	RealAregProjectGateway,
+	RealAregPromptGateway,
+	RealAregSkillxWorkspaceGateway,
+} from "./real-gateways.ts";
+
+export interface AregCliContext {
+	host: AregHostGateway;
+	github: AregGithubGateway;
+	skillxWorkspace: AregSkillxWorkspaceGateway;
+	project: AregProjectGateway;
+	git: GitGateway;
+	npxSkills: AregNpxSkillsGateway;
+	prompt: AregPromptGateway;
+	interaction: ClinkrInteraction;
+	cwd: string;
+	env: NodeJS.ProcessEnv;
+}
+
+export function createRealAregContext(
+	options: { cwd?: string; env?: NodeJS.ProcessEnv } = {},
+): AregCliContext {
+	const cwd = options.cwd ?? process.cwd();
+	const env = options.env ?? process.env;
+	const npxSkills = new RealAregNpxSkillsGateway();
+	const git = new RealGitGateway(new NodeCommandExecApi());
+	return {
+		host: new RealAregHostGateway(),
+		github: new RealAregGithubGateway(),
+		skillxWorkspace: new RealAregSkillxWorkspaceGateway({ npxSkills }),
+		project: new RealAregProjectGateway({ git }),
+		git,
+		npxSkills,
+		prompt: new RealAregPromptGateway(),
+		interaction: resolveClinkrInteraction({
+			stdin: readStdinLine,
+			stderr: (text) => process.stderr.write(text),
+		}),
+		cwd,
+		env,
+	};
+}