@voxgig/sdkgen 1.3.7 → 1.3.8

package/bin/voxgig-sdkgen

@@ -8,7 +8,7 @@ const { Shape, One } = require('shape')
 
 const { SdkGen } = require('../dist/sdkgen.js')
 
-const VERSION = '1.3.7'
+const VERSION = '1.3.8'
 const KONSOLE = console
 
 

package/dist/cmp/AgentGuide.d.ts

@@ -0,0 +1,2 @@
+declare const AgentGuide: import("jostraca").Component;
+export { AgentGuide };

package/dist/cmp/AgentGuide.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentGuide = void 0;
+const jostraca_1 = require("jostraca");
+const utility_1 = require("../utility");
+const AgentGuideContent_1 = require("./AgentGuideContent");
+const AgentGuideFeature_1 = require("./AgentGuideFeature");
+// Per-language agent guide. Emitted inside the ambient target folder (the Root
+// enters `Folder({ name: target.name })` before calling this, exactly as for
+// Readme), so it lands at `<lang>/AGENTS.md`. Then it drives the co-located
+// per-feature guides for this target.
+const AgentGuide = (0, jostraca_1.cmp)(function AgentGuide(props) {
+    const { target, ctx$ } = props;
+    const { model } = ctx$;
+    const Name = (0, AgentGuideContent_1.projectName)(model);
+    const lang = target.name;
+    const title = target.title || lang;
+    const surface = (0, AgentGuideContent_1.langCmd)(lang).note;
+    const features = (0, AgentGuideContent_1.activeFeatures)(model);
+    // go-cli/go-mcp disable the feature phase; ts/js lay features out as
+    // per-feature directories, the other SDK targets as flat files.
+    const featuresOn = (0, AgentGuideContent_1.featuresEnabled)(target);
+    const dirLayout = (0, AgentGuideContent_1.isDirLayout)(target);
+    (0, jostraca_1.File)({ name: 'AGENTS.md' }, () => {
+        (0, jostraca_1.Content)(`# ${Name} ${title} — Agent Guide
+
+${surface
+            ? surface + '\n\nGenerated from the shared model; see the [project guide](../AGENTS.md) for the full workflow.'
+            : `The ${title} client for the ${Name} API. This directory is **generated** — do not edit it by hand; change the model/template/component in \`.sdk/\` and regenerate. See the [project guide](../AGENTS.md) for the full workflow and the aontu model language.`}
+
+> Paths below (\`.sdk/…\`) are relative to the **project root** — one level up
+> from this \`${lang}/\` directory.
+
+## Regenerate this target
+
+\`\`\`bash
+cd ../.sdk
+npm run build        # only if you changed a component
+npm run generate     # refreshes this ${lang}/ directory
+\`\`\`
+
+Then build and test the generated output:
+
+${(0, AgentGuideContent_1.langCommandsBlock)(lang)}
+
+## What generates this target
+
+| Source | Path | Edit when… |
+| --- | --- | --- |
+| Target definition | \`.sdk/model/target/${lang}.aontu\` | deps, module, extension, phases change |
+| Templates | \`.sdk/tm/${lang}/\` | the file is the **same for every API** (runtime, transport, base classes) — copied verbatim with placeholder substitution |
+| Components | \`.sdk/src/cmp/${lang}/\` | the file's shape **depends on the API** (entities, constructor, README, tests) — TypeScript that walks the model |
+
+Decision rule: *same for every API → template; depends on the API →
+component.* After editing a component run \`npm run build\` before
+\`npm run generate\`; template-only edits just need \`npm run generate\`.
+
+`);
+        if (featuresOn && 0 < features.length) {
+            (0, jostraca_1.Content)(`## Features in this target
+
+`);
+            if (dirLayout) {
+                // ts/js: each feature is a directory under src/feature/ with its own guide.
+                features.forEach((f) => {
+                    const t = f.title ? ' — ' + f.title : '';
+                    (0, jostraca_1.Content)(`- [\`${f.name}\`](./src/feature/${f.name}/AGENTS.md)${t}
+`);
+                });
+                (0, jostraca_1.Content)(`
+Each feature's runtime and its own guide live in \`src/feature/<name>/\`.
+
+`);
+            }
+            else {
+                // go/py/php/rb/lua: flat files in the shared \`feature/\` package — no
+                // per-feature directory, so features are documented inline here.
+                (0, jostraca_1.Content)(`Each feature is a flat file in the \`feature/\` package. Its hooks and
+default activation come from \`.sdk/model/feature/<name>.aontu\`; customise
+the runtime under \`.sdk/tm/${lang}/feature/\` and regenerate.
+
+| Feature | Runtime file | Active hooks |
+| --- | --- | --- |
+`);
+                features.forEach((f) => {
+                    const file = (0, AgentGuideContent_1.featureRuntimeFile)(target, f);
+                    const hooks = (0, AgentGuideContent_1.featureHooks)(f);
+                    const hookList = hooks.length ? hooks.map((h) => '\`' + h + '\`').join(', ') : '—';
+                    const label = f.title ? `**${f.name}** — ${f.title}` : `**${f.name}**`;
+                    (0, jostraca_1.Content)(`| ${label} | \`feature/${file}\` | ${hookList} |
+`);
+                });
+                (0, jostraca_1.Content)(`
+`);
+            }
+        }
+        // Optional per-language enrichment (build/test specifics, idioms). Neutral
+        // content above stands alone; a language may add an AgentGuide_<lang>.
+        const AgentGuide_sdk = (0, utility_1.requirePath)(ctx$, `./cmp/${lang}/AgentGuide_${lang}`, { ignore: true });
+        if (AgentGuide_sdk) {
+            AgentGuide_sdk['AgentGuide']({ target });
+        }
+        (0, jostraca_1.Content)(`---
+
+Generated by [@voxgig/sdkgen](https://github.com/voxgig/sdkgen). See the
+[project guide](../AGENTS.md).
+`);
+    });
+    (0, jostraca_1.File)({ name: 'CLAUDE.md' }, () => {
+        (0, jostraca_1.Content)((0, AgentGuideContent_1.claudePointer)(`${Name} ${title}`));
+    });
+    // Co-located per-feature guide files — only for dir-layout targets (ts/js),
+    // where each feature has its own directory to hold the guide. Flat-layout
+    // targets document features inline above; phase-disabled targets
+    // (go-cli/go-mcp) get no feature docs at all.
+    if (featuresOn && dirLayout) {
+        features.forEach((feature) => {
+            (0, AgentGuideFeature_1.AgentGuideFeature)({ target, feature });
+        });
+    }
+    ctx$.log?.info?.({ point: 'generate-agentguide', target, note: 'target:' + lang });
+});
+exports.AgentGuide = AgentGuide;
+//# sourceMappingURL=AgentGuide.js.map

