@akanjs/cli 3.0.0-alpha.11 → 3.0.0-alpha.110

package/index-3d9y066c.js

@@ -0,0 +1,76 @@
+// @bun
+// pkgs/@akanjs/devkit/libSource.ts
+class LibSource {
+  static manifestKey = "akan";
+  static unhashedDirs = ["env"];
+  #lib;
+  constructor(lib) {
+    this.#lib = lib;
+  }
+  get #prefix() {
+    return `libs/${this.#lib.name}/`;
+  }
+  #isHashed(file) {
+    const relative = file.slice(this.#prefix.length);
+    return !LibSource.unhashedDirs.includes(relative.split("/")[0] ?? "");
+  }
+  async#hashableContent(file) {
+    const content = await this.#lib.workspace.readFile(file);
+    if (file !== `${this.#prefix}package.json`)
+      return content;
+    const manifest = JSON.parse(content);
+    delete manifest[LibSource.manifestKey];
+    return JSON.stringify(manifest);
+  }
+  async computeHash() {
+    const files = (await this.#lib.workspace.listGitFiles([`libs/${this.#lib.name}`], { untracked: true })).filter((file) => this.#isHashed(file));
+    const hasher = new Bun.CryptoHasher("sha256");
+    for (const file of files) {
+      hasher.update(file);
+      hasher.update("\x00");
+      hasher.update(await this.#hashableContent(file));
+      hasher.update("\x00");
+    }
+    return hasher.digest("hex").slice(0, 32);
+  }
+  async read() {
+    const manifest = await this.#lib.getPackageJson();
+    const akan = manifest[LibSource.manifestKey];
+    return akan?.source ?? null;
+  }
+  async write({ origin, sha }) {
+    const [manifest, hash] = await Promise.all([this.#lib.getPackageJson(), this.computeHash()]);
+    const akan = manifest[LibSource.manifestKey] ?? {};
+    const stamp = { origin, sha, hash, syncedAt: new Date().toISOString() };
+    await this.#lib.setPackageJson({ ...manifest, [LibSource.manifestKey]: { ...akan, source: stamp } });
+    return stamp;
+  }
+  async syncStamp({ origin, sha }) {
+    const [current, hash] = await Promise.all([this.read(), this.computeHash()]);
+    if (current?.origin === origin && current.sha === sha && current.hash === hash)
+      return { stamp: current, changed: false };
+    return { stamp: await this.write({ origin, sha }), changed: true };
+  }
+  async status() {
+    const [stamp, hash] = await Promise.all([this.read(), this.computeHash()]);
+    const drift = !stamp ? "unstamped" : stamp.hash === hash ? "clean" : "drifted";
+    return { lib: this.#lib.name, drift, stamp, hash };
+  }
+}
+function formatLibStatuses(statuses) {
+  const marks = { clean: "clean    ", drifted: "DRIFTED  ", unstamped: "unstamped" };
+  const sections = [
+    "Akan Library Source Status",
+    "",
+    ...statuses.map((status) => {
+      const origin = status.stamp ? `${status.stamp.origin}@${status.stamp.sha}` : "no akan.source in package.json";
+      return `  ${marks[status.drift]} libs/${status.lib}  ${origin}`;
+    }),
+    "",
+    `drifted: ${statuses.filter((status) => status.drift === "drifted").length} / ${statuses.length}`
+  ];
+  return sections.join(`
+`);
+}
+
+export { LibSource, formatLibStatuses };

package/{index-76rn3g2c.js → index-47pj3aee.js}

@@ -37,10 +37,10 @@ var resolveMobileTargets = async (app, selection) => {
   if (!selection && targets.length === 1)
     return targets;
   if (!selection) {
-    const choices2 = await getMobileTargetChoices(app);
-    if (choices2.length === 1)
-      return resolveMobileTargets(app, choices2[0]);
-    throw new Error(`Multiple mobile targets found for ${app.name}. Pass --target <${choices2.join("|")}|all>.`);
+    const choices = await getMobileTargetChoices(app);
+    if (choices.length === 1)
+      return resolveMobileTargets(app, choices[0]);
+    throw new Error(`Multiple mobile targets found for ${app.name}. Pass --target <${choices.join("|")}|all>.`);
   }
   if (selection === "all") {
     if (Object.keys(config.mobile.targets).length > 1)

package/{index-m90fn8xe.js → index-4edzf1gr.js}

@@ -1,48 +1,48 @@
 // @bun
 import {
-  ModuleScript
-} from "./index-mewacxye.js";
+  script
+} from "./index-mak3cd28.js";
+import {
+  AppExecutor,
+  LibExecutor,
+  ModuleExecutor
+} from "./index-2tv3fdx4.js";
 import {
-  addFieldUiPolicyForType,
-  coerceFieldDefault,
   compactDiagnostics,
   createPrimitiveWriteReport,
+  sourceFile,
+  moduleComponentName,
+  moduleSourcePaths,
+  generatedFilesForSync,
+  validationCommandsForTarget,
+  nextActionsForTarget,
+  lowerlize,
+  normalizeFieldType,
   ensureBaseTypeImport,
-  ensureConstantTypeImport,
-  ensureEnumImport,
+  coerceFieldDefault,
   fieldExpression,
-  generatedFilesForSync,
-  hasClassMethod,
+  viaBuilderParameterName,
+  insertIntoObject,
+  insertLightProjectionField,
+  insertTemplateField,
+  ensureEnumImport,
+  insertEnumClass,
+  insertDictionaryModelField,
   hasConstantInputField,
   hasDictionaryModelField,
-  hasSignalFactoryEntry,
+  ensureConstantTypeImport,
+  insertDictionaryEnum,
+  parseValues,
   hasSourceParseErrors,
+  hasClassMethod,
   insertClassMethod,
-  insertDictionaryEnum,
-  insertDictionaryModelField,
-  insertEnumClass,
-  insertIntoObject,
-  insertLightProjectionField,
+  hasSignalFactoryEntry,
   insertSignalFactoryEntry,
-  insertTemplateField,
-  lowerlize,
-  moduleComponentName,
-  moduleSourcePaths,
-  nextActionsForTarget,
-  normalizeFieldType,
-  parseValues,
-  sourceFile,
-  validationCommandsForTarget,
-  viaBuilderParameterName
-} from "./index-kcsa1zff.js";
+  addFieldUiPolicyForType
+} from "./index-gyd220p2.js";
 import {
-  script
-} from "./index-etwh7sd3.js";
-import {
-  AppExecutor,
-  LibExecutor,
-  ModuleExecutor
-} from "./index-yzsxc30b.js";
+  ModuleScript
+} from "./index-8pm30m73.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-3789fdpg.js → index-600zhnve.js}

@@ -1,54 +1,54 @@
 // @bun
 import {
-  RepairRunner
-} from "./index-yzmqvg23.js";
-import {
-  WorkflowRunner
-} from "./index-cv9cxs5k.js";
-import {
-  ScalarScript
-} from "./index-4mgkgba3.js";
-import {
-  PrimitiveScript
-} from "./index-m90fn8xe.js";
-import {
-  ModuleScript
-} from "./index-mewacxye.js";
+  AppExecutor
+} from "./index-2tv3fdx4.js";
 import {
-  isPlaceholderAppId
-} from "./index-9va8zayb.js";
+  jsonText,
+  createWorkflowBaselineSummary,
+  buildAkanModuleContextIndex,
+  createWorkflowStepRegistry,
+  toolingRolloutGate
+} from "./index-gyd220p2.js";
 import {
-  AkanContextAnalyzer,
-  akanMcpInstallConfigPaths,
-  akanMcpInstallTargets,
+  buildResourceList,
   codexMcpConfigPath,
-  createAkanCodexMcpServerBlock,
+  akanMcpInstallTargets,
+  akanMcpInstallConfigPaths,
   createAkanMcpServer,
+  createAkanCodexMcpServerBlock,
+  upsertCodexMcpServerBlock,
   renderDoctorText,
-  resourceList,
-  upsertCodexMcpServerBlock
-} from "./index-e4b2ae6b.js";
+  AkanContextAnalyzer
+} from "./index-ktb5njgy.js";
 import {
-  buildAkanModuleContextIndex,
-  createWorkflowBaselineSummary,
-  createWorkflowStepRegistry,
-  jsonText,
-  toolingRolloutGate
-} from "./index-kcsa1zff.js";
+  CommandContainer,
+  runner,
+  script
+} from "./index-mak3cd28.js";
+import {
+  isPlaceholderAppId2
+} from "./index-wt7qrtd4.js";
 import {
   Prompter
-} from "./index-j37qq1f2.js";
+} from "./index-h7yw2z9n.js";
 import {
-  getMobileTargets
-} from "./index-76rn3g2c.js";
+  RepairRunner
+} from "./index-fz5q3gd7.js";
 import {
-  CommandContainer,
-  runner,
-  script
-} from "./index-etwh7sd3.js";
+  WorkflowRunner
+} from "./index-7737gxcp.js";
 import {
-  AppExecutor
-} from "./index-yzsxc30b.js";
+  ModuleScript
+} from "./index-8pm30m73.js";
+import {
+  PrimitiveScript
+} from "./index-4edzf1gr.js";
+import {
+  ScalarScript
+} from "./index-rwg2aa4f.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 () => {

