@akanjs/cli 3.0.0-alpha.1 → 3.0.0-alpha.100

package/{index-2q1f5j9k.js → index-srdssqj7.js}

@@ -1,32 +1,32 @@
 // @bun
 import {
-  AkanContextAnalyzer
-} from "./index-a00jg8x8.js";
-import {
-  WorkflowExecutor,
-  compactWorkflowInputs,
-  createDryRunWorkflowApplyReport,
+  jsonText,
+  workflowPlanApproval,
   createWorkflowApplyReport,
+  workflowCommandsForPlan,
+  writeWorkflowRunArtifact,
+  readWorkflowRunArtifact,
   createWorkflowBaselineSummary,
-  createWorkflowPlan,
   createWorkflowValidationRunReport,
-  getWorkflowSpec,
-  jsonText,
+  createDryRunWorkflowApplyReport,
+  WorkflowExecutor,
   listWorkflowSpecs,
-  readWorkflowRunArtifact,
-  renderWorkflowApply,
-  renderWorkflowExplain,
+  getWorkflowSpec,
+  compactWorkflowInputs,
+  createWorkflowPlan,
   renderWorkflowList,
+  renderWorkflowExplain,
   renderWorkflowPlan,
-  renderWorkflowRunArtifact,
+  renderWorkflowApply,
   renderWorkflowValidation,
-  workflowCommandsForPlan,
-  workflowPlanApproval,
-  writeWorkflowRunArtifact
-} from "./index-rzwcpcc3.js";
+  renderWorkflowRunArtifact
+} from "./index-fc1bh0a7.js";
+import {
+  AkanContextAnalyzer
+} from "./index-gtmz74tj.js";
 import {
   runner
-} from "./index-8hsbnyes.js";
+} from "./index-znynzt5w.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-rh16j3c7.js → index-w8kmx1b6.js}

@@ -1,4 +1,8 @@
 // @bun
+import {
+  FileSys
+} from "./index-q0y2jq9j.js";
+
 // pkgs/@akanjs/devkit/frontendBuild/clientEntryDiscovery.ts
 import path3 from "path";
 