package/dist/cmp/AgentGuide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentGuide.js","sourceRoot":"","sources":["../../src/cmp/AgentGuide.ts"],"names":[],"mappings":"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"}

package/dist/cmp/AgentGuideContent.d.ts

@@ -0,0 +1,25 @@
+type LangCmd = {
+    install?: string;
+    build?: string;
+    test?: string;
+    viaMake?: boolean;
+    note?: string;
+};
+declare const LANG_CMD: Record<string, LangCmd>;
+declare function langCmd(name: string): LangCmd;
+declare function langCommandsBlock(name: string): string;
+declare function featuresEnabled(target: any): boolean;
+declare function isDirLayout(target: any): boolean;
+declare function featureBase(target: any): string;
+declare function featureRuntimeFile(target: any, feature: any): string;
+declare function featureHooks(feature: any): string[];
+declare function activeTargets(model: any): any[];
+declare function activeFeatures(model: any): any[];
+declare function activeEntities(model: any): any[];
+declare function projectName(model: any): string;
+declare function workflowSection(): string;
+declare function featureSection(): string;
+declare function customiseSection(): string;
+declare function aontuSection(): string;
+declare function claudePointer(title: string): string;
+export { LANG_CMD, langCmd, langCommandsBlock, featuresEnabled, isDirLayout, featureBase, featureRuntimeFile, featureHooks, activeTargets, activeFeatures, activeEntities, projectName, workflowSection, featureSection, customiseSection, aontuSection, claudePointer, };

package/dist/cmp/AgentGuideContent.js

