create-agentfs 0.1.1

package/dist/generators/ignore.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Ignore Files Generator — creates `.gitignore` and `.agentignore` at vault root.
+ *
+ * `.gitignore` protects runtime state and secrets from accidental commits.
+ * `.agentignore` enforces an agent-level read barrier over secrets and PII.
+ *
+ * Both files are written idempotently:
+ * - `.gitignore` — if the file exists, only absent lines are appended.
+ * - `.agentignore` — if the file exists, it is skipped entirely.
+ *
+ * @see docs/architecture.md Section 15 "Security Model"
+ * @module generators/ignore
+ */
+import type { SetupAnswers, GeneratorResult } from '../types/index.js';
+/**
+ * Generates `.gitignore` and `.agentignore` at the vault root.
+ *
+ * `.gitignore` handling:
+ * - If the file does not exist, it is created with all managed lines.
+ * - If the file already exists, only lines that are not already present are
+ *   appended (blank-line separator added before the new block).
+ *
+ * `.agentignore` handling:
+ * - If the file does not exist, it is created with the full managed content.
+ * - If the file already exists, it is skipped entirely.
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateIgnoreFiles(answers);
+ * console.log(result.created);  // ['.gitignore', '.agentignore']
+ * console.log(result.skipped);  // []
+ * ```
+ */
+export declare function generateIgnoreFiles(answers: SetupAnswers): Promise<GeneratorResult>;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/generators/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../src/generators/ignore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA+EvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAiDzF"}

package/dist/generators/ignore.js

@@ -0,0 +1,154 @@
+/**
+ * Ignore Files Generator — creates `.gitignore` and `.agentignore` at vault root.
+ *
+ * `.gitignore` protects runtime state and secrets from accidental commits.
+ * `.agentignore` enforces an agent-level read barrier over secrets and PII.
+ *
+ * Both files are written idempotently:
+ * - `.gitignore` — if the file exists, only absent lines are appended.
+ * - `.agentignore` — if the file exists, it is skipped entirely.
+ *
+ * @see docs/architecture.md Section 15 "Security Model"
+ * @module generators/ignore
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Lines written to (or appended into) `.gitignore`.
+ *
+ * Covers runtime state directories that must never be committed:
+ * active process state, decrypted secrets, and per-agent session logs.
+ */
+const GITIGNORE_LINES = [
+    '# Runtime state — never commit',
+    '.agentos/proc/',
+    '.agentos/secrets/decrypted/',
+    '',
+    '# Agent sessions and runtime data',
+    '.claude/sessions/',
+    '.claude/mcp/',
+    '.omc/sessions/',
+    '.omc/state/',
+    '.omc/telemetry/',
+    '.cursor/',
+    '',
+    '# Obsidian runtime',
+    '.obsidian/workspace*.json',
+    '.obsidian/plugins/',
+    '',
+    '# Smart environment (AI indexing)',
+    '.smart-env/',
+];
+/**
+ * Full content written to `.agentignore` when the file does not yet exist.
+ *
+ * Declares directories and glob patterns that agents must never read directly.
+ * Covers raw secrets, PII, and foreign-agent session files.
+ */
+const AGENTIGNORE_CONTENT = `# Secrets — agent must NEVER read directly
+.agentos/secrets/
+**/.env
+**/*.key
+**/*.pem
+**/*credentials*
+**/*token*
+
+# PII
+People/**/private-notes.md
+
+# Other agent sessions
+.claude/sessions/
+.omc/sessions/
+`;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Reads an existing text file and returns its lines, or an empty array when
+ * the file does not exist.
+ *
+ * @param filePath - Absolute path to the file to read.
+ * @returns Array of lines with newlines stripped.
+ */
+async function readLinesIfExists(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf8');
+        return content.split('\n');
+    }
+    catch {
+        return [];
+    }
+}
+// ---------------------------------------------------------------------------
+// generateIgnoreFiles
+// ---------------------------------------------------------------------------
+/**
+ * Generates `.gitignore` and `.agentignore` at the vault root.
+ *
+ * `.gitignore` handling:
+ * - If the file does not exist, it is created with all managed lines.
+ * - If the file already exists, only lines that are not already present are
+ *   appended (blank-line separator added before the new block).
+ *
+ * `.agentignore` handling:
+ * - If the file does not exist, it is created with the full managed content.
+ * - If the file already exists, it is skipped entirely.
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateIgnoreFiles(answers);
+ * console.log(result.created);  // ['.gitignore', '.agentignore']
+ * console.log(result.skipped);  // []
+ * ```
+ */
+export async function generateIgnoreFiles(answers) {
+    const result = { created: [], skipped: [] };
+    // -------------------------------------------------------------------------
+    // .gitignore — append-only merge
+    // -------------------------------------------------------------------------
+    const gitignorePath = path.join(answers.targetDir, '.gitignore');
+    const existingLines = await readLinesIfExists(gitignorePath);
+    const existingSet = new Set(existingLines.map((l) => l.trim()));
+    const missingLines = GITIGNORE_LINES.filter((line) => {
+        // Always insert comment headers if the exact comment is absent;
+        // always insert blank separators implicitly via the join below.
+        return !existingSet.has(line.trim());
+    });
+    if (existingLines.length === 0) {
+        // File does not exist — write it fresh.
+        await fs.writeFile(gitignorePath, GITIGNORE_LINES.join('\n') + '\n', 'utf8');
+        result.created.push('.gitignore');
+    }
+    else if (missingLines.length > 0) {
+        // File exists — append only the lines that are not present.
+        const appendBlock = '\n' + missingLines.join('\n') + '\n';
+        await fs.appendFile(gitignorePath, appendBlock, 'utf8');
+        result.created.push('.gitignore');
+    }
+    else {
+        // All lines already present — skip.
+        result.skipped.push('.gitignore');
+    }
+    // -------------------------------------------------------------------------
+    // .agentignore — create or skip
+    // -------------------------------------------------------------------------
+    const agentignorePath = path.join(answers.targetDir, '.agentignore');
+    try {
+        await fs.access(agentignorePath);
+        // File already exists — skip.
+        result.skipped.push('.agentignore');
+    }
+    catch {
+        // File does not exist — write it.
+        await fs.writeFile(agentignorePath, AGENTIGNORE_CONTENT, 'utf8');
+        result.created.push('.agentignore');
+    }
+    return result;
+}
+//# sourceMappingURL=ignore.js.map

