@sculptor/cli 0.2.2 → 0.3.0

package/dist/agents.js

@@ -0,0 +1,100 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadConfig } from "@sculptor/config";
+import { loadPackageRegistry } from "./package-registry.js";
+const cliVersion = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const safeLoadConfig = (rootDir) => {
+    try {
+        const config = loadConfig(rootDir);
+        return {
+            srcRoot: String(config.framework.project?.srcRoot ?? "src"),
+            routingStyle: String(config.framework.routing?.style ?? "decorator")
+        };
+    }
+    catch {
+        return {
+            srcRoot: "src",
+            routingStyle: "decorator"
+        };
+    }
+};
+const safeLoadPackages = (rootDir) => {
+    try {
+        return Object.values(loadPackageRegistry(rootDir).packages)
+            .map((record) => record.name)
+            .sort((left, right) => left.localeCompare(right));
+    }
+    catch {
+        return [];
+    }
+};
+const buildPackageList = (packages) => packages.length > 0 ? packages.map((name) => `- \`${name}\``).join("\n") : "- _none detected_";
+export const buildAgentsMarkdown = (rootDir) => {
+    const { srcRoot, routingStyle } = safeLoadConfig(rootDir);
+    const packages = safeLoadPackages(rootDir);
+    const version = cliVersion.version ?? "0.0.0";
+    return `# AGENTS.md
+
+Sculptor CLI \`v${version}\`
+
+## Working Rules
+
+- Exact package names only. Do not singularize or pluralize package identities.
+- Treat package index files as the package contract.
+- Update generated sections only when markers exist.
+- Keep runtime composition explicit and scanner-friendly.
+- Prefer warnings and diagnostics over silent mutation.
+
+## Package Architecture
+
+- Project src root: \`${srcRoot}\`
+- Routing style: \`${routingStyle}\`
+- Package registry artifact: \`sculptor.packages.json\`
+- Package index source of truth: \`index.ts\` inside each package
+- Generated markers: \`[sculptor:imports:start]\`, \`[sculptor:exports:start]\`, \`[sculptor:package:start]\`
+
+## DI Conventions
+
+- Use \`@Service()\`, \`@Repository()\`, \`@Middleware()\`, and \`@AutoInject()\`.
+- Injection is explicit only.
+- Constructor injection and property injection are both supported.
+- Avoid hidden autowiring or token guessing.
+
+## Registry Conventions
+
+- \`sc sync\` validates registry state and keeps \`sculptor.packages.json\` current.
+- \`sc ls\` and \`sc pkg\` should reflect exact stored package names.
+- \`sc doctor\` is the calm diagnostics entrypoint.
+- \`sc update\` only updates \`@sculptor/cli\`.
+
+## Generator Conventions
+
+- Generators must preserve manual code outside generated markers.
+- Package generation should use exact names and deterministic paths.
+- Use the configured src root unless an explicit \`in\` path is supplied.
+
+## Runtime Conventions
+
+- Keep global registry composition thin.
+- Flatten package composition internally.
+- Preserve compatibility with legacy flat registries during migration.
+
+## CLI Conventions
+
+- \`sc agents\` writes this file.
+- \`sc agents refresh\` regenerates this file.
+- \`sc doctor\` reports diagnostics without mutating the project.
+- \`sc update\` only manages the global CLI binary.
+
+## Detected Packages
+
+${buildPackageList(packages)}
+`;
+};
+export const writeAgentsMarkdown = (rootDir) => {
+    const filePath = path.join(rootDir, "AGENTS.md");
+    const content = buildAgentsMarkdown(rootDir);
+    fs.writeFileSync(filePath, `${content}\n`, "utf8");
+    return filePath;
+};
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAC3B,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC7C,CAAC;AAE1B,MAAM,cAAc,GAAG,CAAC,OAAe,EAA6C,EAAE;IACpF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;YAC3D,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,IAAI,WAAW,CAAC;SACrE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,WAAW;SAC1B,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAY,EAAE;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;aACxD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;aAC5B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,QAAkB,EAAU,EAAE,CACtD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAEjG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAU,EAAE;IAC7D,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC;IAE9C,OAAO;;kBAES,OAAO;;;;;;;;;;;;wBAYD,OAAO;qBACV,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC/B,gBAAgB,CAAC,QAAQ,CAAC;CAC3B,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAU,EAAE;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7C,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/cli.js

