compose-md-cli 0.0.0 → 0.1.0

package/dist/commands/apply.js

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, rmSync, writeFileSync } from 'fs';
-import { dirname, join } from 'path';
+import { basename, dirname, join, relative } from 'path';
 import { loadApproach } from '../lib/approaches.js';
 import { scanFragments } from '../lib/fragments.js';
 import { getActiveApproach, setActiveApproach } from '../lib/active.js';
@@ -18,6 +18,24 @@ function resolveContent(fragmentIds, fragments) {
     }
     return parts.join('\n\n');
 }
+function generateIndexContent(docsRoot, fragments) {
+    const described = [...fragments.values()].filter((f) => f.description);
+    const sorted = described.sort((a, b) => {
+        const relA = relative(docsRoot, a.filePath);
+        const relB = relative(docsRoot, b.filePath);
+        const dirA = dirname(relA);
+        const dirB = dirname(relB);
+        if (dirA !== dirB)
+            return dirA.localeCompare(dirB);
+        return basename(relA).localeCompare(basename(relB));
+    });
+    const lines = ['# Fragment Index', ''];
+    for (const fragment of sorted) {
+        const relPath = relative(docsRoot, fragment.filePath);
+        lines.push(`- **${fragment.name}** (${relPath}): ${fragment.description}`);
+    }
+    return lines.join('\n') + '\n';
+}
 export async function applyApproach(docsRoot, name, cwd) {
     const previousActive = getActiveApproach(cwd);
     if (previousActive && previousActive !== name) {
@@ -44,6 +62,8 @@ export async function applyApproach(docsRoot, name, cwd) {
         writeFileSync(fullPath, composed + '\n');
         console.log(`Written: ${outputPath}`);
     }
+    const indexContent = generateIndexContent(docsRoot, fragments);
+    writeFileSync(join(docsRoot, '_index.md'), indexContent);
     setActiveApproach(cwd, name);
     console.log(`\nApplied: ${name}`);
 }

package/dist/commands/init.js

@@ -2,7 +2,8 @@ import { input, confirm } from '@inquirer/prompts';
 import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync, readdirSync } from 'fs';
 import { join, relative, basename, dirname, sep } from 'path';
 import { fileURLToPath } from 'url';
-import { CONFIG_FILE, setDocsRootConfig } from '../lib/config.js';
+import { setDocsRootConfig } from '../lib/config.js';
+import { applyApproach } from './apply.js';
 // Filenames recognized anywhere in the project tree.
 const AGENT_FILENAMES = new Set([
     'AGENTS.md', // OpenAI Codex, generic
@@ -146,7 +147,6 @@ function buildDefaultYaml(agentFiles, startingPrompts, startingSkills) {
         'outputs:',
         `  ${rootSourcePath}:`,
         ...startingIncludes,
-        '    - "@getting-started"',
     ];
     if (rootFile) {
         lines.push(`    - "@${rootFile.fragmentId}"`);
@@ -165,7 +165,6 @@ function ensureGitignore(cwd, docsRootName) {
     const gitignorePath = join(cwd, '.gitignore');
     const entries = [
         '.compose-active',
-        CONFIG_FILE,
         `${docsRootName}/_index.md`,
     ];
     const gitignoreExisted = existsSync(gitignorePath);
@@ -183,22 +182,6 @@ export function scaffoldProject(cwd, docsRootName) {
     // Directories
     mkdirSync(join(docsRoot, '_approaches'), { recursive: true });
     created.push(`${docsRootName}/_approaches/`);
-    // Sample fragment
-    const sampleFragment = join(docsRoot, 'getting-started.md');
-    if (!existsSync(sampleFragment)) {
-        writeFileSync(sampleFragment, [
-            '---',
-            'name: getting-started',
-            'description: quick-start guide for new contributors',
-            '---',
-            '',
-            '# Getting Started',
-            '',
-            '<!-- Add your getting started content here -->',
-            '',
-        ].join('\n'));
-        created.push(`${docsRootName}/getting-started.md`);
-    }
     // Curated starter fragments shipped with compose-md
     const startingPrompts = copyStartingPrompts(docsRoot, docsRootName, created);
     const startingSkills = copyStartingSkills(docsRoot, docsRootName, created);
@@ -269,6 +252,16 @@ export async function runInit(cwd) {
             console.log(`  ${sourcePath} → @${fragmentId}`);
         }
     }
-    console.log('\nDone. Run `compose` to select and apply an approach.');
+    const shouldApply = await confirm({
+        message: "Now run 'compose apply'?",
+        default: true,
+    });
+    if (shouldApply) {
+        console.log('');
+        await applyApproach(docsRoot, 'default', cwd);
+    }
+    else {
+        console.log('\nDone. Run `compose apply default` when you are ready.');
+    }
 }
 export { findAgentFiles };

package/dist/lib/fragments.js

@@ -5,7 +5,7 @@ function parseFrontmatter(raw) {
     if (!match)
         return { data: {}, body: raw };
     const data = {};
-    for (const line of (match[1] ?? '').split('\n')) {
+    for (const line of match[1].split('\n')) {
         const colonIdx = line.indexOf(':');
         if (colonIdx === -1)
             continue;
@@ -13,7 +13,7 @@ function parseFrontmatter(raw) {
         const value = line.slice(colonIdx + 1).trim().replace(/^["']|["']$/g, '');
         data[key] = value;
     }
-    return { data, body: match[2] ?? '' };
+    return { data, body: match[2] };
 }
 export function scanFragments(docsRoot) {
     const fragments = new Map();

package/dist/startingPrompts/skills/compose-docs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: compose-docs
-description: Edit and regenerate this project's agent instruction files (AGENTS.md, CLAUDE.md, SKILL.md, etc.), which are generated by compose-md from fragments and approaches. Use this whenever you would normally write durable memory directly into one of those files.
+description: Edit and regenerate this project's agent instruction files (AGENTS.md, CLAUDE.md, SKILL.md, etc.), which are generated by compose-md from fragments and approaches. Use this whenever you would normally create or edit agent instruction files, including updating your memory.
 ---
 
 # compose-docs

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "compose-md-cli",
-  "module": "index.ts",
+  "version": "0.1.0",
+  "description": "A CLI for composing markdown agent context files (CLAUDE.md, AGENTS.md, etc.) from reusable fragments and YAML approach configs.",
   "type": "module",
-  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dwjohnston/compose-md.git"
+  },
+  "main": "./dist/cli.js",
+  "exports": "./dist/cli.js",
   "bin": {
-    "compose": "dist/cli.js"
+    "compose": "./dist/cli.js"
   },
   "files": [
     "dist"
@@ -17,9 +24,13 @@
     "clean": "rm -rf projectDocs && git checkout -- .gitignore",
     "docs:dev": "vitepress dev",
     "docs:build": "vitepress build",
-    "docs:preview": "vitepress preview"
+    "docs:preview": "vitepress preview",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.31.0",
     "@types/bun": "latest",
     "@types/js-yaml": "^4.0.9",
     "typescript": "^5",
@@ -31,6 +42,5 @@
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
     "js-yaml": "^5.2.0"
-  },
-  "version": "0.0.0"
+  }
 }