aman-intelligence 0.1.0

package/dist/utils/mcp-local.js

@@ -0,0 +1,129 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { exists, ensureDir, readJson, writeJson } from '../storage/filesystem.js';
+import { mcpLocalFilePath, contentFilePath } from '../storage/asset-layout.js';
+const PLACEHOLDER_RE = /^\$\{[A-Z0-9_]+\}$|^\{\{[A-Z0-9_]+\}\}$|^\$[A-Z][A-Z0-9_]*$/;
+function isEnvPlaceholder(value) {
+    if (typeof value !== 'string')
+        return false;
+    if (value.trim() === '')
+        return true;
+    return PLACEHOLDER_RE.test(value.trim());
+}
+/**
+ * Extract env var keys from mcp.json that need local values.
+ */
+export function extractMcpEnvKeys(mcpData) {
+    const keys = new Set();
+    const env = mcpData.env;
+    if (env && typeof env === 'object' && !Array.isArray(env)) {
+        for (const [key, value] of Object.entries(env)) {
+            if (typeof key === 'string' && key.length > 0 && isEnvPlaceholder(value)) {
+                keys.add(key);
+            }
+        }
+    }
+    const mcpServers = mcpData.mcpServers;
+    if (mcpServers && typeof mcpServers === 'object' && !Array.isArray(mcpServers)) {
+        for (const server of Object.values(mcpServers)) {
+            if (!server || typeof server !== 'object')
+                continue;
+            const serverEnv = server.env;
+            if (!serverEnv || typeof serverEnv !== 'object' || Array.isArray(serverEnv))
+                continue;
+            for (const [key, value] of Object.entries(serverEnv)) {
+                if (typeof key === 'string' && key.length > 0 && isEnvPlaceholder(value)) {
+                    keys.add(key);
+                }
+            }
+        }
+    }
+    return Array.from(keys).sort();
+}
+export function buildMcpLocalTemplate(envKeys) {
+    const out = {
+        _comment: 'Fill in local values for this MCP. This file is gitignored and never synced.',
+    };
+    for (const key of envKeys) {
+        out[key] = '';
+    }
+    return out;
+}
+/** Create mcp.local.json when missing; never overwrite existing file. */
+export async function scaffoldMcpLocalConfig(assetDir) {
+    const mcpPath = contentFilePath(assetDir, 'mcp');
+    const localPath = mcpLocalFilePath(assetDir);
+    if (!exists(mcpPath)) {
+        return { created: false, keys: [] };
+    }
+    if (exists(localPath)) {
+        return { created: false, keys: [] };
+    }
+    const mcpData = await readJson(mcpPath);
+    if (!mcpData) {
+        return { created: false, keys: [] };
+    }
+    const keys = extractMcpEnvKeys(mcpData);
+    if (keys.length === 0) {
+        return { created: false, keys: [] };
+    }
+    await writeJson(localPath, buildMcpLocalTemplate(keys));
+    return { created: true, keys };
+}
+export function mcpRequiresLocalConfig(mcpData) {
+    return extractMcpEnvKeys(mcpData).length > 0;
+}
+const GITIGNORE_MCP_LINE = 'mcps/**/mcp.local.json';
+export async function ensureMcpLocalGitignore(scopeRoot) {
+    const gitignorePath = path.join(scopeRoot, '.gitignore');
+    let content = '';
+    if (exists(gitignorePath)) {
+        content = await fs.readFile(gitignorePath, 'utf-8');
+        if (content.split('\n').some((line) => line.trim() === GITIGNORE_MCP_LINE || line.trim() === '**/mcp.local.json')) {
+            return false;
+        }
+        if (!content.endsWith('\n'))
+            content += '\n';
+        content += `${GITIGNORE_MCP_LINE}\n`;
+    }
+    else {
+        content = `${GITIGNORE_MCP_LINE}\n`;
+    }
+    await ensureDir(scopeRoot);
+    await fs.writeFile(gitignorePath, content, 'utf-8');
+    return true;
+}
+export async function readGitignoreContent(scopeRoot) {
+    const gitignorePath = path.join(scopeRoot, '.gitignore');
+    if (!exists(gitignorePath))
+        return '';
+    return fs.readFile(gitignorePath, 'utf-8');
+}
+export async function gitignoreIncludesMcpLocalAsync(scopeRoot) {
+    const content = await readGitignoreContent(scopeRoot);
+    if (!content)
+        return false;
+    return content.split('\n').some((line) => {
+        const t = line.trim();
+        return (t === GITIGNORE_MCP_LINE ||
+            t === '**/mcp.local.json' ||
+            t === 'mcp.local.json' ||
+            t === 'mcps/*/mcp.local.json');
+    });
+}
+export async function countEmptyMcpLocalValues(assetDir) {
+    const localPath = mcpLocalFilePath(assetDir);
+    if (!exists(localPath))
+        return 0;
+    const data = await readJson(localPath);
+    if (!data)
+        return 0;
+    let empty = 0;
+    for (const [key, value] of Object.entries(data)) {
+        if (key === '_comment')
+            continue;
+        if (value === '' || value === null || value === undefined)
+            empty++;
+    }
+    return empty;
+}