@@ -7,11 +7,47 @@ import { stdin, stdout } from "node:process";
 import { fileURLToPath } from "node:url";
 import { loadConfig } from "@sculptor/config";
 import { getConfigValue, listConfigEntries, setConfigValue } from "./config-commands.js";
-import { controllerHelp, generateHelp, generateResourceFiles, middlewareHelp, moduleHelp, parseGenerateMode, readModeFromFlags, routeHelp, scaffoldProject, syncTestHarness, typeHelp, writeGeneratedFiles } from "./scaffold.js";
+import { getPackageFlagValue, handleLsCommand, ensureRootRegistryForPackages, handlePackageCommand, handleRegisterCommand, handleSyncCommand, stripPackageFlag, validatePackageRegistryState } from "./package-commands.js";
+import { getOwningPackage, loadPackageRegistry, savePackageRegistry, syncPackageRegistry, updatePackageIndexForRecord, upsertFileIntoRegistry } from "./package-registry.js";
+import { writeAgentsMarkdown } from "./agents.js";
+import { detectPackageManager, globalInstallArgsFor } from "./package-manager.js";
+import { createDoctorReport, hasDoctorErrors, printDoctorReport } from "./diagnostics.js";
+import { controllerHelp, dtoHelp, generateHelp, generateResourceFiles, middlewareHelp, moduleHelp, parseGenerateMode, readModeFromFlags, routeHelp, scaffoldProject, syncTestHarness, repositoryHelp, typeHelp, writeGeneratedFiles } from "./scaffold.js";
 import { loadPluginModule, resolvePluginManifest } from "./plugins.js";
 const cliPackageVersion = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 const versionLabel = cliPackageVersion.version ?? "0.0.0";
-const isCommand = (value) => ["new", "start", "dev", "build", "lint", "test", "generate", "g", "help", "config", "add"].includes(value);
+const isCommand = (value) => [
+    "new",
+    "start",
+    "dev",
+    "build",
+    "lint",
+    "test",
+    "sync",
+    "install",
+    "i",
+    "update",
+    "generate",
+    "g",
+    "pkg",
+    "package",
+    "ls",
+    "list",
+    "reg",
+    "register",
+    "r",
+    "ureg",
+    "unreg",
+    "unregister",
+    "ur",
+    "rm",
+    "remove",
+    "help",
+    "config",
+    "add",
+    "agents",
+    "doctor"
+].includes(value);
 const isFlag = (value) => value.startsWith("-");
 const isVersionFlag = (value) => ["-v", "--v", "--version", "version", "v"].includes(value);
 const sculptorCliBanner = String.raw `
@@ -76,6 +112,26 @@ const requireAppRoot = (cwd, command) => {
     }
     return cwd;
 };
+const findAppRoot = (cwd) => {
+    let current = path.resolve(cwd);
+    for (;;) {
+        if (fs.existsSync(path.join(current, "sculptor.json"))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+};
+const requireOutsideAppRoot = (cwd, command) => {
+    const appRoot = findAppRoot(cwd);
+    if (appRoot) {
+        throw new Error(`${command} can only be run outside a Sculptor app root.`);
+    }
+    return cwd;
+};
 const extractOutputDir = (args) => {
     const index = args.findIndex((arg) => arg === "in");
     if (index < 0 || index === args.length - 1) {
@@ -97,6 +153,15 @@ const getFlagValue = (args, names) => {
     return undefined;
 };
 const getFlagPresence = (args, names) => names.some((name) => args.includes(name) || args.some((arg) => arg.startsWith(`${name}=`)));
+const resolveRegisteredPackagePath = (cwd, packageName) => {
+    const registry = loadPackageRegistry(cwd);
+    for (const record of Object.values(registry.packages)) {
+        if (record.name === packageName) {
+            return record.path;
+        }
+    }
+    return undefined;
+};
 const getPrompt = (prompt) => {
     if (prompt) {
         return prompt;
@@ -182,12 +247,31 @@ sc <command> [options]
 - \`sc build\`
 - \`sc lint\`
 - \`sc test\`
+- \`sc sync\`
+- \`sc ls\`
+- \`sc list\`
+- \`sc pkg\`
+- \`sc package\`
+- \`sc reg <file>\` / \`sc register <file>\` / \`sc r <file>\`
+- \`sc ureg <file>\` / \`sc unreg <file>\` / \`sc unregister <file>\` / \`sc ur <file>\`
+- \`sc rm <file>\` / \`sc remove <file>\`
+- \`sc install deps\`
+- \`sc update\`
+- \`sc doctor\`
 - \`sc generate\` or \`sc g\`
 - \`sc config <get|set|list>\`
 - \`sc add <plugin>\`
+- \`sc agents\`
+- \`sc agents refresh\`
 - \`sc help\`
   - \`sc help generate\`
   - \`sc help controller\`
+  - \`sc help repository\`
+  - \`sc help dto\`
+  - \`sc help pkg\`
+  - \`sc help package\`
+  - \`sc help ls\`
+  - \`sc help list\`
   - \`sc --version\` / \`sc -v\`
   - \`sc version\`
 
@@ -197,8 +281,12 @@ sc <command> [options]
 - \`service\` / \`s\`
 - \`module\` / \`m\` or \`mo\`
 - \`middleware\` / \`mw\`
+- \`repository\` / \`repo\`
+- \`dto\` / \`dto\`
 - \`type\` / \`t\`
 - \`route\` / \`r\`
+- \`pkg\`
+- \`package\`
 
 ## Binary Alias
 
@@ -226,6 +314,14 @@ const printHelp = (topic, log) => {
         log(middlewareHelp);
         return;
     }
+    if (topic === "repository") {
+        log(repositoryHelp);
+        return;
+    }
+    if (topic === "dto") {
+        log(dtoHelp);
+        return;
+    }
     if (topic === "type") {
         log(typeHelp);
         return;
@@ -238,10 +334,58 @@ const printHelp = (topic, log) => {
         log(`# Config\n\nUse \`sc config get\`, \`sc config set\`, or \`sc config list\`.`);
         return;
     }
