@loomweaver/devkit 0.7.6 → 0.7.8

package/src/recipes/angular-weaver/weaver-i18n.d.ts

@@ -1,3 +1,3 @@
-import { ResolvedWeaver } from './recipe';
+import type { ResolvedWeaver } from './recipe';
 export declare function i18nBundle(w: ResolvedWeaver): Record<string, unknown>;
 export declare function i18nFile(w: ResolvedWeaver): string;

package/src/recipes/angular-weaver/weaver-i18n.js

@@ -14,6 +14,17 @@ function i18nBundle(w) {
     }
     if (w.features.about)
         bundle['about'] = `About ${w.name}`;
+    if (w.features.agent) {
+        bundle['agent'] = {
+            title: `${w.name} assistant`,
+            confirm: {
+                title: 'Run this command?',
+                message: 'An agent asked to run a command that was marked consequential.',
+                yes: 'Run it',
+                no: 'Not now',
+            },
+        };
+    }
     if (w.features.settings)
         bundle['settings'] = { title: w.name, enabled: 'Enabled', note: 'Note' };
     return bundle;

package/src/recipes/angular-weaver/weaver-i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"weaver-i18n.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/angular-weaver/weaver-i18n.ts"],"names":[],"mappings":";;AAEA,gCAcC;AAED,4BAEC;AAlBD,SAAgB,UAAU,CAAC,CAAiB;IAC1C,MAAM,MAAM,GAA4B,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;QACtC,MAAM,CAAC,mBAAmB,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,WAAW,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK;QAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,QAAQ,CAAC,CAAiB;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AACvD,CAAC"}
+{"version":3,"file":"weaver-i18n.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/angular-weaver/weaver-i18n.ts"],"names":[],"mappings":";;AAEA,gCA0BC;AAED,4BAEC;AA9BD,SAAgB,UAAU,CAAC,CAAiB;IAC1C,MAAM,MAAM,GAA4B,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACzB,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC5B,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;QACtC,MAAM,CAAC,mBAAmB,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,WAAW,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK;QAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,CAAC,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,YAAY;YAC5B,OAAO,EAAE;gBACP,KAAK,EAAE,mBAAmB;gBAC1B,OAAO,EACL,gEAAgE;gBAClE,GAAG,EAAE,QAAQ;gBACb,EAAE,EAAE,SAAS;aACd;SACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ;QACrB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,QAAQ,CAAC,CAAiB;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AACvD,CAAC"}

package/src/recipes/angular-weaver/weaver-readme.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedWeaver } from './recipe';
+export declare function readmeFile(w: ResolvedWeaver): string;