@@ -349,7 +353,7 @@ var resolveNodePackageExport = async (workspaceRoot, specifier) => {
     const subpath = specifier === packageName ? "." : `.${specifier.slice(packageName.length)}`;
     const exported = resolvePackageExport(pkgJson.exports, subpath);
     const rel = exported ?? (subpath === "." ? pkgJson.module ?? pkgJson.main ?? "index.js" : null);
-    if (!rel || !rel.startsWith("."))
+    if (!rel?.startsWith("."))
       return null;
     const entryFile = await resolveFileCandidate(path2.resolve(pkgDir, rel));
     if (!entryFile)
@@ -849,6 +853,7 @@ class ClientEntriesBundler {
   #externalSubpaths;
   #externalAliases;
   #command;
+  #target;
   #outputSubdir;
   #reactFastRefresh;
   #artifactDir;
@@ -870,6 +875,7 @@ class ClientEntriesBundler {
     this.#externalSubpaths = options.externalSubpaths ?? [];
     this.#externalAliases = options.externalAliases ?? {};
     this.#command = options.command ?? "start";
+    this.#target = options.target ?? "browser";
     this.#outputSubdir = options.outputSubdir ?? "client";
     this.#reactFastRefresh = options.reactFastRefresh ?? false;
     this.#artifactDir = `${this.#command === "build" ? this.#app.dist.cwdPath : this.#app.cwdPath}/.akan/artifact`;
@@ -883,7 +889,7 @@ class ClientEntriesBundler {
       entrypoints: this.#opaqueEntries.entries,
       outdir: this.#outdir,
       splitting: true,
-      target: "browser",
+      target: this.#target,
       format: "esm",
       naming: CLIENT_BUNDLE_NAMING,
       metafile: true,
@@ -1117,7 +1123,8 @@ var VENDOR_SPECIFIERS = [
   "akanjs/store",
   "akanjs/base",
   "akanjs/common",
-  "akanjs/constant"
+  "akanjs/constant",
+  "akanjs/fetch"
 ];
 
 // pkgs/@akanjs/devkit/frontendBuild/routeClientBuilder.ts
@@ -1143,16 +1150,17 @@ class RouteClientBuilder {
   #knownEntries;
   #command;
   #discovery;
+  #entries;
   constructor(options) {
     this.#app = options.app;
     this.#seeds = options.seeds;
     this.#knownEntries = options.knownEntries ?? new Set;
     this.#command = options.command ?? "start";
     this.#discovery = options.discovery;
+    this.#entries = options.entries;
   }
   async build() {
-    const discovery = this.#discovery ?? await GraphClientEntryDiscovery.create(this.#app);
-    const discovered = await discovery.discover(this.#seeds);
+    const discovered = this.#entries ?? await (this.#discovery ?? await GraphClientEntryDiscovery.create(this.#app)).discover(this.#seeds);
     const entries = discovered.filter((e) => !this.#knownEntries.has(e));
     if (entries.length === 0)
       return this.#emptyResult(discovered);
@@ -1225,12 +1233,11 @@ class RouteClientBuilder {
     }).bundle();
   }
   async#buildSsrBundle(bootstrapEntries) {
-    const externalOptions = RouteClientBuilder.resolveSsrClientExternalOptions(this.#command);
     return new ClientEntriesBundler({
       app: this.#app,
       entries: bootstrapEntries.buildEntries,
       plugins: [await createBarrelImportsPlugin(this.#app)],
-      ...externalOptions,
+      ...RouteClientBuilder.resolveSsrClientBundleOptions(this.#command),
       outputSubdir: "client-ssr",
       command: this.#command
     }).bundle();
@@ -1292,15 +1299,16 @@ ${defaultNames.map((name) => `export default ${name};`).join(`
     const serverEntry = RouteClientBuilder.resolveAkanServerEntry();
     return { [Bun.resolveSync("akanjs/fetch", serverEntry)]: "akanjs/fetch" };
   }
-  static resolveSsrClientExternalOptions(command) {
+  static resolveSsrClientBundleOptions(command) {
     if (command === "start") {
       return {
+        target: "bun",
         external: SSR_CLIENT_EXTERNALS,
         externalSubpaths: ["akanjs/fetch"],
         externalAliases: RouteClientBuilder.resolveSsrClientRuntimeAliases()
       };
     }
-    return { external: SSR_CLIENT_ALIAS_EXTERNALS };
+    return { target: "bun", external: SSR_CLIENT_ALIAS_EXTERNALS };
   }
   static resolveAkanServerEntry() {
     try {
@@ -1336,7 +1344,7 @@ ${defaultNames.map((name) => `export default ${name};`).join(`
 }
 
 // pkgs/@akanjs/devkit/frontendBuild/autoImportSync.ts
-import { readdir, readFile, stat, writeFile } from "fs/promises";
+import { readdir, readFile, stat } from "fs/promises";
 import path7 from "path";
 import ts2 from "typescript";
 var TEST_FILE_RE = /\.(test|spec)\.(ts|tsx)$/;
@@ -1514,6 +1522,8 @@ class AutoImportSync {
     const [scope, project, facet] = parts;
     if (scope !== "apps" && scope !== "libs" || !project || !facet)
       return null;
+    if (facet === "lib" && parts[3] === "__lib")
+      return null;
     const role = roleFor(facet, base);
     if (!role)
       return null;
@@ -1528,7 +1538,7 @@ class AutoImportSync {
     const next = transformSource(source, abs, ctx, resolveExtra);
     if (next === null || next === source)
       return false;
-    await writeFile(abs, next);
+    await FileSys.writeTextAtomic(abs, next);
     return true;
   }
   async#extraResolverFor(abs, ctx) {
@@ -2009,7 +2019,7 @@ class DevChangePlanner {
 var uniqueResolved = (files) => [...new Set(files.map((file) => path8.resolve(file)))].sort();
 
 // pkgs/@akanjs/devkit/frontendBuild/devGeneratedIndexSync.ts
-import { mkdir as mkdir2, readdir as readdir2, readFile as readFile2, rm, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir2, readdir as readdir2, readFile as readFile2, rm, stat as stat2 } from "fs/promises";
 import path9 from "path";
 var BARREL_FACETS2 = new Set(["common", "srvkit", "ui", "webkit", "plugin"]);
 var FACET_SOURCE_FILE_RE = /\.(ts|tsx)$/;
@@ -2101,7 +2111,7 @@ class DevGeneratedIndexSync {
     if (current === content)
       return false;
     await mkdir2(dir, { recursive: true });
-    await writeFile2(indexPath, content);
+    await FileSys.writeTextAtomic(indexPath, content);
     return true;
   }
   async#contentForIndex(indexPath) {

package/{index-nm6wghb6.js → index-yks023mb.js}

@@ -1,24 +1,24 @@
 // @bun
 import {
-  CloudRunner
-} from "./index-zasydjxd.js";
+  GlobalConfig,
+  CloudApi,
+  AiSession
+} from "./index-c69j78kk.js";
 import {
-  PackageScript
-} from "./index-k95xkh4p.js";
+  PkgExecutor
+} from "./index-qsq3q8fy.js";
 import {
-  AiSession,
-  CloudApi,
-  GlobalConfig
-} from "./index-0cj2zxbm.js";
+  script
+} from "./index-znynzt5w.js";
 import {
   ApplicationScript
-} from "./index-e16gnn26.js";
+} from "./index-zz5jyd94.js";
 import {
-  script
-} from "./index-8hsbnyes.js";
+  PackageScript
+} from "./index-7d6vny25.js";
 import {
-  PkgExecutor
-} from "./index-hgna5rjy.js";
+  CloudRunner
+} from "./index-zxgr3s8s.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-1pvex4az.js → index-yza7zkpt.js}

@@ -1,54 +1,54 @@
 // @bun
 import {
-  RepairRunner
-} from "./index-mr5s7mqd.js";
-import {
-  WorkflowRunner
-} from "./index-2q1f5j9k.js";
-import {
-  PrimitiveScript
-} from "./index-bekddz9q.js";
-import {
-  ModuleScript
-} from "./index-yzmhasdb.js";
-import {
-  ScalarScript
-} from "./index-ec09pws3.js";
+  AppExecutor
+} from "./index-qsq3q8fy.js";
 import {
-  isPlaceholderAppId
-} from "./index-t3723f99.js";
+  jsonText,
+  createWorkflowBaselineSummary,
+  buildAkanModuleContextIndex,
+  createWorkflowStepRegistry,
+  toolingRolloutGate
+} from "./index-fc1bh0a7.js";
 import {
-  AkanContextAnalyzer,
-  akanMcpInstallConfigPaths,
-  akanMcpInstallTargets,
+  buildResourceList,
   codexMcpConfigPath,
-  createAkanCodexMcpServerBlock,
+  akanMcpInstallTargets,
+  akanMcpInstallConfigPaths,
   createAkanMcpServer,
+  createAkanCodexMcpServerBlock,
+  upsertCodexMcpServerBlock,
   renderDoctorText,
-  resourceList,
-  upsertCodexMcpServerBlock
-} from "./index-a00jg8x8.js";
+  AkanContextAnalyzer
+} from "./index-gtmz74tj.js";
 import {
-  buildAkanModuleContextIndex,
-  createWorkflowBaselineSummary,
-  createWorkflowStepRegistry,
-  jsonText,
-  toolingRolloutGate
-} from "./index-rzwcpcc3.js";
+  CommandContainer,
+  runner,
+  script
+} from "./index-znynzt5w.js";
+import {
+  isPlaceholderAppId2
+} from "./index-1yxtbmbj.js";
 import {
   Prompter
-} from "./index-tdbas9r0.js";
+} from "./index-h7yw2z9n.js";
 import {
-  getMobileTargets
-} from "./index-76rn3g2c.js";
+  RepairRunner
+} from "./index-0amdxycf.js";
 import {
-  CommandContainer,
-  runner,
-  script
-} from "./index-8hsbnyes.js";
+  WorkflowRunner
+} from "./index-srdssqj7.js";
 import {
-  AppExecutor
-} from "./index-hgna5rjy.js";
+  ModuleScript
+} from "./index-zmjppp25.js";
+import {
+  PrimitiveScript
+} from "./index-qkk27bk6.js";
+import {
+  ScalarScript
+} from "./index-8p8p0cf8.js";
+import {
+  getMobileTargets
+} from "./index-47pj3aee.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";
@@ -380,12 +380,15 @@ var applyMcpTools = [
     }
   }
 ];
