@akanjs/cli 3.0.0-beta.17 → 3.0.0-beta.18

package/guidelines/transportRule/transportRule.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Transport Rule",
-  "description": "How a call reaches an Akan signal — guards across HTTP and websocket, socket identity and cleanup, binary pubsub frames, and mutation HTTP verbs",
-  "group": "core",
-  "codegenPriority": 4,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "example",
-      "description": "Guard classes and their scope markers",
-      "path": "{apps,libs}/*/srvkit/guards.ts",
-      "sample": 2
-    },
-    {
-      "type": "example",
-      "description": "Signal endpoints declaring guards, pubsub, and message handlers",
-      "path": "{apps,libs}/*/lib/*/*.signal.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./transportRule.instruction.md",
-    "contents": ["guards across transports", "signal body types", "binary pubsub", "mutation HTTP verbs"],
-    "rules": [
-      "Use current Akan APIs only",
-      "State the rule and the reason it exists, never restate a type signature",
-      "Say what leaks or breaks when a rule is ignored",
-      "Keep it workspace-neutral — no app or repo names"
-    ]
-  }
-}

package/guidelines/utilUiUsage/utilUiUsage.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Util UI Usage",
-  "description": "Utility UI usage rules",
-  "group": "core",
-  "docsSource": "apps/akan/page/(docs)/references/ui/core.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Util UI Usage",
-      "path": "apps/akan/page/(docs)/references/ui/core.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./utilUiUsage.instruction.md",
-    "contents": ["purpose", "file ownership", "current API patterns", "codegen rules", "validation checklist"],
-    "rules": [
-      "Use current Akan APIs only",
-      "Keep output parseable for codegen",
-      "Include ownership boundaries and review checklist"
-    ]
-  },
-  "page": "apps/akan/page/(docs)/references/ui/core.tsx"
-}

package/guidelines/utilUiUsage/utilUiUsage.instruction.md

@@ -1,25 +0,0 @@
-# Util UI Usage Guideline
-
-## Purpose
-Use utility UI components for common application interactions, layout helpers, scrolling, loading, and small display patterns.
-
-## Ownership
-- Utility UI is for cross-domain layout and interaction helpers.
-- Module-specific controls still belong in Model.Util.
-- Docs pages may use utility UI for scroll sections and navigation.
-
-## Current Akan Patterns
-- Prefer existing utility components before adding custom layout code.
-- Keep imported utility UI usage close to nearby docs and app examples.
-- Forward className and preserve composition.
-
-## Codegen Rules
-- Do not make utility UI carry model-specific business behavior.
-- Do not duplicate util components in each module.
-- Do not use utility components without checking expected props.
-
-## Review Checklist
-- The instruction points to current docs pages, not removed docs routes.
-- Generated examples use current Akan builder APIs and scanner-friendly filenames.
-- The output contract tells the model which file paths to return.
-- The guide avoids broad framework essays when a concrete file rule is better.

package/guidelines/workspaceOnboarding/workspaceOnboarding.generate.json

@@ -1,24 +0,0 @@
-{
-  "title": "Workspace Onboarding",
-  "description": "Product-workspace orientation — layout, decision matrix, workflow recipes, and query gotchas",
-  "group": "core",
-  "codegenPriority": 2,
-  "deprecated": false,
-  "scans": [],
-  "update": {
-    "filePath": "./workspaceOnboarding.instruction.md",
-    "contents": [
-      "workspace layout and generated files",
-      "agent workflow and common commands",
-      "where-do-I-put-this decision matrix",
-      "workflow recipes",
-      "modeling and query gotchas"
-    ],
-    "rules": [
-      "Use current Akan APIs only",
-      "Write for someone building a product on Akan, not for someone changing Akan",
-      "Refer to the app as <%= appName %>; the renderer substitutes the workspace's first app",
-      "Do not repeat a rule that the conventions guideline already states"
-    ]
-  }
-}

package/guidelines/workspaceRecipes/workspaceRecipes.generate.json

@@ -1,34 +0,0 @@
-{
-  "title": "Workspace Recipes",
-  "description": "Worked step-by-step recipes for common Akan changes, plus the auto-generated signal/service/store/document API reference",
-  "group": "core",
-  "codegenPriority": 5,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "example",
-      "description": "Module files a recipe walks through",
-      "path": "{apps,libs}/*/lib/*/*.{constant,document,service,signal,store}.ts",
-      "sample": 5
-    }
-  ],
-  "update": {
-    "filePath": "./workspaceRecipes.instruction.md",
-    "contents": [
-      "add a field",
-      "inject a dependency",
-      "create a slice",
-      "create a mutation",
-      "internal triggers",
-      "insights",
-      "migrating the LLM adaptor and the removed --ai commands",
-      "auto-generated API reference"
-    ],
-    "rules": [
-      "Use current Akan APIs only",
-      "Every recipe names the files to edit and the order to edit them in",
-      "Keep the <%= appName %> placeholder so the rendered guide names this workspace's app",
-      "Never duplicate a rule that workspaceOnboarding already states — link to it instead"
-    ]
-  }
-}

