@lidtop/loadout 0.3.2 → 0.4.0

package/README.md

@@ -2,6 +2,8 @@
 
 Choose agent skills and instructions for yourself or your team. Loadout configures Codex and Claude Code.
 
+[Watch the demo](demo.mp4)
+
 Private kits and selections live in `.loadout-personal/`, ignored by Git. Add reusable kits to `~/.loadout/kits/` and enable them per repository.
 
 ## Use it
@@ -13,13 +15,9 @@ npm install -g @lidtop/loadout
 loadout
 ```
 
-Pick your kits and select **Review changes**. Any kit questions and downloads happen automatically, then one compact review shows your kit changes and file totals for Repository and Global. Expand **Unchanged** to inspect your complete selection, or choose **View files** to browse paths and diffs. Choose **Apply changes** to save, or **Back to kits** to edit your selection. Inside a provider, choose **Back to providers** to keep browsing with your selections preserved. Run `loadout` again to change your selection.
-
-The destination selector above the tabs shows **Repository** in cyan (this repository only) and **Global** in magenta (your user configuration across repositories). Active controls and selection markers follow the destination's color. Press **Tab** to switch destinations instantly, or **Shift+Tab** to cycle backward. **←/→** switches between the Kits, Browse, and Installed sections. Each destination keeps its own selections, provider, search, and cursor position, ready to browse as soon as you switch. A **\*** marks destinations with unapplied selections; **Review changes** includes the session's changes across both. Descriptions appear beneath every provider and kit, with dependency or update notes when needed.
-
-Press **Esc** from review, questions, or downloads to return to your kits. Inside file details, **Esc** returns to the previous view. Your kit choices, completed answers, and picker position are preserved; completed downloads are reused during the session and file plans are rebuilt before review. In review, **↑/↓** scroll and **Tab** moves between actions. Press **Ctrl+C** to cancel setup, or **Esc twice quickly** from the picker. Nothing is applied until you choose **Apply changes**.
+Pick your kits, select **Review changes**, then **Apply changes**. Run `loadout` again to change your selection.
 
-Conflicting project instructions are skipped with a warning; the kit’s skills still install.
+Choose **Repository** for the current project or **Global** for your user configuration across repositories.
 
 ## Share kits with your team
 

package/dist/picker.js

@@ -11,6 +11,11 @@ const muted = (value) => styleText('dim', value);
 const bold = (value) => styleText('bold', value);
 const scopeColor = (target, value) => styleText(target.global ? 'magenta' : 'cyan', value);
 const clean = (value) => stripVTControlCharacters(value).replace(/[\x00-\x1f\x7f]/g, ' ');
+function installationTime(value) {
+    const date = new Date(value);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
 function fit(value, width) {
     const text = clean(value);
     if (stringWidth(text) <= width)
@@ -182,13 +187,16 @@ const renderPicker = createPrompt((config, done) => {
             if (section === 'Kits')
                 return !providerFor(kit);
             if (section === 'Installed')
-                return (!!providerFor(kit) &&
-                    (!!kit.pinned ||
-                        enabledSet.has(kit.id) ||
-                        installedSet.has(kit.id)));
+                return installedSet.has(kit.id);
             return providerFor(kit) === provider;
         })
-            .sort((a, b) => Number(a.ready === false) - Number(b.ready === false))
+            .sort((a, b) => {
+            if (section === 'Installed') {
+                const time = (id) => target.installedAt?.[id] ? Date.parse(target.installedAt[id]) : 0;
+                return time(b.id) - time(a.id);
+            }
+            return Number(a.ready === false) - Number(b.ready === false);
+        })
             .map((kit) => ({ id: kit.id, description: kit.description, kit }));
     }
     if (provider)
@@ -352,7 +360,7 @@ const renderPicker = createPrompt((config, done) => {
             ...wordmark(width, height, accent),
             `  ${accent('✓')} ${selected.length} selected${requiredCount ? muted(` · ${requiredCount} required`) : ''}\n`,
         ].join('\n');
-    const updates = availableUpdates(catalog).length;
+    const updates = availableUpdates(catalog, selected).length;
     const counts = `${selected.length} selected${requiredCount ? ` · ${requiredCount} required` : ''}`;
     const tabLabel = (name) => name === 'Browse' && provider ? `Browse › ${clean(provider)}` : name;
     const inlineProvider = !!provider && sections.map(tabLabel).join('    ').length + 2 <= width - 2;
@@ -421,7 +429,8 @@ const renderPicker = createPrompt((config, done) => {
     const spacing = height - beforeList.length - footerHeight >= 8 ? 1 : 0;
     if (spacing)
         beforeList.push('');
-    const pageSize = Math.max(1, Math.min(8, Math.floor((height - beforeList.length - footerHeight) / 2)));
+    const pageSize = Math.max(1, Math.min(8, Math.floor((height - beforeList.length - footerHeight) /
+        (section === 'Installed' ? 3 : 2))));
     const listEntries = entries.filter((row) => !row.action);
     const listCursor = Math.min(cursor, Math.max(0, listEntries.length - 1));
     const start = Math.max(0, Math.min(listCursor - Math.floor(pageSize / 2), listEntries.length - pageSize));
@@ -472,6 +481,13 @@ const renderPicker = createPrompt((config, done) => {
         const name = fit(displayName(row.id), width - label.length - 9);
         const gap = ' '.repeat(Math.max(2, width - stringWidth(name) - label.length - 6));
         lines.push(`  ${focus ? accent('›') : ' '} ${marker} ${row.kit?.ready === false ? muted(name) : focus ? bold(name) : name}${gap}${badge}`, `      ${muted(fit(row.kit && section === 'Installed' ? `${kitSource(row.kit)} · ${row.description}` : row.description, width - 6))}`);
+        if (section === 'Installed' && row.kit) {
+            const timestamp = target.installedAt?.[row.id];
+            const installed = timestamp
+                ? `Installed ${installationTime(timestamp)}`
+                : 'Installed';
+            lines.push(`      ${muted(fit(installed, width - 6))}`);
+        }
     }
     if (!page.length) {
         const empty = !catalog.kits.size

package/dist/schema.d.ts

@@ -83,8 +83,9 @@ export declare const stateSchema: z.ZodObject<{
     selected: z.ZodArray<z.ZodString>;
     answers: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
 }, z.core.$strict>;
-export declare const ownedSchema: z.ZodObject<{
+export declare const generatedSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
+    installedAt: z.ZodRecord<z.ZodString, z.ZodISODateTime>;
     files: z.ZodRecord<z.ZodString, z.ZodObject<{
         hash: z.ZodString;
         mode: z.ZodUnion<readonly [z.ZodLiteral<420>, z.ZodLiteral<493>]>;
@@ -93,6 +94,7 @@ export declare const ownedSchema: z.ZodObject<{
 export type Question = z.infer<typeof question>;
 export type Answer = boolean | string;
 export type State = z.infer<typeof stateSchema>;
+export type Generated = z.infer<typeof generatedSchema>;
 export type Kit = z.infer<typeof kitSchema> & {
     directory: string;
     external?: ExternalSource;

package/dist/schema.js

@@ -111,9 +111,10 @@ export const stateSchema = z
     answers: z.record(idSchema, z.record(idSchema, z.union([z.boolean(), z.string()]))),
 })
     .strict();
-export const ownedSchema = z
+export const generatedSchema = z
     .object({
     schemaVersion: z.literal(1),
+    installedAt: z.record(idSchema, z.iso.datetime()),
     files: z.record(z.string(), z
         .object({
         hash: z.string().regex(/^[a-f0-9]{64}$/),

package/dist/storage.d.ts

@@ -1,5 +1,5 @@
 import { type IgnoreTarget } from './ignore.js';
-import { type Catalog, type State } from './schema.js';
+import { type Catalog, type State, type Generated } from './schema.js';
 import { type FileContent, type Rendered } from './render.js';
 export type Change = {
     path: string;
@@ -10,6 +10,7 @@ export type Change = {
 export type Plan = {
     root: string;
     changes: Change[];
+    installing?: string[];
     adopted?: string[];
     skippedInstructions?: {
         paths: string[];
@@ -27,6 +28,7 @@ export type Plan = {
     };
 };
 export declare function loadState(catalog: Catalog): State;
+export declare function loadGenerated(root: string): Generated;
 type ExcludePlan = {
     target: IgnoreTarget;
     paths: string[];

package/dist/storage.js

@@ -6,7 +6,8 @@ import path from 'node:path';
 import { createHash, randomUUID } from 'node:crypto';
 import { execFileSync } from 'node:child_process';
 import { exists, json, readOptional, safePath, walk, portableMode, } from './fs.js';
-import { parse, ownedSchema, stateSchema, } from './schema.js';
+import { parse, generatedSchema, stateSchema, } from './schema.js';
+import { resolveKits } from './resolve.js';
 const hash = (content) => createHash('sha256').update(content).digest('hex');
 export function loadState(catalog) {
     const raw = readOptional(catalog.root, '.loadout-personal/local.json');
@@ -14,6 +15,12 @@ export function loadState(catalog) {
         ? parse(stateSchema, JSON.parse(raw.toString()), '.loadout-personal/local.json')
         : { schemaVersion: 1, selected: [], answers: {} };
 }
+export function loadGenerated(root) {
+    const raw = readOptional(root, '.loadout-personal/generated.json');
+    return raw
+        ? parse(generatedSchema, JSON.parse(raw.toString()), '.loadout-personal/generated.json')
+        : { schemaVersion: 1, installedAt: {}, files: {} };
+}
 function snapshot(root, relative) {
     const content = readOptional(root, relative);
     return content === undefined
@@ -71,10 +78,12 @@ function trackedFiles(root) {
 }
 export function plan(catalog, state, rendered, options = {}) {
     const root = catalog.root;
-    const raw = readOptional(root, '.loadout-personal/generated.json');
-    const owned = raw
-        ? parse(ownedSchema, JSON.parse(raw.toString()), '.loadout-personal/generated.json').files
-        : {};
+    const generated = loadGenerated(root);
+    const owned = generated.files;
+    const enabled = resolveKits(catalog, state.selected).sort();
+    const installing = enabled.filter((id) => !Object.hasOwn(generated.installedAt, id));
+    const plannedAt = new Date().toISOString();
+    const installedAt = Object.fromEntries(enabled.map((id) => [id, generated.installedAt[id] ?? plannedAt]));
     const tracked = trackedFiles(root);
     const skippedInstructions = [];
     const retainedKits = new Set(rendered.skillKits);
@@ -149,7 +158,10 @@ export function plan(catalog, state, rendered, options = {}) {
         .map(([p, f]) => [p, { hash: hash(f.content), mode: f.mode }]));
     const metadata = new Map([
         ['.loadout-personal/local.json', json(state)],
-        ['.loadout-personal/generated.json', json({ schemaVersion: 1, files })],
+        [
+            '.loadout-personal/generated.json',
+            json({ schemaVersion: 1, installedAt, files }),
+        ],
     ]);
     if (rendered.external) {
         const current = readOptional(root, '.loadout-personal/external.json');
@@ -175,6 +187,7 @@ export function plan(catalog, state, rendered, options = {}) {
     return {
         root,
         changes,
+        installing,
         adopted: adoption.adopted,
         skippedInstructions,
         kitsWithoutOutputs,
@@ -321,9 +334,23 @@ export function applyAll(plans) {
         for (const { root, change } of writes)
             if (!equal(snapshot(root, change.path), change.before))
                 throw new Error(`File changed since preview: ${change.path}. Run the command again.`);
-        for (const { root, change } of writes) {
+        const installedAt = new Date().toISOString();
+        for (const { root, change: planned } of writes) {
+            let change = planned;
             if (change.kind === 'unchanged')
                 continue;
+            const installing = plans.find((plan) => plan.root === root)?.installing;
+            if (change.path === '.loadout-personal/generated.json' &&
+                change.after &&
+                installing?.length) {
+                const generated = parse(generatedSchema, JSON.parse(change.after.content.toString()), change.path);
+                for (const id of installing)
+                    generated.installedAt[id] = installedAt;
+                change = {
+                    ...change,
+                    after: { ...change.after, content: json(generated) },
+                };
+            }
             if (change.after)
                 writeAtomic(root, change.path, change.after);
             else

package/dist/targets.d.ts

@@ -5,6 +5,7 @@ export type Target = {
     global: boolean;
     catalog?: Catalog;
     state?: State;
+    installedAt?: Record<string, string>;
     error?: string;
 };
 export declare function loadTarget(root: string, global: boolean): Target;

package/dist/targets.js

@@ -1,6 +1,6 @@
 import { loadCatalog } from './catalog.js';
 import { readExternal } from './external.js';
-import { loadState } from './storage.js';
+import { loadGenerated, loadState } from './storage.js';
 export function loadTarget(root, global) {
     const target = {
         root,
@@ -15,7 +15,12 @@ export function loadTarget(root, global) {
             if (kit?.external)
                 kit.pinned = snapshot.source;
         }
-        return { ...target, catalog, state: loadState(catalog) };
+        return {
+            ...target,
+            catalog,
+            state: loadState(catalog),
+            installedAt: loadGenerated(root).installedAt,
+        };
     }
     catch (error) {
         return { ...target, error: error.message };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lidtop/loadout",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Choose and manage agent instruction and skill kits for repositories and your home directory.",
   "type": "module",
   "bin": {