← Public packages
@hypercubed/aksk
AKSK setup planner for coding agents: tailored install plans, live peer-tool versions, managed templates, paste-in validators.
AGENTS.md
50 lines · 1.9 KB · Markdown@hypercubed/aksk
Imports
import main from 'kody:@hypercubed/aksk'
import planSetup from 'kody:@hypercubed/aksk/plan-setup'
import resolveVersions from 'kody:@hypercubed/aksk/resolve-versions'
import renderTemplate from 'kody:@hypercubed/aksk/render-template'
import validatePaste from 'kody:@hypercubed/aksk/validate-paste'Smoke tests
Call the root export from execute after publish, then each named export with defaults:
import main from 'kody:@hypercubed/aksk'
await main() // => { package: '@hypercubed/aksk', exports: [...], note }import planSetup from 'kody:@hypercubed/aksk/plan-setup'
await planSetup({ hosts: ['opencode'], situation: 'new-repo' }) // => bootstrap lane absent
await planSetup({ situation: 'new-machine' }) // => opens with a prompt step: ask which agents
await planSetup({ situation: 'kit-contributor' }) // => steps: []import resolveVersions from 'kody:@hypercubed/aksk/resolve-versions'
await resolveVersions() // => offline pins + consumerSkills allowlist, no outbound fetchimport renderTemplate from 'kody:@hypercubed/aksk/render-template'
await renderTemplate({ template: 'routing-note' }) // => content contains AKSK:ROUTINGimport validatePaste from 'kody:@hypercubed/aksk/validate-paste'
await validatePaste({ kind: 'agents-md', content: 'hello' }) // => ok: false, ROUTING errorresolveVersions({ refresh: true }) performs outbound HTTPS to the npm registry; it needs host approval on first use and falls back to pins on failure.
Edge cases
- Unknown
hostinplanSetupdoes not throw — it plans with a warning to confirm vianpx skills list -g. - Unknown
templateinrenderTemplateand unknownkindinvalidatePastethrow with the known-value list. - No local side effects anywhere: no PATH checks, no file writes, no installs. The caller acts on outputs.