package/index-qt8dqgnf.js

@@ -1,250 +0,0 @@
-// @bun
-// pkgs/@akanjs/devkit/codeAgent/agent/SubagentPool.ts
-import { codeAgentReadOnlyBuiltins } from "akanjs/common";
-import { Type } from "typebox";
-var maxResultChars = 8000;
-var tickMs = 1000;
-
-class SubagentPool2 {
-  static kinds = {
-    explore: {
-      readOnly: true,
-      desc: "reads, searches and reports back. It cannot write a file or run a command."
-    },
-    code: {
-      readOnly: false,
-      desc: "makes the change itself, with the same tools as this session."
-    }
-  };
-  static defaultKind = "explore";
-  #options;
-  #children = new Map;
-  #running = 0;
-  #spent = 0;
-  #ticker = null;
-  constructor(options) {
-    this.#options = options;
-  }
-  static extensionFor(options) {
-    if (!options.parent.tools.subagent)
-      return;
-    if (options.depth >= options.parent.tools.subagent.maxDepth)
-      return;
-    const pool = new SubagentPool2(options);
-    return { name: "akan-subagent", factory: (pi) => pool.#register(pi) };
-  }
-  static toolName = "task";
-  #register(pi) {
-    pi.registerTool({
-      name: SubagentPool2.toolName,
-      label: "Task",
-      description: "Run a focused sub-agent on one self-contained question and get back its answer. Use it for searching and reading that would otherwise fill this conversation \u2014 the sub-agent's own reading does not come back, only its answer. Give it everything it needs: it cannot see this conversation.",
-      promptSnippet: "task: run a sub-agent on one self-contained question and get back only its answer",
-      parameters: Type.Object({
-        description: Type.String({ description: "Three to five words naming the task, for the activity log." }),
-        prompt: Type.String({
-          description: "The complete instruction. The sub-agent sees nothing of this conversation."
-        }),
-        type: Type.Optional(Type.Union(Object.entries(SubagentPool2.kinds).map(([kind, spec]) => Type.Literal(kind, { description: spec.desc })), { description: `What the sub-agent may do. Defaults to ${SubagentPool2.defaultKind}.` }))
-      }),
-      execute: async (id, params, signal) => {
-        const kind = params.type ?? SubagentPool2.defaultKind;
-        const refusal = this.#refuse();
-        if (refusal)
-          return { content: [{ type: "text", text: refusal }], details: undefined, isError: true };
-        this.#running += 1;
-        this.#children.set(id, { kind, description: params.description, startedAt: Date.now() });
-        this.#report();
-        this.#options.onNotice?.(`${kind} sub-agent \xB7 ${params.description}`);
-        try {
-          const text = await this.#run(id, kind, params.prompt, signal);
-          return { content: [{ type: "text", text }], details: undefined };
-        } finally {
-          this.#running -= 1;
-          this.#children.delete(id);
-          this.#report();
-        }
-      }
-    });
-  }
-  #refuse() {
-    const budget = this.#options.parent.tools.subagent;
-    if (!budget)
-      return "Sub-agents are disabled by this profile.";
-    if (this.#running >= budget.maxConcurrent)
-      return `Too many sub-agents are already running (limit ${budget.maxConcurrent}). Wait for one to finish.`;
-    if (this.#spent >= budget.budget)
-      return `The sub-agent token budget (${budget.budget}) is spent. Do the rest of this work yourself.`;
-    return;
-  }
-  static childOf(parent, kind) {
-    const budget = parent.tools.subagent;
-    return {
-      ...parent,
-      name: `${parent.name}:${kind}`,
-      tools: {
-        ...parent.tools,
-        builtin: SubagentPool2.kinds[kind].readOnly ? parent.tools.builtin.filter((tool) => codeAgentReadOnlyBuiltins.includes(tool)) : parent.tools.builtin,
-        subagent: budget ? { ...budget, maxDepth: budget.maxDepth } : false
-      },
-      session: { store: "memory", crossSession: false },
-      ui: { canPrompt: false },
-      context: { projectFiles: false, skills: parent.context.skills }
-    };
-  }
-  #report() {
-    const onAgents = this.#options.onAgents;
-    if (!onAgents)
-      return;
-    onAgents([...this.#children].map(([id, child]) => ({
-      id,
-      kind: child.kind,
-      description: child.description,
-      startedAt: child.startedAt,
-      tokens: child.agent?.tokensUsed ?? 0
-    })));
-    if (this.#children.size && !this.#ticker) {
-      this.#ticker = setInterval(() => this.#report(), tickMs);
-      this.#ticker.unref?.();
-    } else if (!this.#children.size && this.#ticker) {
-      clearInterval(this.#ticker);
-      this.#ticker = null;
-    }
-  }
-  async#run(id, kind, prompt, signal) {
-    const { CodeAgent } = await import("./CodeAgent-gjqnc2mg.js");
-    const budget = this.#options.parent.tools.subagent;
-    const child = SubagentPool2.childOf(this.#options.parent, kind);
-    const agent = await CodeAgent.create({
-      workspace: this.#options.workspace,
-      cwd: this.#options.cwd,
-      profile: child,
-      apps: [],
-      depth: this.#options.depth + 1
-    });
-    const running = this.#children.get(id);
-    if (running)
-      running.agent = agent;
-    const abort = () => void agent.abort();
-    signal?.addEventListener("abort", abort, { once: true });
-    try {
-      let answer = "";
-      agent.on((event) => {
-        if (event.type === "message" && event.role === "assistant")
-          answer = event.text;
-      });
-      await agent.prompt(prompt);
-      await agent.waitForIdle();
-      this.#spent += agent.tokensUsed;
-      const ceiling = budget ? budget.budget : 0;
-      this.#options.onNotice?.(`${kind} sub-agent finished, ${agent.tokensUsed} tokens (${this.#spent} of ${ceiling} spent)`);
-      return answer.length > maxResultChars ? `${answer.slice(0, maxResultChars)}
-\u2026(truncated)` : answer || "(no answer)";
-    } finally {
-      signal?.removeEventListener("abort", abort);
-      agent.dispose();
-    }
-  }
-}
-
-// pkgs/@akanjs/devkit/codeAgent/agent/akanCodePaths.ts
-import { existsSync } from "fs";
-import { homedir } from "os";
-import path from "path";
-var builtinSkillsDir = () => {
-  const candidates = [path.join(import.meta.dir, "skills"), path.join(import.meta.dir, "..", "skills")];
-  return candidates.find((candidate) => existsSync(candidate));
-};
-var akanCodePaths2 = {
-  workspaceDir: (workspaceRoot) => path.join(workspaceRoot, ".akan", "code"),
-  sessionsDir: (workspaceRoot) => path.join(workspaceRoot, ".akan", "code", "sessions"),
-  extensionsDir: (workspaceRoot) => path.join(workspaceRoot, ".akan", "code", "extensions"),
-  skillsDir: (workspaceRoot) => path.join(workspaceRoot, ".akan", "code", "skills"),
-  mailDir: (workspaceRoot) => path.join(workspaceRoot, ".akan", "code", "mail"),
-  builtinSkillsDir,
-  mcpFile: (workspaceRoot) => path.join(workspaceRoot, ".akan", "code", "mcp.json"),
-  globalDir: () => path.join(homedir(), ".akan", "code"),
-  authFile: () => path.join(homedir(), ".akan", "code", "auth.json"),
-  modelsFile: () => path.join(homedir(), ".akan", "code", "models.json")
-};
-
-// pkgs/@akanjs/devkit/codeAgent/tools/McpServerConfig.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "fs";
-import path2 from "path";
-class McpServerConfig {
-  static file(workspaceRoot) {
-    return akanCodePaths2.mcpFile(workspaceRoot);
-  }
-  static read(workspaceRoot) {
-    const entries = Object.entries(McpServerConfig.#parse(workspaceRoot).map);
-    return entries.filter(([, entry]) => !entry.disabled).map(([name, entry]) => McpServerConfig.#refOf(name, entry));
-  }
-  static declared(workspaceRoot) {
-    return Object.entries(McpServerConfig.#parse(workspaceRoot).map).map(([name, entry]) => ({
-      ref: McpServerConfig.#refOf(name, entry),
-      disabled: !!entry.disabled
-    }));
-  }
-  static add(workspaceRoot, name, target) {
-    const [head, ...rest] = target;
-    if (!head)
-      throw new Error("Give the server a command to run, or a url to reach.");
-    const entry = /^https?:\/\//.test(head) ? { url: head } : { command: head, args: rest };
-    const { file, key, map } = McpServerConfig.#parse(workspaceRoot);
-    const next = { ...map, [name]: entry };
-    mkdirSync(path2.dirname(file), { recursive: true });
-    writeFileSync(file, `${JSON.stringify({ [key]: next }, null, 2)}
-`);
-    return McpServerConfig.#refOf(name, entry);
-  }
-  static remove(workspaceRoot, name) {
-    const { file, key, map } = McpServerConfig.#parse(workspaceRoot);
-    if (!(name in map))
-      return false;
-    const next = { ...map };
-    delete next[name];
-    writeFileSync(file, `${JSON.stringify({ [key]: next }, null, 2)}
-`);
-    return true;
-  }
-  static #refOf(name, entry) {
-    return {
-      name,
-      transport: entry.url ? "http" : "stdio",
-      ...entry.command ? { command: entry.command } : {},
-      ...entry.args ? { args: entry.args } : {},
-      ...entry.url ? { url: entry.url } : {},
-      ...entry.env ? { env: entry.env } : {}
-    };
-  }
-  static targetOf(ref) {
-    return ref.url ?? [ref.command, ...ref.args ?? []].filter(Boolean).join(" ");
-  }
-  static problem(workspaceRoot) {
-    const file = McpServerConfig.file(workspaceRoot);
-    if (!existsSync2(file))
-      return;
-    try {
-      JSON.parse(readFileSync(file, "utf8"));
-      return;
-    } catch (error) {
-      return `${file} is not valid JSON \u2014 ${String(error)}`;
-    }
-  }
-  static #parse(workspaceRoot) {
-    const file = McpServerConfig.file(workspaceRoot);
-    const empty = { file, key: "mcpServers", map: {} };
-    if (!existsSync2(file))
-      return empty;
-    try {
-      const parsed = JSON.parse(readFileSync(file, "utf8"));
-      if (parsed.servers && !parsed.mcpServers)
-        return { file, key: "servers", map: parsed.servers };
-      return { ...empty, map: parsed.mcpServers ?? {} };
-    } catch {
-      return empty;
-    }
-  }
-}
-
-export { SubagentPool2, akanCodePaths2, McpServerConfig };

