@lidtop/loadout 0.1.0

package/dist/targets.d.ts

@@ -0,0 +1,11 @@
+import { type Catalog, type State } from './schema.js';
+export type Target = {
+    label: string;
+    root: string;
+    global: boolean;
+    catalog?: Catalog;
+    state?: State;
+    error?: string;
+};
+export declare function loadTarget(root: string, global: boolean): Target;
+export declare function initializeTarget(target: Target): Target;

package/dist/targets.js

@@ -0,0 +1,31 @@
+import { loadCatalog } from './catalog.js';
+import { readExternal } from './external.js';
+import { exists, safePath } from './fs.js';
+import { initialize } from './init.js';
+import { loadState } from './storage.js';
+export function loadTarget(root, global) {
+    const target = {
+        root,
+        global,
+        label: global ? 'Global' : 'Repository',
+    };
+    try {
+        if (!exists(safePath(root, '.loadout/config.yaml')))
+            return target;
+        const catalog = loadCatalog(root, global);
+        const { store } = readExternal(root);
+        for (const [id, snapshot] of Object.entries(store.kits)) {
+            const kit = catalog.kits.get(id);
+            if (kit?.external)
+                kit.pinned = snapshot.source;
+        }
+        return { ...target, catalog, state: loadState(catalog) };
+    }
+    catch (error) {
+        return { ...target, error: error.message };
+    }
+}
+export function initializeTarget(target) {
+    initialize(target.root, target.global);
+    return loadTarget(target.root, target.global);
+}

package/dist/terminal.d.ts

@@ -0,0 +1 @@
+export declare function prepareInput(input: NodeJS.ReadableStream): void;

package/dist/terminal.js

@@ -0,0 +1,41 @@
+import { createInterface } from 'node:readline';
+import { Writable } from 'node:stream';
+const prepared = new WeakSet();
+export function prepareInput(input) {
+    if (prepared.has(input))
+        return;
+    // Inquirer doesn't expose escapeCodeTimeout. Node retains the input's key
+    // decoder after an interface closes, so seed it before Inquirer opens one.
+    const output = new Writable({ write: (_chunk, _encoding, done) => done() });
+    const decoder = createInterface({
+        input,
+        output,
+        terminal: true,
+        escapeCodeTimeout: 50,
+    });
+    decoder.close();
+    output.end();
+    let lastEscape;
+    input.on('keypress', (_text, key) => {
+        if (key.name !== 'escape') {
+            lastEscape = undefined;
+            return;
+        }
+        const now = performance.now();
+        if (key.sequence === '\u001b\u001b' ||
+            (lastEscape !== undefined && now - lastEscape <= 500)) {
+            lastEscape = undefined;
+            // Use the same cancellation path as Ctrl+C, including later prompts.
+            input.emit('keypress', '\u0003', {
+                name: 'c',
+                sequence: '\u0003',
+                ctrl: true,
+                meta: false,
+                shift: false,
+            });
+        }
+        else
+            lastEscape = now;
+    });
+    prepared.add(input);
+}

package/dist/updates.d.ts

@@ -0,0 +1,4 @@
+import { type Catalog, type Kit } from './schema.js';
+export declare function hasUpdate(kit: Kit): boolean;
+export declare function availableUpdates(catalog: Catalog, selected?: string[]): Kit[];
+export declare function updateDescription(kit: Kit): string;

package/dist/updates.js

@@ -0,0 +1,30 @@
+import { resolveKits } from './resolve.js';
+import { sameSource } from './schema.js';
+export function hasUpdate(kit) {
+    return !!(kit.pinned &&
+        kit.external &&
+        !sameSource(kit.pinned, kit.external));
+}
+// Without a selection, include downloaded kits that are currently disabled.
+export function availableUpdates(catalog, selected) {
+    const enabled = selected
+        ? new Set(resolveKits(catalog, selected))
+        : undefined;
+    return [...catalog.kits.values()]
+        .filter((kit) => hasUpdate(kit) && (!enabled || enabled.has(kit.id)))
+        .sort((a, b) => a.id.localeCompare(b.id));
+}
+export function updateDescription(kit) {
+    const before = kit.pinned;
+    const after = kit.external;
+    return [
+        `${before.repo}@${before.ref.slice(0, 12)} → ${after.repo}@${after.ref.slice(0, 12)}`,
+        ...(before.license !== after.license
+            ? [`License: ${before.license} → ${after.license}`]
+            : []),
+        ...(JSON.stringify([...before.skills].sort()) !==
+            JSON.stringify([...after.skills].sort())
+            ? [`Skills: ${before.skills.join(', ')} → ${after.skills.join(', ')}`]
+            : []),
+    ].join('\n  ');
+}