package/{index-1577bej2.js → index-6wwzs1bc.js}

@@ -2,6 +2,6 @@
 // pkgs/@akanjs/devkit/getDirname.ts
 import path from "path";
 import { fileURLToPath } from "url";
-var getDirname = (url) => path.dirname(fileURLToPath(url));
+var getDirname2 = (url) => path.dirname(fileURLToPath(url));
 
-export { getDirname };
+export { getDirname2 };

package/{index-cv9cxs5k.js → index-7737gxcp.js}

@@ -1,32 +1,32 @@
 // @bun
 import {
-  AkanContextAnalyzer
-} from "./index-e4b2ae6b.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-kcsa1zff.js";
+  renderWorkflowRunArtifact
+} from "./index-gyd220p2.js";
+import {
+  AkanContextAnalyzer
+} from "./index-ktb5njgy.js";
 import {
   runner
-} from "./index-etwh7sd3.js";
+} from "./index-mak3cd28.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-a5cs7d8r.js → index-8few9nyh.js}

@@ -1,24 +1,24 @@
 // @bun
 import {
-  CloudRunner
-} from "./index-nwqqssnb.js";
+  GlobalConfig,
+  CloudApi,
+  AiSession
+} from "./index-kn1h7p1x.js";
 import {
-  PackageScript
-} from "./index-h5whaj26.js";
+  PkgExecutor
+} from "./index-2tv3fdx4.js";
 import {
-  AiSession,
-  CloudApi,
-  GlobalConfig
-} from "./index-0cj2zxbm.js";
+  script
+} from "./index-mak3cd28.js";
 import {
   ApplicationScript
-} from "./index-bzznxgcx.js";
+} from "./index-v0qh106m.js";
 import {
-  script
-} from "./index-etwh7sd3.js";
+  PackageScript
+} from "./index-ws5e0j51.js";
 import {
-  PkgExecutor
-} from "./index-yzsxc30b.js";
+  CloudRunner
+} from "./index-aj7tyh5w.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";