package/templates/__scalar/__model__/__model__.abstract.md

@@ -1,28 +0,0 @@
-# Scalar Abstract
-
-## Purpose
-
-Describe the embedded value object or reusable data concept this scalar owns.
-
-## Domain Rules
-
-- Keep durable validation and meaning rules here.
-- Avoid repeating field types that are already clear in the constant file.
-
-## Data Meaning
-
-Explain the meaning of the scalar fields and when this scalar should be used.
-
-## Workflows
-
-Describe lifecycle or normalization behavior when relevant.
-
-## Agent Notes
-
-- Read this abstract before changing the scalar.
-- Update this file when validation meaning, public behavior, or reuse rules change.
-- Do not update this file for formatting-only, import-only, or style-only changes.
-
-## Related Modules
-
-- None yet.

package/templates/module/__model__.abstract.md

@@ -1,28 +0,0 @@
-# Module Abstract
-
-## Purpose
-
-Describe the business concept this module owns.
-
-## Domain Rules
-
-- Keep durable business invariants here.
-- Avoid repeating field types that are already clear in the constant file.
-
-## Data Meaning
-
-Explain the meaning of important data only when the code does not make the intent obvious.
-
-## Workflows
-
-Describe create, update, approval, deletion, state transition, or other business flows.
-
-## Agent Notes
-
-- Read this abstract before changing the module.
-- Update this file when business invariants, workflows, or public behavior change.
-- Do not update this file for formatting-only, import-only, or style-only changes.
-
-## Related Modules
-
-- None yet.

package/templates/service/__model__.abstract.md

@@ -1,28 +0,0 @@
-# Service Abstract
-
-## Purpose
-
-Describe the business workflow or integration this service owns.
-
-## Domain Rules
-
-- Keep durable business invariants here.
-- Avoid repeating implementation details already clear in the service or signal files.
-
-## Data Meaning
-
-Explain important input, output, and state meanings only when the code does not make the intent obvious.
-
-## Workflows
-
-Describe the service workflows, background jobs, external calls, or state transitions.
-
-## Agent Notes
-
-- Read this abstract before changing the service module.
-- Keep business behavior in service code and expose callable actions through signals.
-- Update this file when business invariants, workflows, or public behavior change.
-
-## Related Modules
-
-- None yet.