package/kits/greenfield/instructions.md

@@ -0,0 +1,3 @@
+This is a greenfield project that is not yet deployed and has no existing users to support. Make changes directly without backward-compatibility layers, legacy fallbacks, deprecation paths, or migrations for earlier versions. Update affected code, tests, and documentation together, and remove superseded implementations.
+
+If a change affects existing local development data, ask whether to migrate it with a one-time script or wipe it, unless that choice is already established.

package/kits/greenfield/kit.yaml

@@ -0,0 +1,6 @@
+schemaVersion: 1
+id: greenfield
+description: Develop an undeployed project without legacy compatibility code
+outputs:
+  - type: instructions
+    source: instructions.md

package/kits/write-kit/kit.yaml

@@ -0,0 +1,6 @@
+schemaVersion: 1
+id: write-kit
+description: Write a Loadout kit from a minimal example
+outputs:
+  - type: skill
+    source: skills/loadout-write-kit

package/kits/write-kit/skills/loadout-write-kit/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: loadout-write-kit
+description: Create or edit Loadout kits in .loadout/kits/.
+---
+
+Adapt this example; drop unused questions, outputs, and files.
+
+`.loadout/kits/review/kit.yaml`:
+
+```yaml
+schemaVersion: 1
+id: review
+description: Review changes
+questions:
+  diagrams: { type: boolean, message: Include diagrams?, default: false }
+  detail: { type: choice, message: Review depth?, choices: [brief, detailed], default: brief }
+outputs:
+  - type: skill
+    source: skills/review
+  - type: instructions
+    source: instructions.md
+  - type: instructions
+    source: diagrams.md
+    scope: src
+    when: { answer: diagrams, equals: true }
+  - type: instructions
+    source: detailed.md
+    when: { answer: detail, equals: detailed }
+```
+
+`.loadout/kits/review/skills/review/SKILL.md`:
+
+```markdown
+---
+name: review
+description: Review this repository's code changes.
+---
+
+Read the diff, then report defects with file, line, and a suggested fix.
+```
+
+- Use unique lowercase-hyphen IDs; question keys and skill names use the same format. Skill `name` matches its directory.
+- Sources are relative to `kit.yaml`; create every referenced file/directory, including conditional ones. No traversal, globs, or symlinks. Edit sources, not generated files.
+- `ready: false` blocks selection (**Needs setup**); omitted/true is ready; ready kits need at least one output. No `enabled` field: selection is personal state.
+- Add `requires: [checks]` for an existing ready kit; no cycles. Shared/explicit dependencies survive dependent removal; `loadout disable checks --cascade` also removes selected dependents.
+- Answers reuse saved values, then optional defaults; otherwise input is required. `when` matches one same-kit answer on either output type. No conditional questions or interpolation.
+- Instructions create `AGENTS.md` + a `CLAUDE.md` import at `scope` (default `.`). Other scopes require existing repository directories; global allows only `.`. Skills have no scope.
+- Skills copy to both agents with references, scripts, assets, binaries, and executable bits; scripts aren't run on install. Link supporting files from `SKILL.md`.
+
+```sh
+loadout enable review --answer review.diagrams=true --answer review.detail=detailed --dry-run --diff
+loadout disable review
+```
+
+Drop `--dry-run --diff` to apply, or select via `loadout` → Kits → Continue.

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@lidtop/loadout",
+  "version": "0.1.0",
+  "description": "Choose and manage agent instruction and skill kits for repositories and your home directory.",
+  "type": "module",
+  "bin": {
+    "loadout": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "kits",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZackarySantana/loadout.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "npm run build && node scripts/test.mjs",
+    "check": "npm run format:check && tsc --noEmit && tsc -p tsconfig.test.json && npm test",
+    "prepare": "npm run build",
+    "prepack": "npm run build",
+    "format": "prettier --write src test scripts .github *.json README.md",
+    "format:check": "prettier --check src test scripts .github *.json README.md",
+    "test:package": "node scripts/package-smoke.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@inquirer/core": "^12.0.3",
+    "@inquirer/prompts": "^8.7.2",
+    "commander": "^15.0.0",
+    "diff": "^9.0.0",
+    "string-width": "^8.2.2",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@inquirer/testing": "^3.3.13",
+    "@types/node": "^26.5.1",
+    "prettier": "^3.9.6",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/ZackarySantana/loadout#readme",
+  "bugs": {
+    "url": "https://github.com/ZackarySantana/loadout/issues"
+  },
+  "keywords": [
+    "cli",
+    "skills",
+    "agents",
+    "codex",
+    "claude-code"
+  ]
+}