@akanjs/cli 3.0.0-beta.13 → 3.0.0-beta.14

package/.build-stamp

@@ -1 +1 @@
-00a6059ed52a1c07cac97cd101175f3f591a5679683a8d58f9085ef6dfdfb23d
+f06399ed7f38f0f1001501ebf36203c43473554fc56177ed5d3be66e6b399252

package/{TunnelShare-2kwqb1j6.js → TunnelShare-r5tc2qk5.js}

@@ -1,8 +1,8 @@
 // @bun
 import {
   TunnelShare2
-} from "./index-wmb05v4q.js";
-import"./index-649svkyt.js";
+} from "./index-gm76f0qb.js";
+import"./index-myj01w9r.js";
 import"./index-q0y2jq9j.js";
 export {
   TunnelShare2 as TunnelShare

package/{agent.command-7357vxd8.js → agent.command-bhwsc2aj.js}

@@ -12,7 +12,7 @@ import"./index-15r9a10e.js";
 import"./index-h7yw2z9n.js";
 import {
   AgentScript
-} from "./index-s3fvrydw.js";
+} from "./index-31hmq4ys.js";
 
 // pkgs/@akanjs/cli/agent/agent.command.ts
 class AgentCommand extends command("agent", [AgentScript], ({ public: target }) => ({

package/{application.command-8s8ns95d.js → application.command-436y543n.js}

@@ -12,16 +12,13 @@ import"./index-5nyznra1.js";
 import"./index-6wwzs1bc.js";
 import {
   ApplicationScript
-} from "./index-cnzm1wn5.js";
+} from "./index-sg1bgdhe.js";
 import"./index-1nwxbr2y.js";
 import"./index-hwkygn9s.js";
 import"./index-ys7dvdb3.js";
 import {
   getMobileTargetChoices
 } from "./index-47pj3aee.js";
-import {
-  AbstractDoc
-} from "./index-meh558jy.js";
 
 // pkgs/@akanjs/cli/application/application.command.ts
 import { select } from "@inquirer/prompts";
@@ -44,13 +41,6 @@ class ApplicationCommand extends command("application", [ApplicationScript], ({
   sync: target({ desc: "Sync dependencies and configuration for an app or library" }).with(Sys).exec(async function(sys) {
     await this.applicationScript.sync(sys);
   }),
-  compact: target({ desc: "Compact the *.abstract.md files of an app or library with the AI editor" }).with(Sys).option("module", String, { desc: "single module to compact", nullable: true }).option("minLines", Number, {
-    flag: "n",
-    desc: "only compact abstracts longer than this",
-    default: AbstractDoc.compactMinLines
-  }).option("interactive", Boolean, { desc: "confirm or refine each rewrite", default: false }).exec(async function(sys, module, minLines, interactive) {
-    await this.applicationScript.compact(sys, { module, minLines, interactive });
-  }),
   script: target({ desc: "Run a custom script in the application" }).with(App).arg("filename", String, { desc: "name of script", nullable: true }).exec(async function(app, filename) {
     await this.applicationScript.script(app, filename);
   }),

package/{cloud.command-p5dnhft9.js → cloud.command-3xn0xpz8.js}

@@ -2,23 +2,22 @@
 import"./index-q0y2jq9j.js";
 import {
   GlobalConfig
-} from "./index-649svkyt.js";
+} from "./index-myj01w9r.js";
 import {
   Workspace,
   command
 } from "./index-b3ae16mg.js";
 import"./index-5nyznra1.js";
 import"./index-6wwzs1bc.js";
-import"./index-5tw8t1ts.js";
-import"./index-cnzm1wn5.js";
+import"./index-sg1bgdhe.js";
 import"./index-1nwxbr2y.js";
 import"./index-hwkygn9s.js";
 import"./index-kcxmv48c.js";
 import"./index-t8gvwcrx.js";
-import"./index-bz10w9t2.js";
+import"./index-tt6kzwj5.js";
 import {
   CloudScript2
-} from "./index-t3c045et.js";
+} from "./index-8tcj5wk8.js";
 import"./index-ys7dvdb3.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts
@@ -32,18 +31,6 @@ class CloudCommand extends command("cloud", [CloudScript2], ({ public: target })
   logout: target({ desc: "Logout from Akan Cloud services" }).option("host", String, { desc: "host of the cloud", default: GlobalConfig.akanCloudHost }).with(Workspace).exec(async function(host, workspace) {
     await this.cloudScript.logout(workspace, host);
   }),
-  setLlm: target({ desc: "Configure LLM (Large Language Model) API key" }).with(Workspace).exec(async function(workspace) {
-    await this.cloudScript.setLlm(workspace);
-  }),
-  resetLlm: target({ desc: "Reset LLM configuration to default" }).with(Workspace).exec(function(workspace) {
-    this.cloudScript.resetLlm(workspace);
-  }),
-  ask: target({
-    devOnly: true,
-    desc: "Ask AI assistant a question about your project"
-  }).option("question", String, { ask: "question to ask" }).with(Workspace).exec(async function(question, workspace) {
-    await this.cloudScript.ask(question, workspace);
-  }),
   deployAkan: target({
     devOnly: true,
     desc: "Deploy Akan.js framework to cloud (internal use)"

package/{cloud.script-gxpbhras.js → cloud.script-0a76c2g8.js}

@@ -1,14 +1,13 @@
 // @bun
 import {
   CloudScript2
-} from "./index-t3c045et.js";
-import"./index-bz10w9t2.js";
-import"./index-cnzm1wn5.js";
+} from "./index-8tcj5wk8.js";
+import"./index-tt6kzwj5.js";
+import"./index-sg1bgdhe.js";
 import"./index-ys7dvdb3.js";
 import"./index-1nwxbr2y.js";
 import"./index-t8gvwcrx.js";
-import"./index-5tw8t1ts.js";
-import"./index-649svkyt.js";
+import"./index-myj01w9r.js";
 import"./index-b3ae16mg.js";
 import"./index-hwkygn9s.js";
 import"./index-5nyznra1.js";

package/commandManifest.json

@@ -1 +1 @@
-{"byCommand":{"create-workspace":"workspace","generate-agent-rules":"workspace","lint":"workspace","lint-all":"workspace","sync-all":"workspace","init":"workspace","agent":"agent","create-application":"application","remove-application":"application","plan-slice":"application","sync":"application","compact":"application","script":"application","console":"application","logs":"application","build":"application","b":"application","typecheck":"application","t":"application","test":"application","build-ios":"application","bi":"application","build-android":"application","ba":"application","start":"application","s":"application","start-ios":"application","si":"application","start-android":"application","sa":"application","release-ios":"application","release-android":"application","release-source":"application","codepush":"application","dbup":"application","dbdown":"application","configure-app":"application","create-library":"library","remove-library":"library","sync-library":"library","library-status":"library","install-library":"library","start-registry":"localRegistry","reset-registry":"localRegistry","smoke-registry":"localRegistry","version":"package","create-package":"package","remove-package":"package","sync-package":"package","build-package":"package","verify-dist-package":"package","verify-akan-publish-packages":"package","create-module":"module","remove-module":"module","create-service":"module","create-view":"module","create-unit":"module","create-template":"module","create-crud-page":"page","context":"context","doctor":"context","mcp-install":"context","mcp":"context","mcp-call":"context","login":"cloud","logout":"cloud","set-llm":"cloud","reset-llm":"cloud","ask":"cloud","deploy-akan":"cloud","update":"cloud","download-env":"cloud","upload-env":"cloud","subspace":"subspace","guideline":"guideline","generate-instruction":"guideline","update-instruction":"guideline","generate-document":"guideline","reapply-instruction":"guideline","create-scalar":"scalar","remove-scalar":"scalar","create-ui":"primitive","add-field":"primitive","add-enum-field":"primitive","quality":"quality","repair":"repair","workflow":"workflow","tunnel":"tunnel"}}
+{"byCommand":{"create-workspace":"workspace","generate-agent-rules":"workspace","lint":"workspace","lint-all":"workspace","sync-all":"workspace","init":"workspace","agent":"agent","create-application":"application","remove-application":"application","plan-slice":"application","sync":"application","script":"application","console":"application","logs":"application","build":"application","b":"application","typecheck":"application","t":"application","test":"application","build-ios":"application","bi":"application","build-android":"application","ba":"application","start":"application","s":"application","start-ios":"application","si":"application","start-android":"application","sa":"application","release-ios":"application","release-android":"application","release-source":"application","codepush":"application","dbup":"application","dbdown":"application","configure-app":"application","create-library":"library","remove-library":"library","sync-library":"library","library-status":"library","install-library":"library","start-registry":"localRegistry","reset-registry":"localRegistry","smoke-registry":"localRegistry","version":"package","create-package":"package","remove-package":"package","sync-package":"package","build-package":"package","verify-dist-package":"package","verify-akan-publish-packages":"package","create-module":"module","remove-module":"module","create-service":"module","create-view":"module","create-unit":"module","create-template":"module","create-crud-page":"page","context":"context","doctor":"context","mcp-install":"context","mcp":"context","mcp-call":"context","login":"cloud","logout":"cloud","deploy-akan":"cloud","update":"cloud","download-env":"cloud","upload-env":"cloud","subspace":"subspace","guideline":"guideline","create-scalar":"scalar","remove-scalar":"scalar","create-ui":"primitive","add-field":"primitive","add-enum-field":"primitive","quality":"quality","repair":"repair","workflow":"workflow","tunnel":"tunnel"}}

package/{context.command-wsjt98c1.js → context.command-hxh96cc3.js}

@@ -11,17 +11,15 @@ import"./index-jwjaf9fy.js";
 import"./index-15r9a10e.js";
 import {
   ContextScript
-} from "./index-j7rwsd23.js";
+} from "./index-fad0hhty.js";
 import"./index-7f4dsf9v.js";
 import"./index-h7yw2z9n.js";
 import"./index-em4swemt.js";
 import"./index-8pkvrcv1.js";
-import"./index-649svkyt.js";
-import"./index-5tw8t1ts.js";
-import"./index-kpnp2e10.js";
 import"./index-sh88vtye.js";
-import"./index-h3g1152j.js";
-import"./index-j1tajctp.js";
+import"./index-9fbk3dbh.js";
+import"./index-r73ha1rf.js";
+import"./index-1mrmve4s.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/{devTui-myg3pqeg.js → devTui-4ted58a6.js}

@@ -4,7 +4,7 @@ import {
   plainTextOf,
   HOST_SOURCE,
   DevLogBuffer
-} from "./index-cnzm1wn5.js";
+} from "./index-sg1bgdhe.js";
 import {
   writeClipboard
 } from "./index-p6pbz9n5.js";

package/{devTuiView-gz2fbf4v.js → devTuiView-1dj2yq7t.js}

@@ -1,7 +1,7 @@
 // @bun
 // pkgs/@akanjs/cli/application/devTuiView.ts
 var createDevTuiView = async (supervisor) => {
-  const { DevTui } = await import("./devTui-myg3pqeg.js");
+  const { DevTui } = await import("./devTui-4ted58a6.js");
   return new DevTui(supervisor);
 };
 export {

package/guideline.command-cyw8c0m0.js

@@ -0,0 +1,48 @@
+// @bun
+import {
+  script,
+  command
+} from "./index-b3ae16mg.js";
+import"./index-q0y2jq9j.js";
+import"./index-5nyznra1.js";
+import"./index-6wwzs1bc.js";
+import {
+  Prompter
+} from "./index-h7yw2z9n.js";
+
+// pkgs/@akanjs/cli/guideline/guideline.script.ts
+import { Logger } from "akanjs/common";
+
+class GuidelineScript extends script("guideline") {
+  async guideline(action, name = null, format = "markdown") {
+    if (action === "list") {
+      const guidelines = await Prompter.listGuidelines();
+      Logger.rawLog(format === "json" ? JSON.stringify({ guidelines }, null, 2) : guidelines.join(`
+`));
+      return;
+    }
+    if (action === "show") {
+      if (!name)
+        throw new Error("Guideline name is required. Example: akan guideline show framework");
+      const [instruction, guideJson] = await Promise.all([Prompter.getInstruction(name), Prompter.getGuideJson(name)]);
+      Logger.rawLog(format === "json" ? JSON.stringify({ name, instruction, guideJson }, null, 2) : instruction);
+      return;
+    }
+    throw new Error(`Unknown guideline action: ${action}. Use "list" or "show".`);
+  }
+}
+
+// pkgs/@akanjs/cli/guideline/guideline.command.ts
+class GuidelineCommand extends command("guideline", [GuidelineScript], ({ public: target }) => ({
+  guideline: target({ desc: "List or show Akan AI guideline instructions" }).arg("action", String, { desc: "list or show" }).arg("name", String, { desc: "guideline name for show", nullable: true }).option("format", String, {
+    desc: "output format",
+    default: "markdown",
+    enum: ["markdown", "json"]
+  }).exec(async function(action, name, format) {
+    await this.guidelineScript.guideline(action, name, format);
+  })
+})) {
+}
+export {
+  GuidelineCommand
+};

package/guidelines/agentRule/agentRule.instruction.md

@@ -76,19 +76,30 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
 - **The LLM is configured in `option.ts`, never through the environment.** `option.setLlm({ apiKey, model, host })`
   — or `setLlm((options) => …)` to read the key out of the app's own env object, which is where a secret belongs —
   fills whichever adaptor holds `LlmAdaptorRole`, reaching it as the `llmOption` use. The settings are the role's
-  rather than one provider's, so they survive a swap. **DeepSeek is the built-in default** (`deepseek-v4-flash` at
-  `https://api.deepseek.com`); with no `apiKey` the app still boots and the chat answers `llmUnavailable`. Swap
-  providers the way middleware is applied: `option.applyAdaptor(LlmAdaptorRole, AnthropicLlm)`. An app may still
-  write its own — an `adapt()` class in a `srvkit/` implementing `LlmAdaptor.chat(request, onDelta?)`, where
-  ignoring `onDelta` still answers whole — but for vision it no longer has to.
-- **Three providers ship, and only two of them read a picture.** `DeepseekLlm` is the default and declares no
-  `accepts`, which is a fact about its API rather than a gap. `OpenaiLlm` speaks the same chat-completions dialect
-  — `OpenaiDialect`, shared between them so a protocol fix lands once — against `https://api.openai.com/v1` and
-  declares `{ image: true }`, sending an image as a content part. `AnthropicLlm` is the Messages API and declares
-  `{ image: true, document: true }`; it is its own file rather than a branch, because the system prompt is a field
-  and not a message, tool calls and results are content blocks, the results ride in a *user* turn, roles must
-  alternate — so two wire turns that map to one role are merged — and `max_tokens` is required. **Both new ones
-  require `model`**: a default would age into a 404, and worse, it would decide the vision claim for the app.
+  rather than one provider's, so they survive a swap. **`OpenaiLlm` is the built-in default**, pointed at
+  `https://api.openai.com/v1`; with no `apiKey` or no `model` the app still boots and the chat answers
+  `llmUnavailable`. Swap providers the way middleware is applied:
+  `option.applyAdaptor(LlmAdaptorRole, AnthropicLlm)`. An app may still write its own — an `adapt()` class in a
+  `srvkit/` implementing `LlmAdaptor.chat(request, onDelta?)`, where ignoring `onDelta` still answers whole — and
+  whatever settings it needs beyond `LlmOption` travel through the same `setLlm`, read back with
+  `use<MyLlmOption>()` from an interface extending it.
+- **Two adaptors ship, one per wire — a vendor is a host and a model name, not a protocol.** `OpenaiLlm` is the
+  chat-completions dialect (`OpenaiDialect`) pointed at whatever `host` names, so OpenAI, DeepSeek, Groq,
+  Together, OpenRouter, Ollama and a self-hosted vLLM are all one class and one `option.setLlm({ host, model })`.
+  `AnthropicLlm` is the Messages API and declares `{ image: true, document: true }`; it is its own file rather
+  than a branch, because the system prompt is a field and not a message, tool calls and results are content
+  blocks, the results ride in a *user* turn, roles must alternate — so two wire turns that map to one role are
+  merged — and `max_tokens` is required. **Both require `model`**: a default would age into a 404, and worse, it
+  would decide the vision claim for the app.
+- **`OpenaiLlm` claims vision for its default host and for nothing else.** OpenAI's own endpoint takes image
+  parts, so that is what it answers with no `host` set. A `host` the app named is a gateway the class knows
+  nothing about, and it stays text-only until `option.setLlm({ accepts })` says otherwise — handing bytes to a
+  model that cannot decode them kills the whole turn on a 400, where text-only degrades them to a note the model
+  can repeat back.
+- **A refusal is one key, `agent.error.llmRequestFailed`, and it names the host.** The provider's own sentence
+  rides in `reason` and the hostname in `provider`, so an adaptor an app wrote reports through the same
+  translated channel the shipped ones do rather than needing a key in the framework's dictionary it cannot
+  add.
 - **`accepts` is answered per model, through `option.setLlm({ accepts })`.** An adaptor answers for an API and one
   API serves models that differ, so the override rides beside the `model` it is a fact about. It is not a table
   the framework keeps: a table is a claim about models that ship after it, and getting this wrong is the worst

package/guidelines/conventions/conventions.instruction.md

@@ -714,9 +714,12 @@ what every developer must know even when not building one.
   every tool runs in the caller's own browser session, gated by guards and the approval card. Its guard is
   `AgentRelayAccess`, which refuses every call until the app names a guard of its own —
   `option.setAgentAccess(SignedIn)`. **The LLM is configured in `option.ts`, never through the environment**
-  (`option.setLlm({ apiKey, model, host })`). Three providers ship — `DeepseekLlm` (the default, text only),
-  `OpenaiLlm` and `AnthropicLlm` (both read images) — and swapping one in is
-  `option.applyAdaptor(LlmAdaptorRole, AnthropicLlm)`.
+  (`option.setLlm({ apiKey, model, host })`). Two adaptors ship, one per wire: `OpenaiLlm` is the default and
+  speaks the chat-completions dialect to whatever `host` names — OpenAI, DeepSeek, Groq, OpenRouter, Ollama — and
+  `AnthropicLlm` speaks the Messages API and reads a PDF as well as a picture. Both require `model`. A provider
+  neither covers is an `adapt()` class in `srvkit/` implementing `LlmAdaptor`, applied with
+  `option.applyAdaptor(LlmAdaptorRole, TheClass)`; whatever settings it needs beyond `LlmOption` ride `setLlm`
+  too, read back with `use<MyLlmOption>()`.
 - **Declare the tool beside the control that already does it**, never as a separate surface:
   `st.tool("x").desc("…").arg("id", ID).exec(fn)` returns the callable to hand to `onClick` — one handler for the
   person and the agent. Publish it only where the screen already renders the control; a falsy name declares the

package/guidelines/moduleCodegen/moduleCodegen.instruction.md

@@ -6,7 +6,7 @@ Use this to orchestrate AI-assisted module creation. The model should emit small
 ## Ownership
 - Input description explains the business object, lifecycle, actions, queries, UI needs, and relations.
 - The first output pass should prioritize data shape and persistence over decorative UI.
-- Each returned code block must start with `// File: <relative path>` so `AiSession.writeTypescripts()` can parse it.
+- Each returned code block must start with `// File: <relative path>` so the caller can tell which file it writes.
 - Generated files must target `lib/<model>/...` or `lib/__scalar/<scalar>/...` only unless explicitly requested.
 
 ## Current Akan Patterns

package/guidelines/workspaceRecipes/workspaceRecipes.generate.json

@@ -21,6 +21,7 @@
       "create a mutation",
       "internal triggers",
       "insights",
+      "migrating the LLM adaptor and the removed --ai commands",
       "auto-generated API reference"
     ],
     "rules": [

package/guidelines/workspaceRecipes/workspaceRecipes.instruction.md

@@ -393,6 +393,68 @@ Rules the loader and `akan sync` enforce: a chain module has no other export; `p
 `_overrides.tsx` is untouched. MCP: `prompts/get` now runs the page's body under the caller's token and hands the
 model the description, what the page fetched, and the tools of those modules — see `mcpRule`.
 
+---
+
+### Recipe 8: Migrating the LLM Adaptor and the Removed `--ai` Commands
+
+Two changes land together. The runtime LLM seam now names a wire rather than a vendor, and the CLI's AI editor is
+gone. They touch different files and neither one is optional — the first breaks a build or, worse, degrades
+silently; the second breaks a script that calls a command that no longer exists.
+
+#### The adaptor, in `lib/option.ts` and `env/env.server.*.ts`
+
+`DeepseekLlm` is deleted. `OpenaiLlm` is the default and speaks the chat-completions dialect to whatever `host`
+names, so DeepSeek, Groq, Together, OpenRouter, Ollama and a self-hosted vLLM are the same class with a different
+`host` and `model`. `AnthropicLlm` is unchanged.
+
+```ts
+// before — env/env.server.local.ts
+export const env: ModulesOptions = {
+  ...libEnv,
+  llm: { apiKey: process.env.DEEPSEEK_KEY },
+};
+
+// after — the default model and host are gone, so name both
+export const env: ModulesOptions = {
+  ...libEnv,
+  llm: { apiKey: process.env.DEEPSEEK_KEY, model: "deepseek-v4-flash", host: "https://api.deepseek.com" },
+};
+```
+
+| Before | After | What happens if you skip it |
+|---|---|---|
+| `setLlm({ apiKey })`, relying on the DeepSeek default | `setLlm({ apiKey, model, host })` | The app boots, the log warns once, and the chat answers `llmUnavailable` to every turn |
+| `applyAdaptor(LlmAdaptorRole, DeepseekLlm)` | `OpenaiLlm` + `host: "https://api.deepseek.com"` | Build error — the class is gone |
+| `OpenaiLlm` pointed at a **named** `host`, reading images | add `accepts: { image: true }` to `setLlm` | **Silent**: images reach the model as a note saying they could not be read |
+| An adaptor of your own throwing `agent.error.<vendor>RequestFailed` | `new Err("agent.error.llmRequestFailed", { provider, status, reason })` | The chat prints the raw key instead of a sentence |
+| Provider settings in a second `option.use({ myLlmOption })` | put them in `setLlm` and read `use<MyLlmOption>()` | Nothing breaks; the second channel is no longer needed |
+
+`OpenaiLlm` claims vision for its default host (`https://api.openai.com/v1`) and for nothing else, because a host
+you named is a gateway it knows nothing about — and bytes handed to a model that cannot decode them kill the whole
+turn on a 400, where text-only degrades them to a note. Declare `accepts` whenever you set `host`.
+
+`LlmOption` is now a floor rather than the whole shape: `setLlm` carries whatever else it is handed to the role, so
+an adaptor of your own declares `interface MyLlmOption extends LlmOption { region: string }`, reads it with
+`use<MyLlmOption>()`, and stops needing a config channel beside `setLlm`.
+
+#### The CLI, in scripts and CI
+
+`AiSession` and every command that drove it are removed. There is no replacement command — the workspace's agent
+surface (`akan context`, the MCP tools, `akan guideline show`) is what feeds a coding agent now.
+
+| Removed | What to do instead |
+|---|---|
+| `akan create-module <name> --ai`, `akan create-scalar <name> --ai` | Drop the flag. The command scaffolds the same files it always did; write the constant and dictionary yourself or let a coding agent do it against `get_guideline modelConstant` / `modelDictionary` |
+| `akan compact <app-or-lib>` | Edit the `*.abstract.md` by hand. `akan quality scan` still warns past 300 lines |
+| `akan set-llm`, `akan reset-llm`, `akan ask` | Nothing. The runtime LLM is `option.setLlm(...)` and has never been this config |
+| `akan generate-instruction`, `akan update-instruction`, `akan generate-document`, `akan reapply-instruction` | Nothing. `akan guideline list` / `show` still read the bundled guidelines |
+| `import { AiSession } from "@akanjs/devkit/aiEditor"` | Nothing — the module is gone |
+
+`~/.akan/config.json` keeps an `llm` entry if it had one. It is ignored; delete it, because it holds an API key.
+
+Then: `bun run akan typecheck <app>`, `bun run akan lint <app>`, and one agent turn in the browser to confirm the
+provider answers.
+
 ### Data Flow Summary
 
 For each business question, follow this chain:

package/index-1mrmve4s.js

@@ -0,0 +1,61 @@
+// @bun
+import {
+  runner,
+  script
+} from "./index-b3ae16mg.js";
+import {
+  generatedFilesForSync,
+  createPassedPrimitiveReport,
+  scalarChangedFiles
+} from "./index-jwjaf9fy.js";
+import {
+  pluralizeName
+} from "./index-nz8prx9g.js";
+
+// pkgs/@akanjs/cli/scalar/scalar.runner.ts
+class ScalarRunner extends runner("scalar") {
+  async applyScalarTemplate(sys, scalarName) {
+    await sys.applyTemplate({
+      basePath: "./lib/__scalar",
+      template: "__scalar",
+      dict: { model: scalarName, models: pluralizeName(scalarName), sysName: sys.name },
+      overwrite: false
+    });
+    return {
+      abstract: {
+        filename: `${scalarName}.abstract.md`,
+        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.abstract.md`)
+      },
+      constant: {
+        filename: `${scalarName}.constant.ts`,
+        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.constant.ts`)
+      },
+      dictionary: {
+        filename: `${scalarName}.dictionary.ts`,
+        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.dictionary.ts`)
+      },
+      document: {
+        filename: `${scalarName}.document.ts`,
+        content: await sys.readFile(`lib/__scalar/${scalarName}/${scalarName}.document.ts`)
+      }
+    };
+  }
+}
+
+// pkgs/@akanjs/cli/scalar/scalar.script.ts
+class ScalarScript extends script("scalar", [ScalarRunner]) {
+  async createScalar(sys, scalarName) {
+    const files = await this.scalarRunner.applyScalarTemplate(sys, scalarName);
+    return createPassedPrimitiveReport({
+      command: "create-scalar",
+      changedFiles: scalarChangedFiles(sys, scalarName, files),
+      generatedFiles: generatedFilesForSync(sys),
+      target: sys.name
+    });
+  }
+  async removeScalar(sys, scalarName) {
+    await sys.removeDir(`lib/__scalar/${scalarName}`);
+  }
+}
+
+export { ScalarScript };

package/{index-s3fvrydw.js → index-31hmq4ys.js}

@@ -138,7 +138,7 @@ ${sampleCleanup}## Akan Module Abstracts
 - Update the abstract when business invariants, workflows, or public behavior change.
 - Do not update the abstract for formatting-only, import-only, or style-only changes.
 - Service modules live in \`lib/_<service>\`, but their abstract file is \`<service>.abstract.md\`.
-- Keep an abstract short. Run \`akan compact <app-or-lib>\` to rewrite bloated abstracts down to the invariants the code cannot show; \`akan quality scan\` warns past 300 lines.
+- Keep an abstract short \u2014 the invariants the code cannot show, and nothing it already states. \`akan quality scan\` warns past 300 lines.
 
 ## Generated Files
 

package/{index-t3c045et.js → index-8tcj5wk8.js}

@@ -2,25 +2,22 @@
 import {
   GlobalConfig,
   CloudApi
-} from "./index-649svkyt.js";
-import {
-  PkgExecutor
-} from "./index-5nyznra1.js";
-import {
-  AiSession
-} from "./index-5tw8t1ts.js";
+} from "./index-myj01w9r.js";
 import {
   script
 } from "./index-b3ae16mg.js";
+import {
+  PkgExecutor
+} from "./index-5nyznra1.js";
 import {
   ApplicationScript
-} from "./index-cnzm1wn5.js";
+} from "./index-sg1bgdhe.js";
 import {
   PackageScript
 } from "./index-t8gvwcrx.js";
 import {
   CloudRunner
-} from "./index-bz10w9t2.js";
+} from "./index-tt6kzwj5.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";
@@ -31,16 +28,6 @@ class CloudScript2 extends script("cloud", [CloudRunner, ApplicationScript, Pack
   async logout(workspace, host = GlobalConfig.akanCloudHost) {
     await this.cloudRunner.logout(host);
   }
-  async setLlm(workspace) {
-    await this.cloudRunner.setLlm();
-  }
-  resetLlm(workspace) {
-    this.cloudRunner.resetLlm();
-  }
-  async ask(question, workspace) {
-    const session = new AiSession("general", { workspace, isContinued: true });
-    await session.ask(question);
-  }
   async downloadEnv(workspace, workspaceId = workspace.getWorkspaceId({ allowEmpty: true }), { host = GlobalConfig.akanCloudHost } = {}) {
     if (workspaceId) {
       await this.login(workspace, host);