-var listAkanMcpTools = (mode = "readonly") => {
-  if (mode === "readonly")
-    return readonlyMcpTools;
-  if (mode === "plan")
-    return [...readonlyMcpTools, ...planMcpTools];
-  return [...readonlyMcpTools, ...planMcpTools, ...applyMcpTools];
+var listAkanMcpTools = (mode = "readonly", { guidelineNames = [] } = {}) => {
+  const tools = mode === "readonly" ? readonlyMcpTools : mode === "plan" ? [...readonlyMcpTools, ...planMcpTools] : [...readonlyMcpTools, ...planMcpTools, ...applyMcpTools];
+  if (guidelineNames.length === 0)
+    return tools;
+  return tools.map((tool) => tool.name === "get_guideline" ? {
+    ...tool,
+    description: `${tool.description ?? ""} One of: ${guidelineNames.join(", ")}.`.trim(),
+    inputSchema: { ...tool.inputSchema, properties: { name: { type: "string", enum: [...guidelineNames] } } }
+  } : tool);
 };
 var createAkanValidationContract = (listTools = listAkanMcpTools) => ({
   schemaVersion: 1,
@@ -604,6 +607,10 @@ var createCliWorkflowStepRegistry = (workspace) => createWorkflowStepRegistry({
 });
 
 // pkgs/@akanjs/cli/context/context.runner.ts
+var toolErrorText = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.replace(/\/(?:[^\s"'/]+\/)*(?=(?:pkgs|apps|libs|infra)\/)/g, "<workspace>/");
+};
 var workflowDiagnosticFromContext = (diagnostic) => ({
   severity: diagnostic.severity,
   code: diagnostic.code,
@@ -662,7 +669,7 @@ class ContextRunner extends runner("context") {
       if (!config.hasMobileConfig)
         continue;
       for (const { name, config: target } of await getMobileTargets(app)) {
-        if (!isPlaceholderAppId(target.appId))
+        if (!isPlaceholderAppId2(target.appId))
           continue;
         diagnostics.push({
           severity: "warning",
@@ -720,8 +727,8 @@ class ContextRunner extends runner("context") {
     await workspace.writeFile(codexMcpConfigPath, merged);
     return codexMcpConfigPath;
   }
-  listMcpTools(mode = "readonly") {
-    return listAkanMcpTools(mode);
+  listMcpTools(mode = "readonly", { guidelineNames = [] } = {}) {
+    return listAkanMcpTools(mode, { guidelineNames });
   }
   async callMcpTool(workspace, name, args = {}, { mode = "readonly" } = {}) {
     const availableTools = this.listMcpTools(mode);
@@ -776,7 +783,7 @@ class ContextRunner extends runner("context") {
     if (name === "explain_command")
       return this.explainCommand(stringArg(args, "command"));
     if (name === "get_validation_contract")
-      return createAkanValidationContract((mode2) => this.listMcpTools(mode2));
+      return createAkanValidationContract((mode) => this.listMcpTools(mode));
     if (name === "list_workflows")
       return parseJsonOutput(new WorkflowRunner().list({ format: "json" }));
     if (name === "explain_workflow")
@@ -851,17 +858,20 @@ class ContextRunner extends runner("context") {
 ${payload}`);
     };
     const respond = (id, result, framing) => {
-      writeMessage({ jsonrpc: "2.0", id, result }, framing);
+      writeMessage({ jsonrpc: "2.0", id: id ?? null, result }, framing);
     };
     const respondError = (id, code, message, framing) => {
-      writeMessage({ jsonrpc: "2.0", id, error: { code, message } }, framing);
+      writeMessage({ jsonrpc: "2.0", id: id ?? null, error: { code, message } }, framing);
     };
+    const guidelineNames = await Prompter.listGuidelines();
+    const resources = buildResourceList(guidelineNames);
     const readResource = async (uri) => {
-      const context = await AkanContextAnalyzer.analyze(workspace);
-      if (uri === "akan://docs/framework" || uri === "akan://guidelines/framework")
+      if (uri === "akan://docs/framework")
         return { uri, mimeType: "text/markdown", text: await Prompter.getInstruction("framework") };
-      if (uri === "akan://guidelines/modelSignal")
-        return { uri, mimeType: "text/markdown", text: await Prompter.getInstruction("modelSignal") };
+      const guideline = /^akan:\/\/guidelines\/(.+)$/.exec(uri)?.[1];
+      if (guideline)
+        return { uri, mimeType: "text/markdown", text: await Prompter.getInstruction(guideline) };
+      const context = await AkanContextAnalyzer.analyze(workspace);
       if (uri === "akan://workspace/summary")
         return { uri, mimeType: "application/json", text: jsonText(context, { trailingNewline: false }) };
       if (uri === "akan://workspace/apps")
@@ -883,7 +893,7 @@ ${payload}`);
       }
       throw new Error(`Unknown resource: ${uri}`);
     };
-    const handle = async (request, framing) => {
+    const handleRequest = async (request, framing) => {
       const params = request.params ?? {};
       if (request.method === "initialize") {
         respond(request.id, {
@@ -893,7 +903,7 @@ ${payload}`);
         }, framing);
       } else if (request.method === "tools/list") {
         respond(request.id, {
-          tools: this.listMcpTools(mode)
+          tools: this.listMcpTools(mode, { guidelineNames })
         }, framing);
       } else if (request.method === "tools/call") {
         const name = params.name;
@@ -909,16 +919,39 @@ ${payload}`);
             ]
           }, framing);
         } catch (error) {
-          respondError(request.id, -32602, error instanceof Error ? error.message : String(error), framing);
+          respond(request.id, { content: [{ type: "text", text: toolErrorText(error) }], isError: true }, framing);
         }
       } else if (request.method === "resources/list") {
-        respond(request.id, { resources: resourceList }, framing);
+        respond(request.id, { resources }, framing);
       } else if (request.method === "resources/read") {
         respond(request.id, { contents: [await readResource(params.uri)] }, framing);
-      } else if (!request.method.endsWith("/initialized")) {
+      } else {
         respondError(request.id, -32601, `Unknown method: ${request.method}`, framing);
       }
     };
+    const handle = async (request, framing) => {
+      if (request.id === undefined || request.id === null)
+        return;
+      try {
+        await handleRequest(request, framing);
+      } catch (error) {
+        respondError(request.id, -32603, error instanceof Error ? error.message : String(error), framing);
+      }
+    };
+    const handleFrame = async (payload, framing) => {
+      let request;
+      try {
+        request = JSON.parse(payload);
+      } catch (error) {
+        respondError(null, -32700, error instanceof Error ? error.message : String(error), framing);
+        return;
+      }
+      if (!request || typeof request !== "object" || typeof request.method !== "string") {
+        respondError(null, -32600, "Invalid Request: expected a JSON-RPC 2.0 object with a method", framing);
+        return;
+      }
+      await handle(request, framing);
+    };
     const parseContentLengthMessage = async () => {
       const headerEnd = buffer.indexOf(`\r
 \r
@@ -938,7 +971,7 @@ ${payload}`);
         return false;
       const body = buffer.slice(bodyStart, bodyEnd);
       buffer = buffer.slice(bodyEnd);
-      await handle(JSON.parse(body), "content-length");
+      await handleFrame(body, "content-length");
       return true;
     };
     const parseLineMessage = async () => {
@@ -950,7 +983,7 @@ ${payload}`);
       buffer = buffer.slice(lineEnd + 1);
       if (!line)
         return true;
-      await handle(JSON.parse(line), "newline");
+      await handleFrame(line, "newline");
       return true;
     };
     const parse = async () => {