@@ -0,0 +1,248 @@
+"use strict";
+// Shared prose for the generated agent guides (AGENTS.md files emitted at the
+// project top level, per target language, and per feature). The workflow, the
+// two-layer template/component model, and the aontu primer are identical for
+// every generated SDK, so they live here once and the three AgentGuide
+// components (AgentGuideTop / AgentGuide / AgentGuideFeature) render them.
+//
+// IMPORTANT: these guides ship INSIDE a generated SDK project, so every path is
+// consumer-relative (`.sdk/tm/<lang>/`, `.sdk/src/cmp/<lang>/`,
+// `.sdk/model/...`) — NOT the `project/.sdk/...` form used by the sdkgen repo's
+// own developer docs.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LANG_CMD = void 0;
+exports.langCmd = langCmd;
+exports.langCommandsBlock = langCommandsBlock;
+exports.featuresEnabled = featuresEnabled;
+exports.isDirLayout = isDirLayout;
+exports.featureBase = featureBase;
+exports.featureRuntimeFile = featureRuntimeFile;
+exports.featureHooks = featureHooks;
+exports.activeTargets = activeTargets;
+exports.activeFeatures = activeFeatures;
+exports.activeEntities = activeEntities;
+exports.projectName = projectName;
+exports.workflowSection = workflowSection;
+exports.featureSection = featureSection;
+exports.customiseSection = customiseSection;
+exports.aontuSection = aontuSection;
+exports.claudePointer = claudePointer;
+const jostraca_1 = require("jostraca");
+const types_1 = require("../types");
+const LANG_CMD = {
+    ts: { install: 'npm install', viaMake: true },
+    js: { install: 'npm install', viaMake: true },
+    go: { viaMake: true },
+    py: { install: 'pip install -e .', viaMake: true },
+    php: { install: 'composer install', viaMake: true },
+    rb: { install: 'bundle install', viaMake: true },
+    lua: { install: 'luarocks make', viaMake: true },
+    'go-cli': { build: 'go build ./...', note: 'A CLI surface, not an SDK client library.' },
+    'go-mcp': { build: 'go build ./...', note: 'An MCP server surface for AI agents, not an SDK client library.' },
+};
+exports.LANG_CMD = LANG_CMD;
+function langCmd(name) {
+    return LANG_CMD[name] || { viaMake: true };
+}
+// A fenced shell block of the per-target build/test commands, run **in the
+// target directory** (the per-language guide already lives there). Prefers the
+// target's Makefile recipes (`make build` / `make test`).
+function langCommandsBlock(name) {
+    const c = langCmd(name);
+    const lines = [];
+    if (c.install)
+        lines.push(c.install);
+    if (c.viaMake) {
+        lines.push('make build');
+        lines.push('make test');
+    }
+    else {
+        if (c.build)
+            lines.push(c.build);
+        if (c.test)
+            lines.push(c.test);
+    }
+    if (0 === lines.length) {
+        return `Build and test with \`${name}\`'s standard toolchain.\n`;
+    }
+    return '```bash\n# in this target directory (' + name + '/):\n' + lines.join('\n') + '\n```\n';
+}
+// --- feature layout helpers (targets differ) --------------------------------
+// Whether a target generates per-feature output at all. go-cli / go-mcp
+// disable the feature phase (`phase.feature.active: false`).
+function featuresEnabled(target) {
+    return target?.phase?.feature?.active !== false;
+}
+// ts/js lay each feature out as a directory `src/feature/<name>/`; the other
+// SDK targets (`srcfeature: false`) use flat files in a shared `feature/`
+// package. Drives where feature guides live / are referenced.
+function isDirLayout(target) {
+    return target?.srcfeature !== false;
+}
+function featureBase(target) {
+    return isDirLayout(target) ? 'src/feature' : 'feature';
+}
+// The generated runtime file for a feature in a flat-layout target:
+// `<name>_feature.<ext>` (go/py/rb/lua) or `<Name>Feature.php` (php).
+function featureRuntimeFile(target, feature) {
+    const ext = target?.ext || target?.name || '';
+    if ('php' === target?.name) {
+        return (feature.Name || feature.name) + 'Feature.php';
+    }
+    return feature.name + '_feature.' + ext;
+}
+// A feature's active hook-stage names (feature.hook.<Stage>.active === true),
+// sorted (each() marks map keys as key$).
+function featureHooks(feature) {
+    return (0, jostraca_1.each)(feature.hook || {})
+        .filter((h) => h && h.active)
+        .map((h) => h.name || h.key$)
+        .filter(Boolean);
+}
+// --- model readers (mirror the active-item pattern in ReadmeTop.ts) ---
+function activeTargets(model) {
+    const target = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.target`) || {};
+    return (0, jostraca_1.each)(target).filter((t) => t && t.active !== false);
+}
+function activeFeatures(model) {
+    const feature = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.feature`) || {};
+    return (0, jostraca_1.each)(feature).filter((f) => f && f.active !== false);
+}
+function activeEntities(model) {
+    const entity = (0, types_1.getModelPath)(model, `main.${types_1.KIT}.entity`) || {};
+    return (0, jostraca_1.each)(entity).filter((e) => e && e.active !== false);
+}
+function projectName(model) {
+    return model.Name || model.const?.Name || model.name || 'SDK';
+}
+// --- shared markdown sections -----------------------------------------------
+// (a) basic generation & updating.
+function workflowSection() {
+    return `## Generating and updating the SDK
+
+All generation is driven from the \`.sdk/\` directory. The generated language
+directories (\`ts/\`, \`go/\`, …) are **build output** — never edit them by
+hand; fix the model, a template, or a component and regenerate.
+
+\`\`\`bash
+cd .sdk
+npm run add-target <lang>     # scaffold a language target (ts js go py php rb lua ...)
+npm run add-feature <name>    # scaffold a feature (e.g. log, test)
+npm run build                 # compile .sdk/src/cmp -> .sdk/dist
+npm run generate              # emit/refresh the SDK into ../<lang>
+\`\`\`
+
+\`generate\` **merges** into existing files and does **not** re-apply
+placeholder substitution to merged content. If you ever see a literal
+\`ProjectName\` or \`GOMODULE\` in generated output, delete that one file and
+regenerate it fresh:
+
+\`\`\`bash
+rm <lang>/<the-file-with-the-placeholder>
+npm run generate
+\`\`\`
+
+Note: the \`voxgig-sdkgen\` CLI only *scaffolds* (\`target add\` /
+\`feature add\`). Generation itself runs via \`npm run generate\` (backed by
+\`@voxgig/model\`) — there is no \`generate\` CLI subcommand.
+`;
+}
+// (b) adding a new generated feature.
+function featureSection() {
+    return `## Adding a feature
+
+A **feature** is a pipeline extension: an object of hooks that fire at named
+stages of every entity operation (each target's guide documents its
+features). Built-in features are \`log\` and \`test\`.
+
+\`\`\`bash
+cd .sdk
+npm run add-feature <name>    # e.g. log  (comma-separated for several)
+npm run build && npm run generate
+\`\`\`
+
+To author a **new** feature:
+
+1. Define its model at \`.sdk/model/feature/<name>.aontu\` — \`name: key()\`,
+   \`title\`, \`version\`, \`active\`, \`config.options.active\`, a \`hook\`
+   map (\`<Stage>: active: true\`), and per-language \`deps\`.
+2. Register it in \`.sdk/model/feature/feature-index.aontu\` with
+   \`@"<name>.aontu"\`.
+3. Provide the per-language runtime under that target's feature template dir
+   (\`.sdk/tm/<lang>/src/feature/<name>/\` for ts/js, \`.sdk/tm/<lang>/feature/\`
+   otherwise) — the \`FEATURE_Name\` / \`FEATURE_VERSION\` placeholders are
+   substituted on \`add-feature\`.
+4. \`npm run add-feature <name> && npm run build && npm run generate\`.
+`;
+}
+// (c) customising the model and templates (the two-layer mental model).
+function customiseSection() {
+    return `## Customising: model, templates, components
+
+Each language target is generated from **two layers**:
+
+| Layer | Path | Nature |
+| --- | --- | --- |
+| **Templates** | \`.sdk/tm/<lang>/\` | Plain target-language source, copied verbatim with placeholder substitution. Edit when the file is the **same for every API** (transport, base classes, runtime, utilities). |
+| **Components** | \`.sdk/src/cmp/<lang>/\` | TypeScript that **generates** source by walking the model. Edit when the file's shape **depends on the API** (entity classes, the constructor, README, tests). |
+
+> Decision rule: *same for every API → template; depends on the API →
+> component.*
+
+Placeholders substituted on copy: \`ProjectName\` (Pascal-case SDK name),
+\`GOMODULE\` (Go module path), \`FEATURE_Name\` / \`FEATURE_VERSION\`, and the
+\`$$path$$\` interpolation of a model value (such as the name) in \`.aontu\`.
+
+Propagate a change: edit the template/component → \`npm run build\` (only
+needed if you touched a component) → \`npm run generate\`. Target shape and
+deps live in \`.sdk/model/target/<lang>.aontu\`; features in
+\`.sdk/model/feature/<name>.aontu\`.
+`;
+}
+// (d) how the aontu model language works.
+function aontuSection() {
+    return `## The model language (aontu, \`.aontu\` files)
+
+The model is one structured object assembled by **aontu** (a unification
+engine) from three sources: the API model (entities/operations, from the
+OpenAPI spec via \`@voxgig/apidef\`), the base schema, and the target/feature
+definitions in \`.sdk/model/\`. An \`.aontu\` file is a relaxed JSON (jsonic
+syntax) with unification semantics:
+
+| Syntax | Meaning |
+| --- | --- |
+| \`a: b: c: 1\` | Nested-object shorthand for \`a:{b:{c:1}}\`. |
+| \`&: { ... }\` | Schema applied to **every** child of a map (one rule, many entries). |
+| \`*default \\| type\` | A default value unified against a type (e.g. \`*true \\| boolean\`). |
+| \`name: key()\` | Bind a field to its map key (so \`feature: log: {}\` gets \`name: 'log'\`). |
+| \`$$path$$\` | Interpolate a model value into a string — e.g. the SDK \`name\`. |
+| \`@"file.aontu"\` | Include another fragment (how the index files work). |
+| \`x: .y\` | Reference another path's value (e.g. \`deps: ts: .js\`). |
+
+For example, the schema for every feature entry:
+
+\`\`\`aontu
+main: kit: feature: &: {
+  name: key()
+  active: *false | boolean
+  title: string
+  version: *'0.0.1' | string
+  hook: &: { active: *false | boolean, await: *false | boolean }
+}
+\`\`\`
+
+Caveat: literal disjunctions (\`'prod' | 'peer' | 'dev'\`) are fragile in
+aontu, so the model uses \`*'prod' | string\` and enforces the enum in code —
+do not "fix" these into literal disjunctions.
+`;
+}
+// A thin CLAUDE.md that points at the sibling AGENTS.md (same directory).
+function claudePointer(title) {
+    return `# ${title}
+
+This project uses **AGENTS.md** as the operating guide for coding agents.
+
+See [AGENTS.md](./AGENTS.md).
+`;
+}
+//# sourceMappingURL=AgentGuideContent.js.map