+    if (topic === "sync") {
+        log(`# Sync\n\nUse \`sc sync\` to refresh \`sculptor.packages.json\`.`);
+        return;
+    }
+    if (topic === "pkg") {
+        log(`# Package\n\nUse \`sc pkg <name>\`, \`sc package <name>\`, \`sc pkg ls\`, or \`sc pkg rm <name>\`.\nPackage names are exact and are not normalized.`);
+        return;
+    }
+    if (topic === "package") {
+        log(`# Package\n\nUse \`sc pkg <name>\`, \`sc package <name>\`, \`sc pkg ls\`, or \`sc pkg rm <name>\`.\nPackage names are exact and are not normalized.`);
+        return;
+    }
+    if (topic === "ls") {
+        log(`# List\n\nUse \`sc ls\` or \`sc list\`, and \`sc ls -t\` for tree view.`);
+        return;
+    }
+    if (topic === "list") {
+        log(`# List\n\nUse \`sc ls\` or \`sc list\`, and \`sc ls -t\` for tree view.`);
+        return;
+    }
+    if (topic === "reg" || topic === "register" || topic === "r") {
+        log(`# Register\n\nUse \`sc reg <file>\`, \`sc register <file>\`, or \`sc r <file>\``);
+        return;
+    }
+    if (topic === "ureg" || topic === "unreg" || topic === "unregister" || topic === "ur") {
+        log(`# Unregister\n\nUse \`sc ureg <file>\`, \`sc unreg <file>\`, \`sc unregister <file>\`, or \`sc ur <file>\``);
+        return;
+    }
+    if (topic === "rm" || topic === "remove") {
+        log(`# Remove\n\nUse \`sc rm <file>\` or \`sc remove <file>\``);
+        return;
+    }
+    if (topic === "install") {
+        log(`# Install\n\nUsage: \`sc install deps\` or \`sc i deps\``);
+        return;
+    }
+    if (topic === "update") {
+        log(`# Update\n\nUsage: \`sc update\`\n\nUpdates the globally installed Sculptor CLI package.`);
+        return;
+    }
+    if (topic === "doctor") {
+        log(`# Doctor\n\nUsage: \`sc doctor\`\n\nRuns diagnostics for the current Sculptor project and package registry.`);
+        return;
+    }
     if (topic === "add") {
         log(`# Add\n\nUsage: \`sc add <plugin>\``);
         return;
     }