package/dist/generators/ignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.js","sourceRoot":"","sources":["../../src/generators/ignore.ts"],"names":[],"mappings":"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"}

package/dist/generators/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AgentFS generators — barrel export.
+ *
+ * Generators are one-shot scaffold-time modules. Each creates
+ * a specific part of the vault structure from SetupAnswers.
+ */
+export { runSetupPrompts, createDefaultAnswers } from './prompts.js';
+export { generateFilesystem } from './filesystem.js';
+export { generateManifest } from './manifest.js';
+export { generateInitScripts } from './init.js';
+export { generateIgnoreFiles } from './ignore.js';
+export { generateMemoryFiles } from './memory.js';
+export { scaffold, formatScaffoldSummary } from './scaffold.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/generators/index.js

@@ -0,0 +1,14 @@
+/**
+ * AgentFS generators — barrel export.
+ *
+ * Generators are one-shot scaffold-time modules. Each creates
+ * a specific part of the vault structure from SetupAnswers.
+ */
+export { runSetupPrompts, createDefaultAnswers } from './prompts.js';
+export { generateFilesystem } from './filesystem.js';
+export { generateManifest } from './manifest.js';
+export { generateInitScripts } from './init.js';
+export { generateIgnoreFiles } from './ignore.js';
+export { generateMemoryFiles } from './memory.js';
+export { scaffold, formatScaffoldSummary } from './scaffold.js';
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/generators/init.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Init Scripts Generator — creates `.agentos/init.d/` boot scripts.
+ *
+ * Generates four SysVinit-style boot scripts that agents load at startup.
+ * Each script follows the runlevel 3 boot sequence defined in the manifest.
+ * All writes are idempotent: existing files are skipped, never overwritten.
+ *
+ * @see docs/architecture.md Section 4 "Boot Sequence"
+ * @module generators/init
+ */
+import type { SetupAnswers, GeneratorResult } from '../types/index.js';
+/**
+ * Generates the four `init.d/` boot scripts inside the target vault.
+ *
+ * Scripts produced (in load order):
+ * - `00-identity.md` — owner info, agent rules, vault path map
+ * - `10-memory.md`   — Tulving memory bootstrap strategy
+ * - `20-today.md`    — daily note and active task references
+ * - `30-projects.md` — active project detection instructions
+ *
+ * Behaviour:
+ * - Creates `.agentos/init.d/` directory if absent (recursive, safe).
+ * - Skips any file that already exists (idempotent).
+ * - Relative paths are reported in `GeneratorResult` for display.
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateInitScripts(answers);
+ * console.log(result.created);  // ['.agentos/init.d/00-identity.md', ...]
+ * console.log(result.skipped);  // []
+ * ```
+ */
+export declare function generateInitScripts(answers: SetupAnswers): Promise<GeneratorResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/generators/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/generators/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAqHvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA+BzF"}

