Skip to content
← 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 fetch
import renderTemplate from 'kody:@hypercubed/aksk/render-template'
await renderTemplate({ template: 'routing-note' }) // => content contains AKSK:ROUTING
import validatePaste from 'kody:@hypercubed/aksk/validate-paste'
await validatePaste({ kind: 'agents-md', content: 'hello' }) // => ok: false, ROUTING error

resolveVersions({ 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 host in planSetup does not throw — it plans with a warning to confirm via npx skills list -g.
  • Unknown template in renderTemplate and unknown kind in validatePaste throw with the known-value list.
  • No local side effects anywhere: no PATH checks, no file writes, no installs. The caller acts on outputs.