/ase-meta-mint

name: ase-meta-mint
argument-hint: "[--help|-h] [--type|-t uuid|sha1|const|var|class|func|path|name] [--count|-c <count>] [<hint>]"
description: >
    Mint an identifier or a name of a requested type out of a free-text
    hint: a UUID, a SHA-1 digest, a constant, variable, function, or
    class identifier, a path component, or a product-like name. Use when
    the user wants an identifier, id, symbol, slug, or name "minted",
    "coined", "derived", or "generated" from a description.
user-invocable: true
disable-model-invocation: false
effort: high

@${CLAUDE_SKILL_DIR}/../../meta/ase-control.md @${CLAUDE_SKILL_DIR}/../../meta/ase-skill.md @${CLAUDE_SKILL_DIR}/../../meta/ase-getopt.md

<purpose name="ase-meta-mint"> Mint an Identifier or Name </purpose>

<expand name="getopt" arg1="ase-meta-mint" arg2="--type|-t=(uuid|sha1|const|var|class|func|path|name) --count|-c=1"> $ARGUMENTS </expand>

<objective> *Mint* an identifier or a name of the requested type out of the following hint: <hint><getopt-arguments/></hint> </objective>

<flow>

1. <step id="STEP 1: Sanity Check Usage">

1. Set <type><getopt-option-type/></type> and set <hint/> to <getopt-arguments/> with any leading and trailing whitespace stripped.

2. Determine the number of identifiers to mint: set <count/> to <getopt-option-count/>; if <getopt-option-count/> is *non-numeric*, *less than 1*, or *greater than 100*, use the default *1* instead.

3. <if condition="<hint/> is empty AND <type/> is NOT `uuid`"> Only output the following <template/> and then immediately *STOP* processing the entire current skill -- every type except `uuid` needs a hint to derive anything from:

<template> ⧉ **ASE**: ✪ skill: **ase-meta-mint**, ▶ ERROR: expected a `<hint>` argument for type **<type/>** </template> </if>

4. Set <results></results> and <warning></warning> (set both to empty).

</step>

2. <step id="STEP 2: Mint Hash-Derived Identifiers" condition="<type/> is `uuid` or `sha1`">

1. Call the `ase_mint(type: "<type/>", hint: "<hint/>", count: <count/>)` tool of the `ase` MCP server and set <results/> to the returned lines of its `text` output, one identifier per line. You *MUST* *NOT* derive a UUID or a SHA-1 digest yourself -- only the tool hashes correctly and reproducibly.

2. <if condition="a line of the `text` output starts with `WARNING:`"> Remove that line from <results/> and set <warning/> to its text with the leading `WARNING:` stripped -- hashing a non-empty hint is deterministic, so <count/> was clamped to *1*. </if>

</step>

3. <step id="STEP 3: Derive Linguistic Identifiers" condition="<type/> is `const`, `var`, `class`, `func`, `path`, or `name`">

1. Distill <hint/> into its *essential words*: drop filler words, articles, and prepositions, keep the two to four words which carry the actual meaning, and order them from the most general to the most specific one. Prefer established terminology of the surrounding domain over invented wording. Do not output anything.

2. Assemble <count/> *distinct* candidates from these words, ordered best-first, honoring the rules of <type/>:

• `const`: an `UPPER_SNAKE_CASE` constant identifier such as

`FOO_BAR_QUUX` -- upper-case ASCII words joined by `_`, never starting with a digit.

• `var`: a `lowerCamelCase` variable identifier such as

`fooBarQuux` -- the *last* part *MUST* be a *substantive* (`Quux`) naming *what the value is*, never a verb, as a variable holds a thing and not an action.

• `func`: a `lowerCamelCase` function identifier such as

`fooBarQuux` -- the *first* part *MUST* be a *verb* (`foo`) naming *what the function does*, as a function performs an action and does not hold a thing.

• `class`: an `UpperCamelCase` class identifier such as

`FooBarQuux` -- a substantive phrase naming the modeled entity, in singular form and without a `The` prefix.

• `path`: a `kebab-case` path component such as

`foo-bar-quux` -- lower-case ASCII letters, digits, and `-` only, never starting or ending with `-`.

• `name`: an `UpperCamelCase` *product name* such as

`FooBarQuux` -- optimize for a *brand*, not for a description: short (preferably two to three syllables), pronounceable, memorable, and distinctive. Coinages, blends, and evocative metaphors are explicitly welcome here, and a plain concatenation of the hint words is explicitly not.

Store the candidates in <results/>. Do not output anything.

</step>

4. <step id="STEP 4: Render Result">

1. <if condition="<hint/> is empty"> Set <hint-shown>*(none -- random UUID)*</hint-shown>. </if> <else> Set <hint-shown><hint/></hint-shown>. </else>

2. Output the minted identifiers of <results/>, one per line and each enclosed in backticks, with the following <template/>:

<template> <ase-tpl-boxed title="MINT" subtitle="<type/>"> ● **HINT**: <hint-shown/>

○ `<result-1/>` ○ `<result-2/>` ○ [...] </ase-tpl-boxed> </template>

3. <if condition="<warning/> is non-empty"> Additionally output the following <template/> directly below the box:

<template> ⧉ **ASE**: ✪ skill: **ase-meta-mint**, ▶ WARNING: <warning/> </template> </if>

</step>

</flow>