+    if (topic === "agents") {
+        log(`# Agents\n\nUsage: \`sc agents\` or \`sc agents refresh\`\n\nWrites \`AGENTS.md\` in the current directory.`);
+        return;
+    }
     printMainHelp(log);
 };
 const printVersion = (log) => {
@@ -311,16 +455,82 @@ const runSpawn = (command, args, cwd, spawn, log, env) => {
         process.exit(result.status);
     }
 };
+const installScaffoldDependencies = (cwd, spawn, log) => {
+    runSpawn("npm", ["i"], cwd, spawn, log);
+    runSpawn("npm", ["i", "@sculptor/core@latest", "@sculptor/paws@latest"], cwd, spawn, log);
+    runSpawn("npm", ["i", "-D", "@sculptor/cli@latest", "@sculptor/config@latest", "@sculptor/router@latest"], cwd, spawn, log);
+};
+const updateGlobalCliPackage = (cwd, spawn, log) => {
+    const packageManager = detectPackageManager();
+    runSpawn(packageManager, globalInstallArgsFor(packageManager, ["@sculptor/cli@latest"]), cwd, spawn, log);
+};
 const handleNew = async (args, cwd, prompt, spawn, log) => {
     printBanner(log, "SculptorTS CLI", `v${versionLabel}`);
     const metadata = await resolveProjectMetadata(args, cwd, prompt);
     const targetDir = path.join(cwd, metadata.appName);
-    scaffoldProject(metadata, targetDir);
-    runSpawn("npm", ["i"], targetDir, spawn, log);
-    runSpawn("npm", ["i", "@sculptor/core@latest", "@sculptor/paws@latest"], targetDir, spawn, log);
-    runSpawn("npm", ["i", "-D", "@sculptor/cli@latest", "@sculptor/config@latest", "@sculptor/router@latest"], targetDir, spawn, log);
+    const scaffolded = await scaffoldProject(metadata, targetDir, {
+        cwd,
+        prompt,
+        spawn,
+        log,
+        error: () => undefined
+    });
+    if (!scaffolded) {
+        return;
+    }
+    installScaffoldDependencies(targetDir, spawn, log);
     log(`Created SculptorTS project at ${targetDir}`);
 };