package/src/recipes/angular-weaver/weaver-readme.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readmeFile = readmeFile;
+const weaver_terms_1 = require("./weaver-terms");
+function surfaceNotes(w) {
+    const railNote = 'Rail and bar items reference region ids (`primary`, `status`) that must exist in your layout.';
+    if (w.features.container) {
+        return [
+            `The surface is a **container**: it is routable at \`/${w.id}/:id\`, and its tab holds a`,
+            'nested pane tree of child surfaces. The host draws the inner tabs, splits and drag targets; this',
+            'weaver only declares which children it offers.',
+            '',
+            `- \`children\` is what the inner "new tab" picker lists — the host access-gates it for you.`,
+            '- `initial` is what a freshly opened container tab starts with.',
+            `- The children declare \`docks: []\`. That is the container-only convention: they are never seeded`,
+            '  into a sidebar, they exist solely inside this container.',
+            `- Each child reads the container's \`:id\` from an injected \`ActivatedRoute\` — the host supplies a`,
+            '  synthetic one, so a child needs no knowledge of where it is mounted. Two open container tabs are',
+            '  two independent trees, each scoped to its own id.',
+            `- The inner tree is **sealed**: a child cannot be dragged out, and nothing can be dragged in. It`,
+            '  travels with the tab, including into a sidebar or a pop-out window.',
+            '',
+            `The rail item opens the fixed id \`${weaver_terms_1.CONTAINER_EXAMPLE_ID}\`. Replace that with whatever the user`,
+            'actually picked — a document, a run, a project.',
+            '',
+            railNote,
+        ];
+    }
+    if (w.features.instanceable) {
+        return [
+            `The surface is **docked** into the \`primary\` region and marked \`instanceable\`, so the host shows a`,
+            'switcher for saving, naming, renaming and deleting several configurations of it, each with its own',
+            '`VIEW_STATE` blob.',
+            '',
+            'It is deliberately **not** routable. Named instances exist only for a docked surface — a routable',
+            'one holds the URL pane instead, and the host drops `instanceable` on that path. The rail item',
+            'therefore reveals the surface (`ctx.revealSurface`) rather than navigating to a URL, which focuses',
+            'it wherever the user has since moved it.',
+            '',
+            'The generated view already uses that blob for its sort order, because a hidden surface is destroyed',
+            'as soon as it is clean: state kept in a component field survives neither a tab switch nor',
+            'a collapsed sidebar, and never survived a reload. The rule is *evictable = reload-safe* — anything',
+            'that must not be lost goes through `VIEW_STATE`, and `set()` replaces the whole blob, so spread it.',
+            '',
+            railNote,
+        ];
+    }
+    return [
+        `The surface is routable at \`/${w.id}\`; ${railNote.charAt(0).toLowerCase()}${railNote.slice(1)}`,
+        '',
+        'A routable surface has **no `VIEW_STATE` handle** — injecting the token there throws. It owns a URL,',
+        'so anything shareable (a filter, the active sub-tab) belongs in route params or `subRoutes`, where it',
+        'survives a deep link too; unsaved edits are `DirtySurface`, and an instance that is expensive to',
+        "rebuild declares `retain: 'always'`. Generate with `--instanceable` for the docked, `VIEW_STATE`",
+        'flavour instead.',
+    ];
+}
+function agentNotes(w) {
+    return [
+        '',
+        '## The agent connection',
+        '',
+        `\`src/lib/agent/\` holds three files and one of them is meant to be thrown away.`,
+        '',
+        `- \`${w.id}-agent.ts\` is the connection: the workbench's own commands offered as tools, and a`,
+        '  seam where this weaver decides about a call before it runs. Nothing is registered twice — the',
+        '  list comes from the workbench, already narrowed by everything that would refuse the call.',
+        `- \`${w.id}-agent-panel.ts\` shows what is offered, the call as it streams, and the outcome.`,
+        `- \`${w.id}-agent-source.ts\` is a **stand-in**, not an assistant: it produces the protocol's own`,
+        '  events so the whole path runs before you have connected anything. Replace that one file with',
+        '  your transport and nothing else changes. No transport, credential or model is generated for',
+        '  you, because none of them can be guessed.',
+        '',
+        'Three things are easy to get wrong and invisible when they are, so the generated code does them',
+        'rather than explaining them: the offered list is asked for again every run, every event is handed',
+        'over unfiltered, and a decision before a call can only narrow what the workbench would have',
+        'allowed anyway.',
+        '',
+        `The generated weaver needs two packages your project may not carry yet:`,
+        '',
+        '```bash',
+        `npm i @loomweaver/ag-ui @ag-ui/core`,
+        '```',
+        '',
+        'The Nx generator and the CLI record them for you; the MCP route names them instead.',
+    ];
+}
+function readmeFile(w) {
+    return [
+        `# ${w.name} weaver`,
+        '',
+        `A LoomWeaver weaver (a domain plugin bundle). It consumes only the public \`@loomweaver/plugin-sdk\` contract.`,
+        '',
+        '## Wire it into a distribution',
+        '',
+        `1. Add the plugin to \`providePlugins\` in \`src/app/app.config.ts\`. It is **variadic** and`,
+        `   returns an array, so spread it:`,
+        '',
+        '   ```ts',
+        `   import { ${w.propertyName}Plugin } from '${w.importPath}';   // Nx: the workspace alias; without one, a relative path to this library's src/index.ts`,
+        `   ...providePlugins(${w.propertyName}Plugin),`,
+        '   ```',
+        '',
+        `2. Grant its capabilities (default-deny) via \`provideCapabilityGrants\`:`,
+        '',
+        '   ```ts',
+        `   provideCapabilityGrants({ '${w.id}': [${(0, weaver_terms_1.capabilityItems)(w.capabilities)}] });`,
+        '   ```',
+        '',
+        `3. Compose its translations with \`provideTranslationNamespaces('${w.id}')\` — and serve the`,
+        `   bundle by adding an assets glob to your application's build target, so the loader can fetch`,
+        `   \`/i18n/${w.id}/<lang>.json\` (the Nx generator adds this glob for you):`,
+        '',
+        '   ```json',
+        `   { "glob": "**/*.json", "input": "<path to this library>/src/lib/i18n", "output": "i18n/${w.id}" }`,
+        '   ```',
+        '',
+        `4. If your application compiles the shell's theme with Tailwind, name this library as a source`,
+        `   for it, so the utility classes in these templates are emitted. Tailwind also detects sources`,
+        `   by itself, but that depends on where it resolves the project root and on \`.gitignore\`, and`,
+        `   what the scaffold names covers the application alone (the Nx generator adds this line for`,
+        `   you). Applications scaffolded with \`--styles precompiled\` run no Tailwind and need nothing:`,
+        '',
+        '   ```css',
+        `   @source '<path from that stylesheet to this library>/src';`,
+        '   ```',
+        '',
+        ...surfaceNotes(w),
+        ...(w.features.agent ? agentNotes(w) : []),
+        '',
+        '## After scaffolding',
+        '',
+        '- `src/lib/i18n/de.json` starts as a copy of the English strings — translate it.',
+        `- A scaffolded command defaults its shortcut to \`mod+shift+<first letter of the id>\` — two weavers whose ids share a first letter collide; pass \`--shortcut\` or edit the command.`,
+        '- The project is generated **untagged**: Nx tags belong to your `depConstraints`, and inventing',
+        '  one would fail a lint policy you never opted this project into. If your workspace enforces',
+        '  module boundaries, give it tags your constraints allow — `--tags` at generation time, or',
+        '  `tags` in `project.json` afterwards.',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=weaver-readme.js.map

package/src/recipes/angular-weaver/weaver-readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaver-readme.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/angular-weaver/weaver-readme.ts"],"names":[],"mappings":"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"}

package/src/recipes/angular-weaver/weaver-terms.d.ts

@@ -0,0 +1,2 @@
+export declare const CONTAINER_EXAMPLE_ID = "example";
+export declare function capabilityItems(capabilities: readonly string[]): string;

package/src/recipes/angular-weaver/weaver-terms.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTAINER_EXAMPLE_ID = void 0;
+exports.capabilityItems = capabilityItems;
+exports.CONTAINER_EXAMPLE_ID = 'example';
+function capabilityItems(capabilities) {
+    return capabilities.map((capability) => `'${capability}'`).join(', ');
+}
+//# sourceMappingURL=weaver-terms.js.map

package/src/recipes/angular-weaver/weaver-terms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaver-terms.js","sourceRoot":"","sources":["../../../../../../../libs/tooling/devkit/src/recipes/angular-weaver/weaver-terms.ts"],"names":[],"mappings":";;;AAEA,0CAEC;AAJY,QAAA,oBAAoB,GAAG,SAAS,CAAC;AAE9C,SAAgB,eAAe,CAAC,YAA+B;IAC7D,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}