@akanjs/cli 3.0.0-beta.2 → 3.0.0-beta.21

package/guidelines/fieldRule/fieldRule.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Field Rule",
-  "description": "Current via field helper rules",
-  "group": "core",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/constant.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Field Rule",
-      "path": "apps/akan/page/(docs)/conventions/module/constant.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./fieldRule.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)/conventions/module/constant.tsx"
-}

package/guidelines/framework/framework.generate.json

@@ -1,32 +0,0 @@
-{
-  "title": "Akan.js Framework",
-  "description": "Compact global context for Akan AI codegen",
-  "group": "core",
-  "docsSource": "apps/akan/page/(docs)/docs/intro/fundamentals.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Akan.js Framework",
-      "path": "apps/akan/page/(docs)/docs/intro/fundamentals.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./framework.instruction.md",
-    "contents": ["file ownership", "current API patterns", "codegen rules", "theming and UI customization"],
-    "rules": [
-      "Use current Akan APIs only",
-      "Keep output parseable for codegen",
-      "Include ownership boundaries",
-      "Carry no meta about this document itself — it renders into every workspace's always-loaded AGENTS.md"
-    ]
-  },
-  "page": "apps/akan/page/(docs)/docs/intro/fundamentals.tsx"
-}

package/guidelines/mcpRule/mcpRule.generate.json

@@ -1,35 +0,0 @@
-{
-  "title": "MCP Exposure Rule",
-  "description": "How Akan signals reach AI agents over MCP — guard-derived exposure, refusals, prompts, and resources",
-  "group": "core",
-  "codegenPriority": 4,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "example",
-      "description": "Signal files whose slices and endpoints declare the guards MCP exposure is derived from",
-      "path": "{apps,libs}/*/lib/*/*.signal.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./mcpRule.instruction.md",
-    "contents": [
-      "exposure rule",
-      "configuration",
-      "declaring endpoints",
-      "refusals and wire behaviour",
-      "prompts",
-      "rolling out to an app",
-      "choosing what to open",
-      "writing instructions",
-      "verifying an app"
-    ],
-    "rules": [
-      "Use current Akan APIs only",
-      "State the rule before the reason, and keep the reason to one clause",
-      "Name the env spelling beside every option field",
-      "Keep it workspace-neutral — no app or repo names"
-    ]
-  }
-}

package/guidelines/modelConstant/modelConstant.generate.json

@@ -1,32 +0,0 @@
-{
-  "title": "Model Constant",
-  "description": "Module constant generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/constant.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Constant",
-      "path": "apps/akan/page/(docs)/conventions/module/constant.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelConstant.instruction.md",
-    "contents": ["purpose", "file ownership", "current API patterns", "codegen rules", "validation checklist"],
-    "rules": [
-      "Use current Akan APIs only",
-      "Use double quotes for all string literals in TypeScript code",
-      "Keep output parseable for codegen",
-      "Include ownership boundaries and review checklist"
-    ]
-  },
-  "page": "apps/akan/page/(docs)/conventions/module/constant.tsx"
-}

package/guidelines/modelDictionary/modelDictionary.generate.json

@@ -1,32 +0,0 @@
-{
-  "title": "Model Dictionary",
-  "description": "Module dictionary generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/dictionary.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Dictionary",
-      "path": "apps/akan/page/(docs)/conventions/module/dictionary.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelDictionary.instruction.md",
-    "contents": ["purpose", "file ownership", "current API patterns", "codegen rules", "validation checklist"],
-    "rules": [
-      "Use current Akan APIs only",
-      "Use double quotes for all string literals in TypeScript code",
-      "Keep output parseable for codegen",
-      "Include ownership boundaries and review checklist"
-    ]
-  },
-  "page": "apps/akan/page/(docs)/conventions/module/dictionary.tsx"
-}

package/guidelines/modelDocument/modelDocument.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Document",
-  "description": "Module persistence generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/document.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Document",
-      "path": "apps/akan/page/(docs)/conventions/module/document.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelDocument.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)/conventions/module/document.tsx"
-}

package/guidelines/modelService/modelService.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Service",
-  "description": "Module service generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/service.tsx",
-  "codegenPriority": 2,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Service",
-      "path": "apps/akan/page/(docs)/conventions/module/service.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelService.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)/conventions/module/service.tsx"
-}

package/guidelines/modelSignal/modelSignal.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Signal",
-  "description": "Module signal generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/signal.tsx",
-  "codegenPriority": 2,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Signal",
-      "path": "apps/akan/page/(docs)/conventions/module/signal.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelSignal.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)/conventions/module/signal.tsx"
-}

package/guidelines/modelStore/modelStore.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Store",
-  "description": "Module store generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/store.tsx",
-  "codegenPriority": 2,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Store",
-      "path": "apps/akan/page/(docs)/conventions/module/store.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelStore.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)/conventions/module/store.tsx"
-}

package/guidelines/modelTemplate/modelTemplate.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Template",
-  "description": "Module form UI generation rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/template.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Template",
-      "path": "apps/akan/page/(docs)/conventions/module/template.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelTemplate.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)/conventions/module/template.tsx"
-}

package/guidelines/modelUnit/modelUnit.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Unit",
-  "description": "Module compact display UI rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/unit.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Unit",
-      "path": "apps/akan/page/(docs)/conventions/module/unit.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelUnit.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)/conventions/module/unit.tsx"
-}

package/guidelines/modelUtil/modelUtil.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Util",
-  "description": "Module utility UI rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/util.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Util",
-      "path": "apps/akan/page/(docs)/conventions/module/util.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelUtil.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)/conventions/module/util.tsx"
-}