+const handleInstall = (args, cwd, spawn, log, error) => {
+    const [subcommand] = args;
+    if (!subcommand || subcommand === "help") {
+        log(`Usage: sc install deps`);
+        return;
+    }
+    if (subcommand !== "deps") {
+        error(`Unknown install subcommand "${subcommand}".`);
+        process.exit(1);
+    }
+    const appRoot = findAppRoot(cwd);
+    if (!appRoot) {
+        throw new Error("sc install deps can only be run from a Sculptor app root.");
+    }
+    installScaffoldDependencies(appRoot, spawn, log);
+    log(`Installed Sculptor dependencies at ${appRoot}`);
+};
+const handleUpdate = (cwd, spawn, log, error) => {
+    requireOutsideAppRoot(cwd, "sc update");
+    try {
+        updateGlobalCliPackage(cwd, spawn, log);
+        log("Updated the globally installed Sculptor CLI package.");
+    }
+    catch (caught) {
+        const message = caught instanceof Error ? caught.message : String(caught);
+        error(message);
+        process.exit(1);
+    }
+};
+const handleDoctor = (cwd, log, error) => {
+    const report = createDoctorReport(cwd);
+    printDoctorReport(report, log);
+    if (hasDoctorErrors(report)) {
+        error("Doctor found blocking issues.");
+        process.exit(1);
+    }
+};
+const handleAgents = (args, cwd, log, error) => {
+    const [subcommand] = args;
+    if (subcommand && subcommand !== "refresh" && subcommand !== "help") {
+        error(`Unknown agents subcommand "${subcommand}".`);
+        process.exit(1);
+    }
+    if (subcommand === "help") {
+        log(`# Agents\n\nUsage: \`sc agents\` or \`sc agents refresh\`\n\nWrites \`AGENTS.md\` in the current directory.`);
+        return;
+    }
+    const filePath = writeAgentsMarkdown(cwd);
+    log(`Wrote ${path.relative(cwd, filePath) || "AGENTS.md"}`);
+};
 const handleDev = (args, cwd, spawn, log) => {
     const appRoot = requireAppRoot(cwd, "sc dev");
     const devServer = resolveDefaultDevServer(cwd);
@@ -365,6 +575,19 @@ const handleStart = (args, cwd, spawn, log) => {
 const handleBuild = (cwd, spawn, log) => {
     const appRoot = requireAppRoot(cwd, "sc build");
     const appTsconfig = path.join(appRoot, "tsconfig.json");
+    try {
+        const report = validatePackageRegistryState(appRoot);
+        if (report.packageCountDetected > 0 || report.packageCountRegistered > 0 || report.messages.length > 0) {
+            log(`Packages detected: ${report.packageCountDetected}`);
+            log(`Packages registered: ${report.packageCountRegistered}`);
+            for (const message of report.messages) {
+                log(message);
+            }
+        }
+    }
+    catch (error) {
+        log(error instanceof Error ? error.message : String(error));
+    }
     runSpawn("npx", ["tsc", "-p", appTsconfig], appRoot, spawn, log);
 };
 const handleLint = (cwd, spawn, log) => {
@@ -427,10 +650,10 @@ const handleAdd = async (args, cwd, log, error) => {
     const manifest = resolvePluginManifest(module, pluginName);
     log(`Loaded plugin ${manifest.name} for ${appRoot}`);
 };
-const handleGenerate = (args, cwd, prompt, log, error) => {
+const handleGenerate = async (args, cwd, prompt, spawn, log, error) => {
     const [kindInput, ...restInput] = args;
     if (!kindInput) {
-        error("Usage: sc generate <controller|service|module|middleware|type|route> <name>");
+        error("Usage: sc generate <controller|service|repository|dto|module|middleware|type|route|pkg> <name>");
         process.exit(1);
     }
     const kindMap = {
@@ -438,25 +661,32 @@ const handleGenerate = (args, cwd, prompt, log, error) => {
         controller: "controller",
         s: "service",
         service: "service",
+        repo: "repository",
+        repository: "repository",
         m: "module",
         mo: "module",
         module: "module",
         mw: "middleware",
         middleware: "middleware",
+        dto: "dto",
         t: "type",
         type: "type",
         r: "route",
         route: "route",
-        resource: "route"
+        resource: "route",
+        pkg: "pkg",
+        package: "pkg"
     };
     const kind = kindMap[kindInput];
     if (!kind) {
         error(`Unknown generator "${kindInput}".`);
         process.exit(1);
     }
-    const { args: rest, outputDir } = extractOutputDir(restInput);
+    const { args: restAfterOutputDir, outputDir } = extractOutputDir(restInput);
+    const rest = stripPackageFlag(restAfterOutputDir);
     const positional = rest.filter((arg) => !isFlag(arg));
     const explicitName = positional[0];
+    const packageTarget = getPackageFlagValue(restAfterOutputDir);
     const fallbackMode = resolveDefaultMode(cwd);
     const devServer = resolveDefaultDevServer(cwd);
     const mode = parseGenerateMode(readModeFromFlags(rest, fallbackMode), fallbackMode);
@@ -475,6 +705,21 @@ const handleGenerate = (args, cwd, prompt, log, error) => {
         process.exit(1);
     }
     const appRoot = requireAppRoot(cwd, "sc generate");
+    const packagePath = packageTarget ? resolveRegisteredPackagePath(appRoot, packageTarget) : undefined;
+    if (packageTarget && !packagePath) {
+        error(`Package "${packageTarget}" is not registered.`);
+        process.exit(1);
+    }
+    const packageScopedOutput = packagePath !== undefined
+        ? (outputDir
+            ? path.posix.join(packagePath, outputDir)
+            : kind === "route"
+                ? path.posix.join(packagePath, "routes")
+                : packagePath)
+        : undefined;
+    const resolvedOutputDir = kind === "pkg"
+        ? outputDir ?? String(loadConfig(appRoot).framework.project?.srcRoot ?? "src")
+        : packageScopedOutput ?? outputDir;
     const resolvedName = explicitName ??
         (() => {
             if (!outputDir) {
@@ -483,14 +728,32 @@ const handleGenerate = (args, cwd, prompt, log, error) => {
             const parts = outputDir.split(/[\\/]/).filter(Boolean);
             return parts[parts.length - 1] ?? "index";
         })();
-    const files = generateResourceFiles(kind, resolvedName, mode, devServer, outputDir, typeVariant, functionalRoutes, resolveTestingGenerate(appRoot));
+    const files = await generateResourceFiles(kind, resolvedName, mode, devServer, resolvedOutputDir, typeVariant, functionalRoutes, resolveTestingGenerate(appRoot), { cwd, prompt, spawn, log, error });
     const targetDir = appRoot;
-    writeGeneratedFiles(targetDir, files);
+    if (!files) {
+        return;
+    }
+    await writeGeneratedFiles(targetDir, files, { cwd, prompt, spawn, log, error });
+    if (packagePath || kind === "pkg") {
+        const registry = syncPackageRegistry(appRoot);
+        for (const filePath of Object.keys(files)) {
+            upsertFileIntoRegistry(registry, filePath);
+            const owningPackage = getOwningPackage(registry, filePath);
+            if (owningPackage) {
+                updatePackageIndexForRecord(path.join(appRoot, owningPackage.index), owningPackage);
+            }
+        }
+        savePackageRegistry(appRoot, registry);
+    }
     if (resolveTestingGenerate(appRoot)) {
-        syncTestHarness(targetDir);
+        await syncTestHarness(targetDir, { cwd, prompt, spawn, log, error });
+    }
+    syncPackageRegistry(appRoot);
+    if (kind === "pkg") {
+        ensureRootRegistryForPackages(appRoot);
     }
     log(`Generated ${kind} "${resolvedName}" using ${mode} mode.`);
-    return Promise.resolve();
+    return;
 };
 export const runCli = async (argv = process.argv, options = {}) => {
     const cwd = options.cwd ?? process.cwd();
@@ -531,21 +794,60 @@ export const runCli = async (argv = process.argv, options = {}) => {
         case "build":
             handleBuild(cwd, spawn, log);
             return;
+        case "sync":
+            handleSyncCommand(args, { cwd, prompt, log, error });
+            return;
         case "lint":
             handleLint(cwd, spawn, log);
             return;
         case "test":
             handleTest(cwd, spawn, log);
             return;
+        case "install":
+        case "i":
+            handleInstall(args, cwd, spawn, log, error);
+            return;
+        case "update":
+            handleUpdate(cwd, spawn, log, error);
+            return;
+        case "doctor":
+            handleDoctor(cwd, log, error);
+            return;
         case "config":
             handleConfig(args, cwd, log, error);
             return;
         case "add":
             await handleAdd(args, cwd, log, error);
             return;
+        case "agents":
+            handleAgents(args, cwd, log, error);
+            return;
+        case "pkg":
+        case "package":
+            await handlePackageCommand(args, { cwd, prompt, log, error });
+            return;
+        case "ls":
+        case "list":
+            handleLsCommand(args, { cwd, prompt, log, error });
+            return;
+        case "reg":
+        case "register":
+        case "r":
+            await handleRegisterCommand("reg", args, { cwd, prompt, log, error });
+            return;
+        case "ureg":
+        case "unreg":
+        case "unregister":
+        case "ur":
+            await handleRegisterCommand("ureg", args, { cwd, prompt, log, error });
+            return;
+        case "rm":
+        case "remove":
+            await handleRegisterCommand("rm", args, { cwd, prompt, log, error });
+            return;
         case "generate":
         case "g":
-            await handleGenerate(args, cwd, prompt, log, error);
+            await handleGenerate(args, cwd, prompt, spawn, log, error);
             return;
     }
 };