@devenius/junamis-skills 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +150 -0
- package/LICENSE +21 -0
- package/README.md +231 -2
- package/SECURITY.md +81 -0
- package/bin/junamis-skills.js +7 -0
- package/dist/cli.d.ts +59 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +564 -0
- package/dist/cli.js.map +1 -0
- package/dist/color.d.ts +40 -0
- package/dist/color.d.ts.map +1 -0
- package/dist/color.js +55 -0
- package/dist/color.js.map +1 -0
- package/dist/design/atomic.d.ts +4 -0
- package/dist/design/atomic.d.ts.map +1 -0
- package/dist/design/atomic.js +14 -0
- package/dist/design/atomic.js.map +1 -0
- package/dist/design/bootstrap.d.ts +23 -0
- package/dist/design/bootstrap.d.ts.map +1 -0
- package/dist/design/bootstrap.js +411 -0
- package/dist/design/bootstrap.js.map +1 -0
- package/dist/design/cli.d.ts +86 -0
- package/dist/design/cli.d.ts.map +1 -0
- package/dist/design/cli.js +425 -0
- package/dist/design/cli.js.map +1 -0
- package/dist/design/delta.d.ts +45 -0
- package/dist/design/delta.d.ts.map +1 -0
- package/dist/design/delta.js +557 -0
- package/dist/design/delta.js.map +1 -0
- package/dist/design/drift.d.ts +26 -0
- package/dist/design/drift.d.ts.map +1 -0
- package/dist/design/drift.js +341 -0
- package/dist/design/drift.js.map +1 -0
- package/dist/design/errors.d.ts +25 -0
- package/dist/design/errors.d.ts.map +1 -0
- package/dist/design/errors.js +30 -0
- package/dist/design/errors.js.map +1 -0
- package/dist/design/events.d.ts +18 -0
- package/dist/design/events.d.ts.map +1 -0
- package/dist/design/events.js +44 -0
- package/dist/design/events.js.map +1 -0
- package/dist/design/fingerprint.d.ts +10 -0
- package/dist/design/fingerprint.d.ts.map +1 -0
- package/dist/design/fingerprint.js +66 -0
- package/dist/design/fingerprint.js.map +1 -0
- package/dist/design/index-gen.d.ts +16 -0
- package/dist/design/index-gen.d.ts.map +1 -0
- package/dist/design/index-gen.js +94 -0
- package/dist/design/index-gen.js.map +1 -0
- package/dist/design/schema.d.ts +54 -0
- package/dist/design/schema.d.ts.map +1 -0
- package/dist/design/schema.js +408 -0
- package/dist/design/schema.js.map +1 -0
- package/dist/design/yaml.d.ts +12 -0
- package/dist/design/yaml.d.ts.map +1 -0
- package/dist/design/yaml.js +264 -0
- package/dist/design/yaml.js.map +1 -0
- package/dist/external.d.ts +61 -0
- package/dist/external.d.ts.map +1 -0
- package/dist/external.js +426 -0
- package/dist/external.js.map +1 -0
- package/dist/guide.d.ts +17 -0
- package/dist/guide.d.ts.map +1 -0
- package/dist/guide.js +219 -0
- package/dist/guide.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/dist/install-external.d.ts +3 -0
- package/dist/install-external.d.ts.map +1 -0
- package/dist/install-external.js +37 -0
- package/dist/install-external.js.map +1 -0
- package/dist/library-install.d.ts +39 -0
- package/dist/library-install.d.ts.map +1 -0
- package/dist/library-install.js +663 -0
- package/dist/library-install.js.map +1 -0
- package/dist/orchestrator/boot.d.ts +3 -0
- package/dist/orchestrator/boot.d.ts.map +1 -0
- package/dist/orchestrator/boot.js +515 -0
- package/dist/orchestrator/boot.js.map +1 -0
- package/dist/orchestrator/cli.d.ts +37 -0
- package/dist/orchestrator/cli.d.ts.map +1 -0
- package/dist/orchestrator/cli.js +563 -0
- package/dist/orchestrator/cli.js.map +1 -0
- package/dist/orchestrator/commands.d.ts +46 -0
- package/dist/orchestrator/commands.d.ts.map +1 -0
- package/dist/orchestrator/commands.js +752 -0
- package/dist/orchestrator/commands.js.map +1 -0
- package/dist/orchestrator/compaction.d.ts +21 -0
- package/dist/orchestrator/compaction.d.ts.map +1 -0
- package/dist/orchestrator/compaction.js +93 -0
- package/dist/orchestrator/compaction.js.map +1 -0
- package/dist/orchestrator/drift.d.ts +11 -0
- package/dist/orchestrator/drift.d.ts.map +1 -0
- package/dist/orchestrator/drift.js +181 -0
- package/dist/orchestrator/drift.js.map +1 -0
- package/dist/orchestrator/errors.d.ts +52 -0
- package/dist/orchestrator/errors.d.ts.map +1 -0
- package/dist/orchestrator/errors.js +96 -0
- package/dist/orchestrator/errors.js.map +1 -0
- package/dist/orchestrator/frontmatter.d.ts +6 -0
- package/dist/orchestrator/frontmatter.d.ts.map +1 -0
- package/dist/orchestrator/frontmatter.js +50 -0
- package/dist/orchestrator/frontmatter.js.map +1 -0
- package/dist/orchestrator/fsx.d.ts +45 -0
- package/dist/orchestrator/fsx.d.ts.map +1 -0
- package/dist/orchestrator/fsx.js +295 -0
- package/dist/orchestrator/fsx.js.map +1 -0
- package/dist/orchestrator/handoff.d.ts +8 -0
- package/dist/orchestrator/handoff.d.ts.map +1 -0
- package/dist/orchestrator/handoff.js +246 -0
- package/dist/orchestrator/handoff.js.map +1 -0
- package/dist/orchestrator/hash.d.ts +10 -0
- package/dist/orchestrator/hash.d.ts.map +1 -0
- package/dist/orchestrator/hash.js +65 -0
- package/dist/orchestrator/hash.js.map +1 -0
- package/dist/orchestrator/journal.d.ts +35 -0
- package/dist/orchestrator/journal.d.ts.map +1 -0
- package/dist/orchestrator/journal.js +163 -0
- package/dist/orchestrator/journal.js.map +1 -0
- package/dist/orchestrator/lease.d.ts +31 -0
- package/dist/orchestrator/lease.d.ts.map +1 -0
- package/dist/orchestrator/lease.js +175 -0
- package/dist/orchestrator/lease.js.map +1 -0
- package/dist/orchestrator/plan.d.ts +27 -0
- package/dist/orchestrator/plan.d.ts.map +1 -0
- package/dist/orchestrator/plan.js +240 -0
- package/dist/orchestrator/plan.js.map +1 -0
- package/dist/orchestrator/report.d.ts +49 -0
- package/dist/orchestrator/report.d.ts.map +1 -0
- package/dist/orchestrator/report.js +244 -0
- package/dist/orchestrator/report.js.map +1 -0
- package/dist/orchestrator/state.d.ts +43 -0
- package/dist/orchestrator/state.d.ts.map +1 -0
- package/dist/orchestrator/state.js +369 -0
- package/dist/orchestrator/state.js.map +1 -0
- package/dist/orchestrator/store.d.ts +42 -0
- package/dist/orchestrator/store.d.ts.map +1 -0
- package/dist/orchestrator/store.js +202 -0
- package/dist/orchestrator/store.js.map +1 -0
- package/dist/orchestrator/test-hooks.d.ts +5 -0
- package/dist/orchestrator/test-hooks.d.ts.map +1 -0
- package/dist/orchestrator/test-hooks.js +31 -0
- package/dist/orchestrator/test-hooks.js.map +1 -0
- package/dist/orchestrator/time.d.ts +11 -0
- package/dist/orchestrator/time.d.ts.map +1 -0
- package/dist/orchestrator/time.js +38 -0
- package/dist/orchestrator/time.js.map +1 -0
- package/dist/paths.d.ts +9 -0
- package/dist/paths.d.ts.map +1 -0
- package/dist/paths.js +42 -0
- package/dist/paths.js.map +1 -0
- package/dist/pinned-source.d.ts +13 -0
- package/dist/pinned-source.d.ts.map +1 -0
- package/dist/pinned-source.js +238 -0
- package/dist/pinned-source.js.map +1 -0
- package/dist/reconcile/cli.d.ts +17 -0
- package/dist/reconcile/cli.d.ts.map +1 -0
- package/dist/reconcile/cli.js +171 -0
- package/dist/reconcile/cli.js.map +1 -0
- package/dist/reconcile/detectors.d.ts +29 -0
- package/dist/reconcile/detectors.d.ts.map +1 -0
- package/dist/reconcile/detectors.js +294 -0
- package/dist/reconcile/detectors.js.map +1 -0
- package/dist/reconcile/manifest.d.ts +11 -0
- package/dist/reconcile/manifest.d.ts.map +1 -0
- package/dist/reconcile/manifest.js +118 -0
- package/dist/reconcile/manifest.js.map +1 -0
- package/dist/reconcile/queue.d.ts +3 -0
- package/dist/reconcile/queue.d.ts.map +1 -0
- package/dist/reconcile/queue.js +723 -0
- package/dist/reconcile/queue.js.map +1 -0
- package/dist/reconcile/score.d.ts +19 -0
- package/dist/reconcile/score.d.ts.map +1 -0
- package/dist/reconcile/score.js +58 -0
- package/dist/reconcile/score.js.map +1 -0
- package/dist/scripts/check-opencode-config.d.ts +12 -0
- package/dist/scripts/check-opencode-config.d.ts.map +1 -0
- package/dist/scripts/check-opencode-config.js +216 -0
- package/dist/scripts/check-opencode-config.js.map +1 -0
- package/dist/scripts/check-pack.d.ts +3 -0
- package/dist/scripts/check-pack.d.ts.map +1 -0
- package/dist/scripts/check-pack.js +74 -0
- package/dist/scripts/check-pack.js.map +1 -0
- package/dist/scripts/check-pins.d.ts +9 -0
- package/dist/scripts/check-pins.d.ts.map +1 -0
- package/dist/scripts/check-pins.js +65 -0
- package/dist/scripts/check-pins.js.map +1 -0
- package/dist/scripts/check-security.d.ts +3 -0
- package/dist/scripts/check-security.d.ts.map +1 -0
- package/dist/scripts/check-security.js +47 -0
- package/dist/scripts/check-security.js.map +1 -0
- package/dist/scripts/check-skills-lock.d.ts +7 -0
- package/dist/scripts/check-skills-lock.d.ts.map +1 -0
- package/dist/scripts/check-skills-lock.js +36 -0
- package/dist/scripts/check-skills-lock.js.map +1 -0
- package/dist/scripts/check-skills-sync.d.ts +7 -0
- package/dist/scripts/check-skills-sync.d.ts.map +1 -0
- package/dist/scripts/check-skills-sync.js +146 -0
- package/dist/scripts/check-skills-sync.js.map +1 -0
- package/dist/scripts/check-yaml.d.ts +3 -0
- package/dist/scripts/check-yaml.d.ts.map +1 -0
- package/dist/scripts/check-yaml.js +41 -0
- package/dist/scripts/check-yaml.js.map +1 -0
- package/dist/scripts/publish-npm.d.ts +3 -0
- package/dist/scripts/publish-npm.d.ts.map +1 -0
- package/dist/scripts/publish-npm.js +67 -0
- package/dist/scripts/publish-npm.js.map +1 -0
- package/dist/scripts/release-check.d.ts +3 -0
- package/dist/scripts/release-check.d.ts.map +1 -0
- package/dist/scripts/release-check.js +97 -0
- package/dist/scripts/release-check.js.map +1 -0
- package/dist/scripts/support.d.ts +41 -0
- package/dist/scripts/support.d.ts.map +1 -0
- package/dist/scripts/support.js +78 -0
- package/dist/scripts/support.js.map +1 -0
- package/dist/targets/claude.d.ts +4 -0
- package/dist/targets/claude.d.ts.map +1 -0
- package/dist/targets/claude.js +42 -0
- package/dist/targets/claude.js.map +1 -0
- package/dist/targets/cline.d.ts +4 -0
- package/dist/targets/cline.d.ts.map +1 -0
- package/dist/targets/cline.js +39 -0
- package/dist/targets/cline.js.map +1 -0
- package/dist/targets/cursor.d.ts +4 -0
- package/dist/targets/cursor.d.ts.map +1 -0
- package/dist/targets/cursor.js +40 -0
- package/dist/targets/cursor.js.map +1 -0
- package/dist/targets/index.d.ts +4 -0
- package/dist/targets/index.d.ts.map +1 -0
- package/dist/targets/index.js +11 -0
- package/dist/targets/index.js.map +1 -0
- package/dist/targets/opencode.d.ts +4 -0
- package/dist/targets/opencode.d.ts.map +1 -0
- package/dist/targets/opencode.js +48 -0
- package/dist/targets/opencode.js.map +1 -0
- package/dist/targets/windsurf.d.ts +4 -0
- package/dist/targets/windsurf.d.ts.map +1 -0
- package/dist/targets/windsurf.js +41 -0
- package/dist/targets/windsurf.js.map +1 -0
- package/dist/types/common.d.ts +193 -0
- package/dist/types/common.d.ts.map +1 -0
- package/dist/types/common.js +6 -0
- package/dist/types/common.js.map +1 -0
- package/dist/types/design.d.ts +185 -0
- package/dist/types/design.d.ts.map +1 -0
- package/dist/types/design.js +3 -0
- package/dist/types/design.js.map +1 -0
- package/dist/types/guards.d.ts +13 -0
- package/dist/types/guards.d.ts.map +1 -0
- package/dist/types/guards.js +64 -0
- package/dist/types/guards.js.map +1 -0
- package/dist/types/handoff.d.ts +29 -0
- package/dist/types/handoff.d.ts.map +1 -0
- package/dist/types/handoff.js +3 -0
- package/dist/types/handoff.js.map +1 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +11 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/orchestrator.d.ts +414 -0
- package/dist/types/orchestrator.d.ts.map +1 -0
- package/dist/types/orchestrator.js +4 -0
- package/dist/types/orchestrator.js.map +1 -0
- package/dist/types/reconcile.d.ts +160 -0
- package/dist/types/reconcile.d.ts.map +1 -0
- package/dist/types/reconcile.js +3 -0
- package/dist/types/reconcile.js.map +1 -0
- package/docs/RECONCILE.md +505 -0
- package/docs/design/_schema.md +506 -0
- package/junamis-skills.yml +328 -0
- package/library/EXTERNAL.md +35 -0
- package/library/HANDOFF.md +93 -0
- package/library/RESUME.md +429 -0
- package/library/SAFETY.md +83 -0
- package/library/agents/context-keeper.md +41 -0
- package/library/agents/frontend.md +43 -0
- package/library/agents/maintainer.md +44 -0
- package/library/agents/nestjs.md +40 -0
- package/library/agents/nextjs.md +40 -0
- package/library/agents/operator.md +42 -0
- package/library/agents/orchestrator.md +313 -0
- package/library/agents/researcher.md +40 -0
- package/library/agents/reviewer.md +40 -0
- package/library/skills/db-migrate/SKILL.md +50 -0
- package/library/skills/decision-record/SKILL.md +74 -0
- package/library/skills/dependency-upgrade/SKILL.md +57 -0
- package/library/skills/deploy-verify/SKILL.md +51 -0
- package/library/skills/document/SKILL.md +51 -0
- package/library/skills/env-doctor/SKILL.md +65 -0
- package/library/skills/frontend/SKILL.md +63 -0
- package/library/skills/handoff/SKILL.md +79 -0
- package/library/skills/incident-response/SKILL.md +69 -0
- package/library/skills/nestjs/SKILL.md +49 -0
- package/library/skills/nextjs/SKILL.md +48 -0
- package/library/skills/perf-budget/SKILL.md +62 -0
- package/library/skills/refactor-safely/SKILL.md +48 -0
- package/library/skills/release-prep/SKILL.md +75 -0
- package/library/skills/research/SKILL.md +66 -0
- package/library/skills/rollback/SKILL.md +49 -0
- package/library/skills/route/SKILL.md +107 -0
- package/library/skills/route-external/SKILL.md +67 -0
- package/library/skills/security-audit/SKILL.md +64 -0
- package/library/skills/skill-author/SKILL.md +49 -0
- package/opencode.json +5906 -0
- package/package.json +88 -4
- package/scripts/design-registry.mjs +7 -0
- package/scripts/orchestrator-state.mjs +7 -0
- package/scripts/reconcile.mjs +7 -0
- package/skills-lock.json +197 -0
package/dist/guide.js
ADDED
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { mkdir, readFile, readdir, writeFile, rename, rm } from "node:fs/promises";
|
|
3
|
+
import { basename, dirname, join, resolve } from "node:path";
|
|
4
|
+
import { fileURLToPath } from "node:url";
|
|
5
|
+
import { isRecord, parseJsonUnknown } from "./types/guards.js";
|
|
6
|
+
export const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
|
|
7
|
+
export const GUIDE_NAME = "junamis-skills-guide.md";
|
|
8
|
+
export const MARKER_PATH = join(".junamis", "junamis-skills.json");
|
|
9
|
+
async function atomicWriteFile(path, content) {
|
|
10
|
+
const tmp = join(dirname(path), `.${basename(path)}.${process.pid}.${Date.now()}.tmp`);
|
|
11
|
+
await writeFile(tmp, content, { flag: "wx" });
|
|
12
|
+
try {
|
|
13
|
+
await rename(tmp, path);
|
|
14
|
+
}
|
|
15
|
+
catch (error) {
|
|
16
|
+
try {
|
|
17
|
+
await rm(tmp, { force: true });
|
|
18
|
+
}
|
|
19
|
+
catch { /* best-effort cleanup */ }
|
|
20
|
+
throw error;
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
// package.json is package-owned but still parsed JSON: prove the shape before
|
|
24
|
+
// reading it.
|
|
25
|
+
async function readPackageVersion(packageRoot) {
|
|
26
|
+
const parsed = parseJsonUnknown(await readFile(join(packageRoot, "package.json"), "utf8"));
|
|
27
|
+
if (!parsed.ok)
|
|
28
|
+
throw new Error(`cannot read package.json in ${packageRoot}: ${parsed.error.message}`);
|
|
29
|
+
if (!isRecord(parsed.value) || typeof parsed.value["version"] !== "string") {
|
|
30
|
+
throw new Error(`package.json in ${packageRoot} has no version`);
|
|
31
|
+
}
|
|
32
|
+
return parsed.value["version"];
|
|
33
|
+
}
|
|
34
|
+
async function listLibrarySkills(packageRoot) {
|
|
35
|
+
const dir = join(packageRoot, "library", "skills");
|
|
36
|
+
const entries = await readdir(dir, { withFileTypes: true });
|
|
37
|
+
return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
|
|
38
|
+
}
|
|
39
|
+
async function listLibraryAgents(packageRoot) {
|
|
40
|
+
const dir = join(packageRoot, "library", "agents");
|
|
41
|
+
const entries = await readdir(dir, { withFileTypes: true });
|
|
42
|
+
const out = [];
|
|
43
|
+
for (const e of entries.filter((x) => x.isFile() && x.name.endsWith(".md"))) {
|
|
44
|
+
const text = await readFile(join(dir, e.name), "utf8");
|
|
45
|
+
const fm = text.match(/^---\n([\s\S]*?)\n---\n/);
|
|
46
|
+
const fields = {};
|
|
47
|
+
if (fm)
|
|
48
|
+
for (const line of (fm[1] ?? "").split("\n")) {
|
|
49
|
+
const kv = line.match(/^([a-z]+):\s*(.*)$/);
|
|
50
|
+
if (kv && kv[1] !== undefined && kv[2] !== undefined)
|
|
51
|
+
fields[kv[1]] = kv[2].trim();
|
|
52
|
+
}
|
|
53
|
+
const skills = (fields["skills"] ?? "").replace(/^\[|\]$/g, "").split(",").map((s) => s.trim()).filter(Boolean);
|
|
54
|
+
out.push({ name: e.name.replace(/\.md$/, ""), description: fields["description"] ?? "", skills });
|
|
55
|
+
}
|
|
56
|
+
return out.sort((a, b) => a.name.localeCompare(b.name));
|
|
57
|
+
}
|
|
58
|
+
// skills-lock.json is the package's own manifest. Read it as unknown and keep
|
|
59
|
+
// the two fields the guide needs; a malformed lock fails the guide write.
|
|
60
|
+
async function listLockedSkills(packageRoot) {
|
|
61
|
+
const parsed = parseJsonUnknown(await readFile(join(packageRoot, "skills-lock.json"), "utf8"));
|
|
62
|
+
if (!parsed.ok)
|
|
63
|
+
throw new Error(`cannot read skills-lock.json in ${packageRoot}: ${parsed.error.message}`);
|
|
64
|
+
if (!isRecord(parsed.value) || !isRecord(parsed.value["skills"])) {
|
|
65
|
+
throw new Error("skills-lock.json must contain a skills object");
|
|
66
|
+
}
|
|
67
|
+
const out = [];
|
|
68
|
+
for (const [name, entry] of Object.entries(parsed.value["skills"])) {
|
|
69
|
+
if (!isRecord(entry) || typeof entry["source"] !== "string") {
|
|
70
|
+
throw new Error(`skills-lock.json entry "${name}" has no source`);
|
|
71
|
+
}
|
|
72
|
+
const license = typeof entry["license"] === "string" ? entry["license"] : "unknown";
|
|
73
|
+
out.push({ name, source: entry["source"], license });
|
|
74
|
+
}
|
|
75
|
+
return out.sort((a, b) => a.name.localeCompare(b.name));
|
|
76
|
+
}
|
|
77
|
+
export function renderGuide({ version, library, agents, locked }) {
|
|
78
|
+
const unknown = locked.filter((s) => s.license === "unknown").map((s) => s.name);
|
|
79
|
+
const specialistCount = agents.filter((agent) => agent.name !== "orchestrator").length;
|
|
80
|
+
const lockedLines = locked
|
|
81
|
+
.map((s) => `| ${s.name} | ${s.source} | ${s.license} |`)
|
|
82
|
+
.join("\n");
|
|
83
|
+
const agentLines = agents
|
|
84
|
+
.map((a) => `- **${a.name}** — ${a.description}\n Owns: ${a.skills.join(", ")}`)
|
|
85
|
+
.join("\n");
|
|
86
|
+
const libraryLines = library.join(", ");
|
|
87
|
+
return `# junamis-skills setup guide
|
|
88
|
+
|
|
89
|
+
Installed junamis-skills ${version}. This guide explains how the agents are wired together and how to drive them. It is a project file, not a skill, and no agent loads it automatically. Read it once, then keep it for reference or delete it.
|
|
90
|
+
|
|
91
|
+
## What was installed
|
|
92
|
+
|
|
93
|
+
- **Library skills** (owned by this project, in \`library/skills/\`): ${libraryLines}.
|
|
94
|
+
- **External skills** (from \`skills-lock.json\`, installed globally by your skills installer): ${locked.length} entries.
|
|
95
|
+
|
|
96
|
+
| Skill | Source | License |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
${lockedLines}
|
|
99
|
+
|
|
100
|
+
${unknown.length > 0 ? `Licenses marked \`unknown\` are not verified. Do not publish work that depends on: ${unknown.join(", ")}.\n` : ""}
|
|
101
|
+
## How the agents are structured
|
|
102
|
+
|
|
103
|
+
There is one entry point and ${specialistCount} specialist${specialistCount === 1 ? "" : "s"}. Every request starts at the orchestrator. The orchestrator never does the work itself; it routes and dispatches.
|
|
104
|
+
|
|
105
|
+
${agentLines}
|
|
106
|
+
|
|
107
|
+
### The dispatch loop
|
|
108
|
+
|
|
109
|
+
1. You send a request to the **orchestrator**.
|
|
110
|
+
2. The orchestrator runs the \`route\` skill, which classifies the request into one path: feature, bug, refactor, dependency, migration, release, deploy verification, rollback, incident, security, performance, environment, decision, skill, research, or question.
|
|
111
|
+
3. The orchestrator looks up the owning agent and skill for that path and dispatches exactly one step.
|
|
112
|
+
4. The specialist runs its skill and ends with a HANDOFF block (see \`~/.config/junamis/skills/HANDOFF.md\` in the installed package).
|
|
113
|
+
5. The orchestrator reads only the HANDOFF block. It checks that every listed artifact exists on disk.
|
|
114
|
+
6. It then decides: dispatch the \`next\` skill, ask you a question, or stop.
|
|
115
|
+
|
|
116
|
+
### Handoff contract
|
|
117
|
+
|
|
118
|
+
Every specialist ends with one YAML block:
|
|
119
|
+
|
|
120
|
+
\`\`\`yaml
|
|
121
|
+
agent: <name>
|
|
122
|
+
status: complete | blocked | needs-decision | failed
|
|
123
|
+
artifacts:
|
|
124
|
+
- path: <file written>
|
|
125
|
+
next: <one skill name, agent name, user, or none>
|
|
126
|
+
\`\`\`
|
|
127
|
+
|
|
128
|
+
- \`complete\` means the files exist on disk. The orchestrator checks before moving on.
|
|
129
|
+
- \`needs-decision\` stops the chain. You answer, then the orchestrator continues from that step.
|
|
130
|
+
- \`blocked\` and \`failed\` stop the chain and report. Nothing retries silently.
|
|
131
|
+
- \`next\` names exactly one target. A specialist never calls another specialist directly.
|
|
132
|
+
- Chat is not state. Anything a later agent needs must be in a file.
|
|
133
|
+
|
|
134
|
+
### Safety
|
|
135
|
+
|
|
136
|
+
Destructive or external actions need your explicit approval for that exact command. The full list is in \`~/.config/junamis/skills/SAFETY.md\` in the installed package. In short: deleting files, \`sudo\`, global installs, \`git push\`, production deploys, forced overwrites, and data changes. The \`-y\` flag is not approval.
|
|
137
|
+
|
|
138
|
+
## Always start with the orchestrator
|
|
139
|
+
|
|
140
|
+
Do not call a library skill or an external skill directly, even if you know its name. Send the request to the orchestrator. It reads the skills available to it, both the library skills and the external skills in your global skills folder, and uses their descriptions to decide what runs next. You do not need to name a skill yourself.
|
|
141
|
+
|
|
142
|
+
If a skill you need is not installed, the orchestrator stops and tells you which one is missing. It does not improvise.
|
|
143
|
+
|
|
144
|
+
## Installing the library and the external skills
|
|
145
|
+
|
|
146
|
+
One command, run once per machine. Review the dry run before the real install:
|
|
147
|
+
|
|
148
|
+
npx junamis-skills init --agent opencode --dry-run
|
|
149
|
+
npx junamis-skills init --agent opencode
|
|
150
|
+
|
|
151
|
+
It writes this guide, writes \`opencode.json\` when it is missing (OpenCode only), installs the library, and installs every external skill from the manifest. External skills are checked out at the commit recorded in the lock, their folder tree SHAs are verified, and then the pinned scanner runs before installation. Existing external skills are left unchanged and reported as skipped. The library install never overwrites a file you edited; it stops and lists the file. Use \`--force\` only after you have reviewed it. Use \`--scope project\` to install into the project instead of globally.
|
|
152
|
+
|
|
153
|
+
Check what is installed with:
|
|
154
|
+
|
|
155
|
+
npx junamis-skills status
|
|
156
|
+
|
|
157
|
+
skillsio shows its security scan. Critical findings are vetted in \`SECURITY.md\`; nothing else is answered for you. Skills install as a set from the manifest. Never install one skill in isolation, because skills reference each other.
|
|
158
|
+
|
|
159
|
+
## What to configure
|
|
160
|
+
|
|
161
|
+
1. **Your CLIs.** Tell the agent which CLIs you use (for example \`vercel\`, \`gh\`, \`pnpm\`). The setup step records their versions in \`docs/env-report.md\`.
|
|
162
|
+
2. **Environment names.** Local env variable names the project needs. The agent records names only, never values.
|
|
163
|
+
3. **Tokens and logins.** Any token (for example Vercel) is yours to create and paste when asked. The agent never stores one in a file.
|
|
164
|
+
|
|
165
|
+
## Where state lives
|
|
166
|
+
|
|
167
|
+
- \`.junamis/handoff.md\`: session state, written by the orchestrator at the end of work.
|
|
168
|
+
- \`docs/decisions/\`: decisions you make, so later work checks against them.
|
|
169
|
+
- \`docs/research/\`, \`docs/reviews/\`, \`docs/releases/\`: outputs of their skills.
|
|
170
|
+
|
|
171
|
+
## To start
|
|
172
|
+
|
|
173
|
+
Open a project in OpenCode and send your first request to the orchestrator. For example: "set up this project's environment" or "what should I work on next".
|
|
174
|
+
`;
|
|
175
|
+
}
|
|
176
|
+
// The marker is project-controlled JSON. A malformed marker is treated as
|
|
177
|
+
// absent so a broken file never blocks the write path. It is returned as raw
|
|
178
|
+
// records: only the fields the guide needs are narrowed, and only where used.
|
|
179
|
+
async function readMarker(projectDir) {
|
|
180
|
+
const path = join(projectDir, MARKER_PATH);
|
|
181
|
+
if (!existsSync(path))
|
|
182
|
+
return null;
|
|
183
|
+
try {
|
|
184
|
+
const parsed = parseJsonUnknown(await readFile(path, "utf8"));
|
|
185
|
+
if (!parsed.ok || !isRecord(parsed.value))
|
|
186
|
+
return null;
|
|
187
|
+
return parsed.value;
|
|
188
|
+
}
|
|
189
|
+
catch {
|
|
190
|
+
return null;
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* Write the one-time setup guide into projectDir.
|
|
195
|
+
* - Idempotent: if the guide was already written by this package, do nothing.
|
|
196
|
+
* - Never overwrites a guide the user has, unless force is true.
|
|
197
|
+
*/
|
|
198
|
+
export async function writeGuide({ projectDir, force = false, packageRoot = PACKAGE_ROOT, }) {
|
|
199
|
+
const guidePath = join(projectDir, GUIDE_NAME);
|
|
200
|
+
const marker = await readMarker(projectDir);
|
|
201
|
+
const version = await readPackageVersion(packageRoot);
|
|
202
|
+
const markerVersion = marker?.["version"];
|
|
203
|
+
if (!force && marker?.["guide"] === GUIDE_NAME && existsSync(guidePath)) {
|
|
204
|
+
return { status: "exists", path: guidePath, version: typeof markerVersion === "string" ? markerVersion : version };
|
|
205
|
+
}
|
|
206
|
+
if (!force && existsSync(guidePath) && !marker) {
|
|
207
|
+
return { status: "kept-user-file", path: guidePath, version };
|
|
208
|
+
}
|
|
209
|
+
const library = await listLibrarySkills(packageRoot);
|
|
210
|
+
const agents = await listLibraryAgents(packageRoot);
|
|
211
|
+
const locked = await listLockedSkills(packageRoot);
|
|
212
|
+
// init --dir <new> may point at a directory that does not exist yet.
|
|
213
|
+
await mkdir(projectDir, { recursive: true });
|
|
214
|
+
await atomicWriteFile(guidePath, renderGuide({ version, library, agents, locked }));
|
|
215
|
+
await mkdir(join(projectDir, ".junamis"), { recursive: true });
|
|
216
|
+
await atomicWriteFile(join(projectDir, MARKER_PATH), JSON.stringify({ guide: GUIDE_NAME, version, writtenAt: new Date().toISOString() }, null, 2) + "\n");
|
|
217
|
+
return { status: "created", path: guidePath, version };
|
|
218
|
+
}
|
|
219
|
+
//# sourceMappingURL=guide.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"guide.js","sourceRoot":"","sources":["../src/guide.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,kBAAkB,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// Public entry point for the package's type contract.
|
|
2
|
+
//
|
|
3
|
+
// The runtime modules under `src/` are still JavaScript on this branch. This
|
|
4
|
+
// file exists so the build emits a stable `dist/index.js` + `dist/index.d.ts`
|
|
5
|
+
// pair that consumers can import while the conversion lands.
|
|
6
|
+
export * from "./types/index.js";
|
|
7
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,6DAA6D;AAE7D,cAAc,kBAAkB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"install-external.d.ts","sourceRoot":"","sources":["../src/install-external.ts"],"names":[],"mappings":";AAUA,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAWnE"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// Thin entry point. The logic lives in ./external.ts so it can be tested.
|
|
3
|
+
// Usage: node dist/install-external.js [--agent opencode|claude] [--installer skillsio]
|
|
4
|
+
import { dirname, join, resolve } from "node:path";
|
|
5
|
+
import { fileURLToPath, pathToFileURL } from "node:url";
|
|
6
|
+
import { installExternal } from "./external.js";
|
|
7
|
+
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
|
|
8
|
+
export async function main(argv) {
|
|
9
|
+
let agent = "opencode";
|
|
10
|
+
let installer = "skillsio";
|
|
11
|
+
for (let i = 0; i < argv.length; i++) {
|
|
12
|
+
const arg = argv[i];
|
|
13
|
+
if (arg === "--agent")
|
|
14
|
+
agent = requireValue(argv, ++i, arg);
|
|
15
|
+
else if (arg === "--installer")
|
|
16
|
+
installer = requireValue(argv, ++i, arg);
|
|
17
|
+
else
|
|
18
|
+
throw new Error(`unknown option: ${String(arg)}`);
|
|
19
|
+
}
|
|
20
|
+
const { failed } = await installExternal({ lockPath: join(ROOT, "skills-lock.json"), agent, installer });
|
|
21
|
+
return failed > 0 ? 1 : 0;
|
|
22
|
+
}
|
|
23
|
+
function requireValue(argv, i, flag) {
|
|
24
|
+
const value = argv[i];
|
|
25
|
+
if (value === undefined)
|
|
26
|
+
throw new Error(`${flag} needs a value`);
|
|
27
|
+
return value;
|
|
28
|
+
}
|
|
29
|
+
if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
|
|
30
|
+
main(process.argv.slice(2))
|
|
31
|
+
.then((code) => { process.exitCode = code; })
|
|
32
|
+
.catch((error) => {
|
|
33
|
+
console.error(`error: ${error instanceof Error ? error.message : String(error)}`);
|
|
34
|
+
process.exitCode = 1;
|
|
35
|
+
});
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=install-external.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"install-external.js","sourceRoot":"","sources":["../src/install-external.ts"],"names":[],"mappings":";AACA,0EAA0E;AAC1E,wFAAwF;AAExF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAuB;IAChD,IAAI,KAAK,GAAG,UAAU,CAAC;IACvB,IAAI,SAAS,GAAG,UAAU,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;aACvD,IAAI,GAAG,KAAK,aAAa;YAAE,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;;YACpE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACzG,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,IAAuB,EAAE,CAAS,EAAE,IAAY;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACxB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;SAC5C,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { manifestPath, sharedDocsDir } from "./paths.js";
|
|
2
|
+
import type { AgentDefinition, AgentFormat, InstallScope, LibraryFile, LibraryFileList, LibraryInstallResult, LibraryManifest, LibraryPlan, PlannedLink } from "./types/index.js";
|
|
3
|
+
export { manifestPath, sharedDocsDir };
|
|
4
|
+
export declare const SHARED_DOCS: string[];
|
|
5
|
+
export declare const SHARED_DATA: string[];
|
|
6
|
+
export declare const ORCHESTRATOR = "orchestrator";
|
|
7
|
+
export declare function parseAgent(text: string, file: string): AgentDefinition;
|
|
8
|
+
export interface RenderAgentOptions {
|
|
9
|
+
readonly name: string;
|
|
10
|
+
readonly format: AgentFormat;
|
|
11
|
+
}
|
|
12
|
+
export declare function renderAgent(text: string, { name, format }: RenderAgentOptions): string;
|
|
13
|
+
export interface PlanLibraryInstallOptions {
|
|
14
|
+
readonly packageRoot: string;
|
|
15
|
+
readonly agent: string;
|
|
16
|
+
readonly scope?: InstallScope;
|
|
17
|
+
readonly projectDir?: string;
|
|
18
|
+
}
|
|
19
|
+
export declare function planLibraryInstall({ packageRoot, agent, scope, projectDir, }: PlanLibraryInstallOptions): Promise<LibraryPlan>;
|
|
20
|
+
export interface ManagedRoots {
|
|
21
|
+
readonly roots: string[];
|
|
22
|
+
readonly actualRoots: string[];
|
|
23
|
+
}
|
|
24
|
+
export declare function assertManagedRoots(agentId: string, scope?: InstallScope, projectDir?: string): ManagedRoots;
|
|
25
|
+
export declare function assertPlannedDestinations(files: readonly LibraryFile[], roots: readonly string[], actualRoots: readonly string[], scope: InstallScope): void;
|
|
26
|
+
export declare function assertLinkDestinations(links: readonly PlannedLink[], roots: readonly string[], actualRoots: readonly string[], scope: InstallScope): void;
|
|
27
|
+
export declare function validateLibraryManifest(agentId: string, manifest: unknown, scope?: InstallScope, projectDir?: string): LibraryManifest;
|
|
28
|
+
export interface ApplyLibraryInstallOptions {
|
|
29
|
+
readonly agent: string;
|
|
30
|
+
readonly files: LibraryFileList;
|
|
31
|
+
readonly links?: readonly PlannedLink[];
|
|
32
|
+
readonly version: string;
|
|
33
|
+
readonly force?: boolean;
|
|
34
|
+
readonly dryRun?: boolean;
|
|
35
|
+
readonly scope?: InstallScope;
|
|
36
|
+
readonly projectDir?: string;
|
|
37
|
+
}
|
|
38
|
+
export declare function applyLibraryInstall({ agent, files, links, version, force, dryRun, scope, projectDir, }: ApplyLibraryInstallOptions): Promise<LibraryInstallResult>;
|
|
39
|
+
//# sourceMappingURL=library-install.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"library-install.d.ts","sourceRoot":"","sources":["../src/library-install.ts"],"names":[],"mappings":"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"}
|