package/dist/cmp/AgentGuideContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentGuideContent.js","sourceRoot":"","sources":["../../src/cmp/AgentGuideContent.ts"],"names":[],"mappings":"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"}

package/dist/cmp/AgentGuideFeature.d.ts

@@ -0,0 +1,2 @@
+declare const AgentGuideFeature: import("jostraca").Component;
+export { AgentGuideFeature };

package/dist/cmp/AgentGuideFeature.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentGuideFeature = void 0;
+const jostraca_1 = require("jostraca");
+const AgentGuideContent_1 = require("./AgentGuideContent");
+function cap(s) {
+    return s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+}
+// Per-feature agent guide, co-located with the feature's generated runtime.
+// Invoked from AgentGuide inside the ambient target folder, so it lands at
+// `<lang>/src/feature/<name>/AGENTS.md`.
+const AgentGuideFeature = (0, jostraca_1.cmp)(function AgentGuideFeature(props) {
+    const { target, feature, ctx$ } = props;
+    const name = feature.name;
+    const Name = feature.Name || cap(name);
+    const title = feature.title || `${Name} feature`;
+    const version = feature.version || '0.0.1';
+    const lang = target.name;
+    // Active hook stages (feature.hook.<Stage>.active === true).
+    const hooks = (0, jostraca_1.each)(feature.hook || {})
+        .filter((h) => h && h.active)
+        .map((h) => h.name || h.key$)
+        .filter(Boolean);
+    const defaultOn = true === feature?.config?.options?.active;
+    (0, jostraca_1.Folder)({ name: 'src/feature/' + name }, () => {
+        (0, jostraca_1.File)({ name: 'AGENTS.md' }, () => {
+            (0, jostraca_1.Content)(`# ${Name}Feature — Agent Guide
+
+${title} (v${version}).
+
+A **feature** is a pipeline extension: an object of hooks that fire at named
+stages of every entity operation (load, list, create, update, remove) and of
+the SDK/entity lifecycle. Features are how you inspect or modify the request
+pipeline without forking the SDK. This directory holds the **generated**
+runtime for the \`${name}\` feature in the ${target.title || lang} target — do
+not edit it by hand; change its template/model in \`.sdk/\` and regenerate.
+
+Active by default: **${defaultOn ? 'yes' : 'no'}** (\`config.options.active\`
+in the model). ${defaultOn
+                ? 'It runs unless disabled.'
+                : 'It only runs when explicitly enabled (e.g. the `test` feature is switched on for test mode).'}
+
+`);
+            if (0 < hooks.length) {
+                (0, jostraca_1.Content)(`## Hooks it fires
+
+${hooks.map((h) => `- \`${h}\``).join('\n')}
+
+Each active hook runs at its pipeline stage in feature-registration order, so a
+later feature can override an earlier one.
+
+`);
+            }
+            (0, jostraca_1.Content)(`## Where it is defined
+
+| Part | Path |
+| --- | --- |
+| Model definition | \`.sdk/model/feature/${name}.aontu\` (name, title, version, \`config.options.active\`, the \`hook\` map, per-language \`deps\`) |
+| Registered in | \`.sdk/model/feature/feature-index.aontu\` (\`@"${name}.aontu"\`) |
+| Runtime template | \`.sdk/tm/${lang}/src/feature/${name}/\` (copied here on \`generate\`; \`FEATURE_Name\`/\`FEATURE_VERSION\` substituted) |
+
+(Paths are relative to the **project root** — four levels up from here.)
+
+## Customising this feature
+
+- **Turn hooks on/off**: edit the \`hook\` map in
+  \`.sdk/model/feature/${name}.aontu\` (\`<Stage>: active: true|false\`).
+- **Change default activation**: set \`config.options.active\` in the same file.
+- **Dependencies**: edit \`deps.<lang>\` in the same file.
+- **Behaviour**: edit the runtime template under
+  \`.sdk/tm/${lang}/src/feature/${name}/\`, then regenerate.
+
+After any change: \`cd ../../../../.sdk && npm run generate\` (add
+\`npm run build\` first if you changed a component). If a regenerated file
+shows a literal \`FEATURE_Name\`/\`ProjectName\`, delete it and regenerate.
+
+To author a **new** feature, copy this one's model + template shape — see the
+[project guide](../../../../AGENTS.md) and the
+[${target.title || lang} guide](../../../AGENTS.md).
+`);
+        });
+        (0, jostraca_1.File)({ name: 'CLAUDE.md' }, () => {
+            (0, jostraca_1.Content)((0, AgentGuideContent_1.claudePointer)(`${Name}Feature (${lang})`));
+        });
+    });
+    ctx$.log?.info?.({
+        point: 'generate-agentguide-feature', target, feature,
+        note: 'target:' + lang + ', feature:' + name,
+    });
+});
+exports.AgentGuideFeature = AgentGuideFeature;
+//# sourceMappingURL=AgentGuideFeature.js.map