package/dist/generators/init.js

@@ -0,0 +1,169 @@
+/**
+ * Init Scripts Generator — creates `.agentos/init.d/` boot scripts.
+ *
+ * Generates four SysVinit-style boot scripts that agents load at startup.
+ * Each script follows the runlevel 3 boot sequence defined in the manifest.
+ * All writes are idempotent: existing files are skipped, never overwritten.
+ *
+ * @see docs/architecture.md Section 4 "Boot Sequence"
+ * @module generators/init
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getDefaultPaths } from '../utils/fhs-mapping.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns today's date formatted as YYYY-MM-DD (local time).
+ */
+function todayIso() {
+    return new Date().toISOString().slice(0, 10);
+}
+/**
+ * Formats the FHS path table for the 00-identity.md vault paths section.
+ *
+ * Each line is a bullet mapping the FHS key to its vault directory, e.g.:
+ *   - tmp → Inbox
+ *
+ * @param paths - Resolved FhsPaths for the chosen profile.
+ * @returns Markdown bullet list, one mapping per defined path.
+ */
+function formatPathMappings(paths) {
+    return Object.entries(paths)
+        .filter((entry) => entry[1] !== undefined)
+        .map(([key, dir]) => `- ${key} → ${dir}`)
+        .join('\n');
+}
+// ---------------------------------------------------------------------------
+// Script content builders
+// ---------------------------------------------------------------------------
+/**
+ * Builds the content of `00-identity.md`.
+ *
+ * Embeds the owner name and the full FHS→vault path mapping for the chosen
+ * profile so agents know where every standard directory lives at boot.
+ */
+function buildIdentityScript(ownerName, paths) {
+    return `# Agent Identity
+
+## Owner
+- Name: ${ownerName}
+- Role: (to be filled during onboard)
+- Style: (to be filled during onboard)
+
+## Agent Rules
+- Follow vault conventions (frontmatter, naming, paths)
+- Challenge weak decisions
+- Don't repeat the obvious
+
+## Vault Paths
+${formatPathMappings(paths)}
+`;
+}
+/**
+ * Builds the content of `10-memory.md`.
+ *
+ * Declares Tulving's taxonomy loading strategy: semantic memory is always
+ * loaded at boot; episodic and procedural memories are lazy-loaded on demand.
+ */
+function buildMemoryScript() {
+    return `# Memory Bootstrap (Tulving's taxonomy)
+
+## Always load:
+- .agentos/memory/semantic.md
+- .agentos/memory/corrections.md
+
+## Lazy load (on demand):
+- .agentos/memory/episodic/ — load specific day when needed
+- .agentos/memory/procedural/ — load specific skill when needed
+`;
+}
+/**
+ * Builds the content of `20-today.md`.
+ *
+ * Points the agent at today's daily note and the active task queue files,
+ * using the vault paths resolved from the chosen profile.
+ */
+function buildTodayScript(paths) {
+    return `# Daily Context
+
+## Load today's daily note:
+- ${paths.log}/${todayIso()}.md
+
+## Load active tasks:
+- ${paths.spool}/priorities.md
+- ${paths.spool}/backlog.md
+`;
+}
+/**
+ * Builds the content of `30-projects.md`.
+ *
+ * Instructs the agent to scan project directories for READMEs and detect
+ * active projects via frontmatter status fields.
+ */
+function buildProjectsScript(paths) {
+    return `# Active Projects
+
+## Load project READMEs from:
+- ${paths.home}/*/README.md
+
+## Active project detection:
+- Look for status: active in frontmatter
+`;
+}
+// ---------------------------------------------------------------------------
+// generateInitScripts
+// ---------------------------------------------------------------------------
+/**
+ * Generates the four `init.d/` boot scripts inside the target vault.
+ *
+ * Scripts produced (in load order):
+ * - `00-identity.md` — owner info, agent rules, vault path map
+ * - `10-memory.md`   — Tulving memory bootstrap strategy
+ * - `20-today.md`    — daily note and active task references
+ * - `30-projects.md` — active project detection instructions
+ *
+ * Behaviour:
+ * - Creates `.agentos/init.d/` directory if absent (recursive, safe).
+ * - Skips any file that already exists (idempotent).
+ * - Relative paths are reported in `GeneratorResult` for display.
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateInitScripts(answers);
+ * console.log(result.created);  // ['.agentos/init.d/00-identity.md', ...]
+ * console.log(result.skipped);  // []
+ * ```
+ */
+export async function generateInitScripts(answers) {
+    const result = { created: [], skipped: [] };
+    const initDir = path.join(answers.targetDir, '.agentos', 'init.d');
+    await fs.mkdir(initDir, { recursive: true });
+    const paths = getDefaultPaths(answers.profile);
+    const scripts = [
+        { name: '00-identity.md', content: buildIdentityScript(answers.ownerName, paths) },
+        { name: '10-memory.md', content: buildMemoryScript() },
+        { name: '20-today.md', content: buildTodayScript(paths) },
+        { name: '30-projects.md', content: buildProjectsScript(paths) },
+    ];
+    for (const script of scripts) {
+        const absPath = path.join(initDir, script.name);
+        const relPath = path.join('.agentos', 'init.d', script.name);
+        try {
+            await fs.access(absPath);
+            // File already exists — skip.
+            result.skipped.push(relPath);
+        }
+        catch {
+            // File does not exist — write it.
+            await fs.writeFile(absPath, script.content, 'utf8');
+            result.created.push(relPath);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=init.js.map

package/dist/generators/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/generators/init.ts"],"names":[],"mappings":"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"}

package/dist/generators/manifest.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Manifest Generator — creates `.agentos/manifest.yaml`.
+ *
+ * Builds the kernel-space manifest from interactive setup answers and
+ * writes it to `{targetDir}/.agentos/manifest.yaml`. Idempotent: skips
+ * the file if it already exists.
+ *
+ * @see docs/architecture.md Section 2 "Kernel Space"
+ * @module generators/manifest
+ */
+import type { SetupAnswers, GeneratorResult } from '../types/index.js';
+/**
+ * Generates `.agentos/manifest.yaml` inside the target vault directory.
+ *
+ * Behaviour:
+ * - Creates `.agentos/` directory if absent (recursive, safe).
+ * - Skips writing if `manifest.yaml` already exists (idempotent).
+ * - Serialises the manifest with `js-yaml` using 2-space indentation.
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateManifest(answers);
+ * console.log(result.created);  // ['.agentos/manifest.yaml']
+ * console.log(result.skipped);  // []
+ * ```
+ */
+export declare function generateManifest(answers: SetupAnswers): Promise<GeneratorResult>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/generators/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAY,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAuEjF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAoCtF"}

package/dist/generators/manifest.js

@@ -0,0 +1,123 @@
+/**
+ * Manifest Generator — creates `.agentos/manifest.yaml`.
+ *
+ * Builds the kernel-space manifest from interactive setup answers and
+ * writes it to `{targetDir}/.agentos/manifest.yaml`. Idempotent: skips
+ * the file if it already exists.
+ *
+ * @see docs/architecture.md Section 2 "Kernel Space"
+ * @module generators/manifest
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { getDefaultPaths } from '../utils/fhs-mapping.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Current manifest schema version. */
+const AGENTOS_VERSION = '1.0.0';
+/**
+ * Standard boot sequence — ordered list of init.d scripts loaded at startup.
+ * Mirrors a minimal SysVinit runlevel 3 boot (see architecture §4).
+ */
+const BOOT_SEQUENCE = [
+    '.agentos/init.d/00-identity.md',
+    '.agentos/init.d/10-memory.md',
+    '.agentos/init.d/20-today.md',
+    '.agentos/init.d/30-projects.md',
+];
+/** Frontmatter fields every vault file must declare. */
+const FRONTMATTER_REQUIRED = ['date', 'tags'];
+/** Recommended but optional frontmatter fields. */
+const FRONTMATTER_STANDARD = ['status', 'stream', 'origin'];
+// ---------------------------------------------------------------------------
+// buildManifest
+// ---------------------------------------------------------------------------
+/**
+ * Constructs a typed `Manifest` object from setup answers.
+ *
+ * No I/O — pure transformation. The caller is responsible for serialising
+ * and persisting the result.
+ *
+ * @param answers - Wizard answers collected during `npx create-agentfs`.
+ * @returns A fully-populated `Manifest` ready for YAML serialisation.
+ */
+function buildManifest(answers) {
+    return {
+        agentos: {
+            version: AGENTOS_VERSION,
+            profile: answers.profile,
+        },
+        vault: {
+            name: answers.vaultName,
+            owner: answers.ownerName,
+            created: new Date().toISOString().slice(0, 10), // YYYY-MM-DD
+        },
+        agents: {
+            primary: answers.primaryAgent,
+            supported: answers.supportedAgents,
+        },
+        paths: getDefaultPaths(answers.profile),
+        boot: {
+            sequence: BOOT_SEQUENCE,
+        },
+        frontmatter: {
+            required: FRONTMATTER_REQUIRED,
+            standard: FRONTMATTER_STANDARD,
+        },
+        ...(answers.modules.length > 0 ? { modules: answers.modules } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// generateManifest
+// ---------------------------------------------------------------------------
+/**
+ * Generates `.agentos/manifest.yaml` inside the target vault directory.
+ *
+ * Behaviour:
+ * - Creates `.agentos/` directory if absent (recursive, safe).
+ * - Skips writing if `manifest.yaml` already exists (idempotent).
+ * - Serialises the manifest with `js-yaml` using 2-space indentation.
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateManifest(answers);
+ * console.log(result.created);  // ['.agentos/manifest.yaml']
+ * console.log(result.skipped);  // []
+ * ```
+ */
+export async function generateManifest(answers) {
+    const result = { created: [], skipped: [] };
+    const agentosDir = path.join(answers.targetDir, '.agentos');
+    const manifestPath = path.join(agentosDir, 'manifest.yaml');
+    const manifestRelative = path.join('.agentos', 'manifest.yaml');
+    // Ensure .agentos/ directory exists before checking the manifest.
+    await fs.mkdir(agentosDir, { recursive: true });
+    // Idempotency check — never overwrite an existing manifest.
+    try {
+        await fs.access(manifestPath);
+        // File exists — skip.
+        result.skipped.push(manifestRelative);
+        return result;
+    }
+    catch {
+        // File does not exist — proceed with creation.
+    }
+    const manifest = buildManifest(answers);
+    const yamlContent = '# AgentFS manifest — generated by create-agentfs. Do not edit manually.\n' +
+        '# See docs/architecture.md §2 for the full schema reference.\n\n' +
+        yaml.dump(manifest, {
+            indent: 2,
+            lineWidth: 100,
+            quotingType: "'",
+            forceQuotes: false,
+        });
+    await fs.writeFile(manifestPath, yamlContent, 'utf8');
+    result.created.push(manifestRelative);
+    return result;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/generators/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"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"}

package/dist/generators/memory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Memory Files Generator — creates `.agentos/memory/` seed files.
+ *
+ * Bootstraps the Tulving-taxonomy memory layer with two always-loaded files
+ * (`semantic.md`, `corrections.md`) and ensures the lazy-load directories
+ * (`episodic/`, `procedural/`) exist for future use.
+ *
+ * All writes are idempotent: existing files are skipped, never overwritten.
+ *
+ * @see docs/architecture.md Section 4 "Boot Sequence" — memory bootstrap
+ * @module generators/memory
+ */
+import type { SetupAnswers, GeneratorResult } from '../types/index.js';
+/**
+ * Generates seed memory files and lazy-load directories in `.agentos/memory/`.
+ *
+ * Files produced:
+ * - `semantic.md`    — typed facts/preferences, always loaded at boot
+ * - `corrections.md` — mistake log, always loaded at boot
+ *
+ * Directories ensured (created if absent, no-op if present):
+ * - `episodic/`   — per-day event logs, lazy-loaded on demand
+ * - `procedural/` — skill documents, lazy-loaded on demand
+ *
+ * @param answers - Setup answers from the interactive wizard.
+ * @returns A `GeneratorResult` listing created and skipped paths.
+ *
+ * @example
+ * ```ts
+ * const result = await generateMemoryFiles(answers);
+ * console.log(result.created);
+ * // ['.agentos/memory/semantic.md', '.agentos/memory/corrections.md']
+ * ```
+ */
+export declare function generateMemoryFiles(answers: SetupAnswers): Promise<GeneratorResult>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/generators/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/generators/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiDvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA+BzF"}