package/guidelines/modelView/modelView.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model View",
-  "description": "Module full detail UI rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/view.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model View",
-      "path": "apps/akan/page/(docs)/conventions/module/view.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelView.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)/conventions/module/view.tsx"
-}

package/guidelines/modelZone/modelZone.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Model Zone",
-  "description": "Module page section UI rules",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/zone.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Model Zone",
-      "path": "apps/akan/page/(docs)/conventions/module/zone.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./modelZone.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)/conventions/module/zone.tsx"
-}

package/guidelines/moduleCodegen/moduleCodegen.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Module Codegen",
-  "description": "AI module generation orchestration",
-  "group": "module",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/overview.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Module Codegen",
-      "path": "apps/akan/page/(docs)/conventions/module/overview.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./moduleCodegen.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)/conventions/module/overview.tsx"
-}

package/guidelines/moduleCodegen/moduleCodegen.instruction.md

@@ -1,28 +0,0 @@
-# Module Codegen Orchestration Guideline
-
-## Purpose
-Use this to orchestrate AI-assisted module creation. The model should emit small, parseable file blocks and preserve Akan ownership boundaries.
-
-## 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.
-- Generated files must target `lib/<model>/...` or `lib/__scalar/<scalar>/...` only unless explicitly requested.
-
-## Current Akan Patterns
-- Phase 1: generate or update `model.constant.ts`, `model.dictionary.ts`, and `model.document.ts`.
-- Phase 2: generate service, signal, and store only when there are business workflows or page-callable actions.
-- Phase 3: generate UI files only after store/signal data flow is known.
-- Use docs-backed examples from the current app and connected libs before inventing patterns.
-
-## Codegen Rules
-- Return only file blocks for writes, plus no prose in codegen responses unless explicitly requested.
-- Prefer conservative defaults: one useful query, one insight only if analytics are requested, and minimal UI variants.
-- Avoid broad abstractions; create helper functions only when they remove clear duplication inside the target module.
-- When unsure whether a value should be scalar or module, choose scalar for embedded value objects and module for independent lifecycle or permissions.
-
-## 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/moduleOverview/moduleOverview.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Module Overview",
-  "description": "Module file roles and growth order",
-  "group": "core",
-  "docsSource": "apps/akan/page/(docs)/conventions/module/overview.tsx",
-  "codegenPriority": 1,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Module Overview",
-      "path": "apps/akan/page/(docs)/conventions/module/overview.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing Akan implementation examples",
-      "path": "{apps,libs}/*/lib/**/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./moduleOverview.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)/conventions/module/overview.tsx"
-}

package/guidelines/queryRule/queryRule.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Query Rule",
-  "description": "Akan data access — filters, slices and hydration, full-text search, and cascade removal",
-  "group": "core",
-  "codegenPriority": 4,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "example",
-      "description": "Filter and model declarations that drive the generated query surface",
-      "path": "{apps,libs}/*/lib/*/*.document.ts",
-      "sample": 4
-    },
-    {
-      "type": "example",
-      "description": "Slice declarations that expose a query to a client store",
-      "path": "{apps,libs}/*/lib/*/*.signal.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./queryRule.instruction.md",
-    "contents": ["slices and hydration", "generated filter methods", "text search", "cascade removal"],
-    "rules": [
-      "Use current Akan APIs only",
-      "State the rule and the reason it exists, never restate a type signature",
-      "Say which generated methods fire hooks and which do not",
-      "Keep it workspace-neutral — no app or repo names"
-    ]
-  }
-}

package/guidelines/recipeRule/recipeRule.generate.json

@@ -1,31 +0,0 @@
-{
-  "title": "Recipe Rule",
-  "description": "Akan UI recipe authoring and consumption rules (reusable-look layer)",
-  "group": "core",
-  "docsSource": "apps/akan/page/(docs)/docs/arch/ui-recipe.tsx",
-  "codegenPriority": 3,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "docs",
-      "description": "Current docs source for Recipe Rule",
-      "path": "apps/akan/page/(docs)/docs/arch/ui-recipe.tsx"
-    },
-    {
-      "type": "example",
-      "description": "Existing recipe definitions",
-      "path": "{apps,libs}/*/ui/Recipe/*.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./recipeRule.instruction.md",
-    "contents": ["purpose", "ownership", "consuming", "authoring", "codegen rules", "review checklist"],
-    "rules": [
-      "Use current Akan APIs only",
-      "Keep output parseable for codegen",
-      "Include ownership boundaries and review checklist"
-    ]
-  },
-  "page": "apps/akan/page/(docs)/docs/arch/ui-recipe.tsx"
-}

package/guidelines/runtimeRule/runtimeRule.generate.json

@@ -1,25 +0,0 @@
-{
-  "title": "Runtime Rule",
-  "description": "Akan build and runtime surfaces — web/csr toggles, the gateway/solo process model, logging, the generated image, and shipped assets",
-  "group": "core",
-  "codegenPriority": 4,
-  "deprecated": false,
-  "scans": [
-    {
-      "type": "example",
-      "description": "App and lib runtime declarations",
-      "path": "{apps,libs}/*/akan.config.ts",
-      "sample": 4
-    }
-  ],
-  "update": {
-    "filePath": "./runtimeRule.instruction.md",
-    "contents": ["web surface toggles", "process model", "logging and live tail", "generated image", "shipped assets"],
-    "rules": [
-      "Use current Akan APIs only",
-      "State the rule and the reason it exists, never restate a type signature",
-      "Name the env that narrows a build-time declaration wherever one exists",
-      "Keep it workspace-neutral — no app or repo names"
-    ]
-  }
-}