package/dist/cmp/AgentGuideFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentGuideFeature.js","sourceRoot":"","sources":["../../src/cmp/AgentGuideFeature.ts"],"names":[],"mappings":"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"}

package/dist/cmp/AgentGuideTop.d.ts

@@ -0,0 +1,2 @@
+declare const AgentGuideTop: import("jostraca").Component;
+export { AgentGuideTop };

package/dist/cmp/AgentGuideTop.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentGuideTop = void 0;
+const jostraca_1 = require("jostraca");
+const AgentGuideContent_1 = require("./AgentGuideContent");
+// Top-level agent guide for a generated SDK project. Emitted once at the
+// project root (no enclosing Folder), alongside README.md/Makefile. Teaches a
+// coding agent how to operate the whole project: regenerate, add features,
+// customise the model/templates, and read the aontu model language.
+const AgentGuideTop = (0, jostraca_1.cmp)(function AgentGuideTop(props) {
+    const { ctx$ } = props;
+    const { model } = ctx$;
+    if (model.name && !model.Name)
+        (0, jostraca_1.names)(model, model.name);
+    const Name = (0, AgentGuideContent_1.projectName)(model);
+    const targets = (0, AgentGuideContent_1.activeTargets)(model);
+    const features = (0, AgentGuideContent_1.activeFeatures)(model);
+    const entities = (0, AgentGuideContent_1.activeEntities)(model);
+    (0, jostraca_1.File)({ name: 'AGENTS.md' }, () => {
+        (0, jostraca_1.Content)(`# ${Name} SDK — Agent Guide
+
+This is a **generated** multi-language SDK project. The client libraries in
+each language directory are produced by [@voxgig/sdkgen](https://github.com/voxgig/sdkgen)
+from an API model; the generator, model, templates, and components all live in
+\`.sdk/\`. Treat the language directories as build output — change the model,
+a template, or a component and regenerate.
+
+There are companion guides deeper in the tree: one per language
+(\`<lang>/AGENTS.md\`) and one per feature
+(\`<lang>/src/feature/<name>/AGENTS.md\`).
+
+## Project map
+
+`);
+        // Targets
+        if (0 < targets.length) {
+            (0, jostraca_1.Content)(`**Targets** (${targets.length}):
+
+| Target | Directory | Build guide |
+| --- | --- | --- |
+`);
+            targets.forEach((t) => {
+                const note = (0, AgentGuideContent_1.langCmd)(t.name).note ? ' — ' + (0, AgentGuideContent_1.langCmd)(t.name).note : '';
+                (0, jostraca_1.Content)(`| \`${t.name}\` | \`${t.name}/\`${note} | [\`${t.name}/AGENTS.md\`](./${t.name}/AGENTS.md) |
+`);
+            });
+            (0, jostraca_1.Content)(`
+`);
+        }
+        // Features
+        if (0 < features.length) {
+            (0, jostraca_1.Content)(`**Features** (${features.length}): `);
+            (0, jostraca_1.Content)(features.map((f) => `\`${f.name}\``).join(', ') + `.
+
+Each feature is generated into every SDK target — as a directory
+\`<lang>/src/feature/<name>/\` (ts/js) or a flat file in the \`<lang>/feature/\`
+package (other languages). Each target's guide documents its features.
+
+`);
+        }
+        // Entities
+        if (0 < entities.length) {
+            (0, jostraca_1.Content)(`**Entities** (${entities.length}): `);
+            (0, jostraca_1.Content)(entities.map((e) => `\`${e.Name || e.name}\``).join(', ') + `.
+
+`);
+        }
+        (0, jostraca_1.Content)((0, AgentGuideContent_1.workflowSection)());
+        (0, jostraca_1.Content)((0, AgentGuideContent_1.featureSection)());
+        (0, jostraca_1.Content)((0, AgentGuideContent_1.customiseSection)());
+        (0, jostraca_1.Content)((0, AgentGuideContent_1.aontuSection)());
+        (0, jostraca_1.Content)(`## Where things live
+
+\`\`\`
+.sdk/
+  model/          the model: target/, feature/, and index .aontu files
+  src/cmp/<lang>/  components — TypeScript that generates API-specific source
+  tm/<lang>/       templates — verbatim source copied with placeholders
+  dist/            compiled components (npm run build)
+<lang>/           generated SDK for each target (build output)
+README.md         human-facing overview
+Makefile          per-target deploy recipes
+\`\`\`
+
+---
+
+Generated by [@voxgig/sdkgen](https://github.com/voxgig/sdkgen). Regenerate
+with \`cd .sdk && npm run generate\`.
+`);
+    });
+    (0, jostraca_1.File)({ name: 'CLAUDE.md' }, () => {
+        (0, jostraca_1.Content)((0, AgentGuideContent_1.claudePointer)(`${Name} SDK`));
+    });
+    ctx$.log?.info?.({ point: 'generate-agentguide-top', note: 'name:' + Name });
+});
+exports.AgentGuideTop = AgentGuideTop;
+//# sourceMappingURL=AgentGuideTop.js.map

package/dist/cmp/AgentGuideTop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentGuideTop.js","sourceRoot":"","sources":["../../src/cmp/AgentGuideTop.ts"],"names":[],"mappings":"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"}