package/dist/utils/slug.d.ts

@@ -0,0 +1,6 @@
+/** Default public slug for a local asset name (V1 local/bundled convention). */
+export declare function defaultSlugForName(localName: string, namespace?: string): string;
+/** Extract local name segment from a slug (`@aman/react-best-practices` → `react-best-practices`). */
+export declare function localNameFromSlug(slug: string): string;
+/** Basic slug format validation for V1. */
+export declare function isValidSlug(slug: string): boolean;

package/dist/utils/slug.js

@@ -0,0 +1,13 @@
+/** Default public slug for a local asset name (V1 local/bundled convention). */
+export function defaultSlugForName(localName, namespace = 'aman') {
+    return `@${namespace}/${localName}`;
+}
+/** Extract local name segment from a slug (`@aman/react-best-practices` → `react-best-practices`). */
+export function localNameFromSlug(slug) {
+    const slash = slug.lastIndexOf('/');
+    return slash >= 0 ? slug.slice(slash + 1) : slug;
+}
+/** Basic slug format validation for V1. */
+export function isValidSlug(slug) {
+    return /^@[a-z0-9][a-z0-9-]*(?:~private)?\/[a-z0-9]+(-[a-z0-9]+)*$/.test(slug);
+}

package/dist/utils/stack-normalize.d.ts

@@ -0,0 +1,3 @@
+import { Stack } from '../types/index.js';
+/** Normalize legacy stack JSON to AMAN-STACK-SPEC-V1 compatible shape. */
+export declare function normalizeStack(raw: Stack | null): Stack | null;

package/dist/utils/stack-normalize.js

@@ -0,0 +1,43 @@
+import { randomUUID } from 'crypto';
+import { defaultSlugForName } from './slug.js';
+function namesFromMembers(members) {
+    return (members ?? []).map((m) => m.localName);
+}
+/** Normalize legacy stack JSON to AMAN-STACK-SPEC-V1 compatible shape. */
+export function normalizeStack(raw) {
+    if (!raw || !raw.name)
+        return null;
+    const skills = raw.skills?.length ? raw.skills : namesFromMembers(raw.members?.skills);
+    const prompts = raw.prompts?.length ? raw.prompts : namesFromMembers(raw.members?.prompts);
+    const mcps = raw.mcps?.length ? raw.mcps : namesFromMembers(raw.members?.mcps);
+    const buildRefs = (names, existing) => {
+        if (existing?.length)
+            return existing;
+        return names.map((localName) => ({
+            localName,
+            slug: defaultSlugForName(localName),
+            version: '1.0.0',
+        }));
+    };
+    return {
+        schemaVersion: raw.schemaVersion ?? 1,
+        recordType: raw.recordType ?? 'stack',
+        id: raw.id ?? randomUUID(),
+        slug: raw.slug ?? `@local/${raw.name}`,
+        name: raw.name,
+        description: raw.description,
+        visibility: raw.visibility ?? 'private',
+        members: {
+            skills: buildRefs(skills, raw.members?.skills),
+            prompts: buildRefs(prompts, raw.members?.prompts),
+            mcps: buildRefs(mcps, raw.members?.mcps),
+        },
+        skills,
+        prompts,
+        mcps,
+        packs: raw.packs ?? [],
+        deprecated: raw.deprecated ?? null,
+        createdAt: raw.createdAt ?? new Date().toISOString(),
+        updatedAt: raw.updatedAt ?? new Date().toISOString(),
+    };
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "aman-intelligence",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Package manager for AI workflow assets — skills, prompts, MCPs, packs, and stacks.",
+  "bin": {
+    "aman": "dist/bin/aman.js",
+    "aman-cli": "dist/bin/aman.js",
+    "aman-intelligence": "dist/bin/aman.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "clean": "node scripts/clean-dist.mjs",
+    "build": "npm run clean && tsc",
+    "dev": "tsx src/bin/aman.ts",
+    "init": "tsx src/bin/aman.ts init",
+    "setup": "tsx src/bin/aman.ts init",
+    "browse": "tsx src/bin/aman.ts browse",
+    "search": "tsx src/bin/aman.ts search",
+    "doctor": "tsx src/bin/aman.ts doctor",
+    "start": "tsx src/bin/aman.ts",
+    "typecheck": "tsc --noEmit",
+    "pack:check": "npm pack --dry-run"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "chalk": "^5.4.1",
+    "conf": "^13.0.1",
+    "fuse.js": "^7.0.0",
+    "glob": "^11.0.1",
+    "ink": "^5.1.0",
+    "ink-select-input": "^6.0.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "js-yaml": "^4.1.0",
+    "meow": "^13.0.0",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/archiver": "^6.0.3",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "author": "Aman Intelligence",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amandeavor/aman-intelligence-CLI.git"
+  },
+  "bugs": {
+    "url": "https://github.com/amandeavor/aman-intelligence-CLI/issues"
+  },
+  "homepage": "https://github.com/amandeavor/aman-intelligence-CLI#readme",
+  "keywords": [
+    "ai",
+    "workflow",
+    "cli",
+    "assets",
+    "mcp",
+    "skills",
+    "prompts",
+    "agentic-coding",
+    "developer-tools"
+  ]
+}