create-agentfs 0.1.1

package/dist/generators/memory.js

@@ -0,0 +1,106 @@
+/**
+ * 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 fs from 'node:fs/promises';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// File content constants
+// ---------------------------------------------------------------------------
+/**
+ * Seed content for `semantic.md`.
+ *
+ * Always loaded at boot. Stores context-free facts and preferences using
+ * typed entry markers (PREF, FACT, PATTERN, AVOID) for structured retrieval.
+ */
+const SEMANTIC_CONTENT = `# Semantic Memory
+
+> Context-free facts and preferences. Always loaded at boot.
+> Format: TYPE: [status] content
+
+## Preferences
+<!-- PREF: entries go here -->
+
+## Facts
+<!-- FACT: [active] entries go here -->
+
+## Patterns
+<!-- PATTERN: [confidence:0.3] entries go here -->
+
+## Avoids
+<!-- AVOID: entries go here -->
+
+## Directives
+<!-- DIRECTIVE: imperative rules that must always be followed -->
+`;
+/**
+ * Seed content for `corrections.md`.
+ *
+ * Loaded at boot alongside semantic memory. Records agent mistakes and
+ * the lessons drawn from them so they are not repeated.
+ */
+const CORRECTIONS_CONTENT = `# Corrections
+
+> Agent mistakes and lessons learned. Loaded at boot alongside semantic memory.
+> Each entry: what went wrong, what was the fix, lesson learned.
+`;
+// ---------------------------------------------------------------------------
+// generateMemoryFiles
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function generateMemoryFiles(answers) {
+    const result = { created: [], skipped: [] };
+    const memoryDir = path.join(answers.targetDir, '.agentos', 'memory');
+    // Ensure the memory root and both lazy-load subdirectories exist.
+    await fs.mkdir(path.join(memoryDir, 'episodic'), { recursive: true });
+    await fs.mkdir(path.join(memoryDir, 'procedural'), { recursive: true });
+    // Seed files to write — each is skipped if it already exists.
+    const files = [
+        { name: 'semantic.md', content: SEMANTIC_CONTENT },
+        { name: 'corrections.md', content: CORRECTIONS_CONTENT },
+    ];
+    for (const file of files) {
+        const absPath = path.join(memoryDir, file.name);
+        const relPath = path.join('.agentos', 'memory', file.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, file.content, 'utf8');
+            result.created.push(relPath);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=memory.js.map

package/dist/generators/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/generators/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG;;;;CAI3B,CAAC;AAEF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IAC7D,MAAM,MAAM,GAAoB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE7D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAErE,kEAAkE;IAClE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExE,8DAA8D;IAC9D,MAAM,KAAK,GAA6C;QACtD,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE;QAClD,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,mBAAmB,EAAE;KACzD,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzB,8BAA8B;YAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;YAClC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/generators/profiles.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Company & Shared profile generators — Epic 11.
+ *
+ * Story 11.1: Company profile with team directories and RBAC
+ * Story 11.2: Shared profile with per-user spaces
+ *
+ * @module generators/profiles
+ */
+/**
+ * Generate company profile directories and RBAC scaffolding.
+ *
+ * @param vaultRoot - Vault root path
+ */
+export declare function generateCompanyProfile(vaultRoot: string): Promise<string[]>;
+/**
+ * Generate shared profile with per-user spaces.
+ *
+ * @param vaultRoot - Vault root path
+ * @param users     - List of user names
+ */
+export declare function generateSharedProfile(vaultRoot: string, users?: string[]): Promise<string[]>;
+//# sourceMappingURL=profiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/generators/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAgDnB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAM,EAAgB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB"}

package/dist/generators/profiles.js

@@ -0,0 +1,92 @@
+/**
+ * Company & Shared profile generators — Epic 11.
+ *
+ * Story 11.1: Company profile with team directories and RBAC
+ * Story 11.2: Shared profile with per-user spaces
+ *
+ * @module generators/profiles
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Generate company profile directories and RBAC scaffolding.
+ *
+ * @param vaultRoot - Vault root path
+ */
+export async function generateCompanyProfile(vaultRoot) {
+    const dirs = [
+        'Teams',
+        'Decisions',
+        'Postmortems',
+        'Projects',
+        'Resources',
+        'Archive',
+        '.agentos/rbac',
+    ];
+    const created = [];
+    for (const dir of dirs) {
+        await fs.mkdir(path.join(vaultRoot, dir), { recursive: true });
+        created.push(dir);
+    }
+    // Generate RBAC files
+    const rolesYaml = `# RBAC Roles — Company Profile
+version: "1.0"
+roles:
+  admin:
+    description: Full access to all vault areas
+    permissions: ["*"]
+  developer:
+    description: Access to projects and resources
+    permissions: ["Projects/*", "Resources/*", "Daily/*"]
+  viewer:
+    description: Read-only access
+    permissions: ["read:*"]
+`;
+    await fs.writeFile(path.join(vaultRoot, '.agentos/rbac/roles.yaml'), rolesYaml, 'utf8');
+    created.push('.agentos/rbac/roles.yaml');
+    const policiesYaml = `# RBAC Policies — Company Profile
+version: "1.0"
+policies:
+  - role: admin
+    users: []
+  - role: developer
+    users: []
+  - role: viewer
+    users: []
+`;
+    await fs.writeFile(path.join(vaultRoot, '.agentos/rbac/policies.yaml'), policiesYaml, 'utf8');
+    created.push('.agentos/rbac/policies.yaml');
+    return created;
+}
+/**
+ * Generate shared profile with per-user spaces.
+ *
+ * @param vaultRoot - Vault root path
+ * @param users     - List of user names
+ */
+export async function generateSharedProfile(vaultRoot, users = ['default']) {
+    const created = [];
+    // Shared directories
+    const sharedDirs = [
+        'Shared/Projects',
+        'Shared/Knowledge',
+        'Shared/Templates',
+    ];
+    for (const dir of sharedDirs) {
+        await fs.mkdir(path.join(vaultRoot, dir), { recursive: true });
+        created.push(dir);
+    }
+    // Per-user spaces
+    await fs.mkdir(path.join(vaultRoot, '.agentos/users'), { recursive: true });
+    for (const user of users) {
+        const userDir = `Spaces/${user}`;
+        await fs.mkdir(path.join(vaultRoot, userDir, 'Daily'), { recursive: true });
+        await fs.mkdir(path.join(vaultRoot, userDir, 'Inbox'), { recursive: true });
+        created.push(userDir);
+        const userConfig = `# User: ${user}\nname: ${user}\nrole: developer\n`;
+        await fs.writeFile(path.join(vaultRoot, `.agentos/users/${user}.yaml`), userConfig, 'utf8');
+        created.push(`.agentos/users/${user}.yaml`);
+    }
+    return created;
+}
+//# sourceMappingURL=profiles.js.map

package/dist/generators/profiles.js.map

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

package/dist/generators/prompts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Interactive setup prompts for `npx create-agentfs`.
+ *
+ * Uses `inquirer` to collect vault configuration from the user.
+ * Returns a `SetupAnswers` object that drives all downstream generators.
+ *
+ * @module generators/prompts
+ */
+import type { SetupAnswers } from '../types/index.js';
+/**
+ * Run the interactive setup wizard.
+ *
+ * @param targetDir - Directory where the vault will be created (defaults to cwd)
+ * @returns Answers collected from the user
+ */
+export declare function runSetupPrompts(targetDir?: string): Promise<SetupAnswers>;
+/**
+ * Create SetupAnswers programmatically (for testing and non-interactive use).
+ *
+ * @param overrides - Partial answers to merge with defaults
+ * @returns Complete SetupAnswers with defaults filled in
+ */
+export declare function createDefaultAnswers(overrides?: Partial<SetupAnswers>): SetupAnswers;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/generators/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAmC7E;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4D/E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAWxF"}

package/dist/generators/prompts.js

@@ -0,0 +1,122 @@
+/**
+ * Interactive setup prompts for `npx create-agentfs`.
+ *
+ * Uses `inquirer` to collect vault configuration from the user.
+ * Returns a `SetupAnswers` object that drives all downstream generators.
+ *
+ * @module generators/prompts
+ */
+import inquirer from 'inquirer';
+import path from 'node:path';
+/** Available vault profiles with descriptions. */
+const PROFILES = [
+    { name: 'Personal — solo engineer, creator, builder', value: 'personal' },
+    { name: 'Company — team with shared knowledge base', value: 'company' },
+    { name: 'Shared — multi-user collaborative vault', value: 'shared' },
+];
+/** Available agent runtimes. */
+const AGENTS = [
+    { name: 'Claude Code', value: 'claude' },
+    { name: 'OpenClaw / OMC', value: 'openclaw' },
+    { name: 'Cursor', value: 'cursor' },
+];
+/** Optional modules available per profile. */
+const MODULES = {
+    personal: [
+        { name: 'Career — job search pipeline', value: 'career' },
+        { name: 'Content — multi-platform publishing', value: 'content' },
+        { name: 'Engineering — professional knowledge base', value: 'engineering' },
+        { name: 'BMAD — project management framework', value: 'bmad' },
+    ],
+    company: [
+        { name: 'Clients — client project management', value: 'clients' },
+        { name: 'Content — company blog/docs pipeline', value: 'content' },
+        { name: 'BMAD — project management framework', value: 'bmad' },
+    ],
+    shared: [
+        { name: 'Content — shared content pipeline', value: 'content' },
+        { name: 'BMAD — project management framework', value: 'bmad' },
+    ],
+};
+/**
+ * Run the interactive setup wizard.
+ *
+ * @param targetDir - Directory where the vault will be created (defaults to cwd)
+ * @returns Answers collected from the user
+ */
+export async function runSetupPrompts(targetDir) {
+    const resolvedDir = targetDir ?? process.cwd();
+    const dirName = path.basename(resolvedDir);
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'vaultName',
+            message: 'Vault name:',
+            default: dirName,
+            validate: (input) => input.trim().length > 0 || 'Vault name cannot be empty',
+        },
+        {
+            type: 'input',
+            name: 'ownerName',
+            message: 'Owner name (person or team):',
+            validate: (input) => input.trim().length > 0 || 'Owner name cannot be empty',
+        },
+        {
+            type: 'list',
+            name: 'profile',
+            message: 'Vault profile:',
+            choices: PROFILES,
+            default: 'personal',
+        },
+        {
+            type: 'list',
+            name: 'primaryAgent',
+            message: 'Primary AI agent:',
+            choices: AGENTS,
+            default: 'claude',
+        },
+        {
+            type: 'checkbox',
+            name: 'supportedAgents',
+            message: 'Additional supported agents:',
+            choices: (prev) => AGENTS.filter((a) => a.value !== prev.primaryAgent),
+        },
+        {
+            type: 'checkbox',
+            name: 'modules',
+            message: 'Optional modules to enable:',
+            choices: (prev) => MODULES[prev.profile] ?? [],
+        },
+    ]);
+    return {
+        vaultName: answers.vaultName.trim(),
+        ownerName: answers.ownerName.trim(),
+        profile: answers.profile,
+        primaryAgent: answers.primaryAgent,
+        supportedAgents: [
+            answers.primaryAgent,
+            ...answers.supportedAgents,
+        ],
+        modules: answers.modules,
+        targetDir: resolvedDir,
+    };
+}
+/**
+ * Create SetupAnswers programmatically (for testing and non-interactive use).
+ *
+ * @param overrides - Partial answers to merge with defaults
+ * @returns Complete SetupAnswers with defaults filled in
+ */
+export function createDefaultAnswers(overrides = {}) {
+    return {
+        vaultName: 'my-vault',
+        ownerName: 'user',
+        profile: 'personal',
+        primaryAgent: 'claude',
+        supportedAgents: ['claude'],
+        modules: [],
+        targetDir: process.cwd(),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/generators/prompts.js.map

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

package/dist/generators/scaffold.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Scaffold orchestrator — wires all generators together.
+ *
+ * Called when `npx create-agentfs` runs. Executes generators in order:
+ * 1. Filesystem structure (dirs)
+ * 2. Manifest.yaml
+ * 3. Init.d boot scripts
+ * 4. Ignore files (.gitignore, .agentignore)
+ * 5. Memory system
+ *
+ * Each generator is idempotent: existing files are never overwritten.
+ *
+ * @module generators/scaffold
+ */
+import type { SetupAnswers, ScaffoldResult } from '../types/index.js';
+/**
+ * Run the full scaffold pipeline.
+ *
+ * @param answers - Setup answers from interactive prompts or programmatic call
+ * @returns Aggregated result with counts and per-generator details
+ */
+export declare function scaffold(answers: SetupAnswers): Promise<ScaffoldResult>;
+/**
+ * Print a human-readable scaffold summary.
+ *
+ * @param result - Scaffold result to format
+ */
+export declare function formatScaffoldSummary(result: ScaffoldResult): string;
+//# sourceMappingURL=scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/generators/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAOvF;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAqC7E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA8BpE"}

package/dist/generators/scaffold.js

@@ -0,0 +1,90 @@
+/**
+ * Scaffold orchestrator — wires all generators together.
+ *
+ * Called when `npx create-agentfs` runs. Executes generators in order:
+ * 1. Filesystem structure (dirs)
+ * 2. Manifest.yaml
+ * 3. Init.d boot scripts
+ * 4. Ignore files (.gitignore, .agentignore)
+ * 5. Memory system
+ *
+ * Each generator is idempotent: existing files are never overwritten.
+ *
+ * @module generators/scaffold
+ */
+import { generateFilesystem } from './filesystem.js';
+import { generateManifest } from './manifest.js';
+import { generateInitScripts } from './init.js';
+import { generateIgnoreFiles } from './ignore.js';
+import { generateMemoryFiles } from './memory.js';
+/**
+ * Run the full scaffold pipeline.
+ *
+ * @param answers - Setup answers from interactive prompts or programmatic call
+ * @returns Aggregated result with counts and per-generator details
+ */
+export async function scaffold(answers) {
+    const details = {};
+    let dirsCreated = 0;
+    let filesCreated = 0;
+    let itemsSkipped = 0;
+    // 1. Filesystem structure (directories only)
+    const fsResult = await generateFilesystem(answers);
+    details['filesystem'] = fsResult;
+    dirsCreated += fsResult.created.length;
+    itemsSkipped += fsResult.skipped.length;
+    // 2. Manifest.yaml
+    const manifestResult = await generateManifest(answers);
+    details['manifest'] = manifestResult;
+    filesCreated += manifestResult.created.length;
+    itemsSkipped += manifestResult.skipped.length;
+    // 3. Init.d boot scripts
+    const initResult = await generateInitScripts(answers);
+    details['init'] = initResult;
+    filesCreated += initResult.created.length;
+    itemsSkipped += initResult.skipped.length;
+    // 4. Ignore files
+    const ignoreResult = await generateIgnoreFiles(answers);
+    details['ignore'] = ignoreResult;
+    filesCreated += ignoreResult.created.length;
+    itemsSkipped += ignoreResult.skipped.length;
+    // 5. Memory system
+    const memoryResult = await generateMemoryFiles(answers);
+    details['memory'] = memoryResult;
+    filesCreated += memoryResult.created.length;
+    itemsSkipped += memoryResult.skipped.length;
+    return { dirsCreated, filesCreated, itemsSkipped, details };
+}
+/**
+ * Print a human-readable scaffold summary.
+ *
+ * @param result - Scaffold result to format
+ */
+export function formatScaffoldSummary(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('AgentFS scaffold complete!');
+    lines.push('');
+    lines.push(`  Directories created: ${result.dirsCreated}`);
+    lines.push(`  Files created:       ${result.filesCreated}`);
+    lines.push(`  Items skipped:       ${result.itemsSkipped}`);
+    lines.push('');
+    for (const [name, detail] of Object.entries(result.details)) {
+        if (detail.created.length > 0 || detail.skipped.length > 0) {
+            lines.push(`  [${name}]`);
+            for (const item of detail.created) {
+                lines.push(`    + ${item}`);
+            }
+            for (const item of detail.skipped) {
+                lines.push(`    ~ ${item} (exists)`);
+            }
+        }
+    }
+    lines.push('');
+    lines.push('Next steps:');
+    lines.push('  agentfs onboard    — let the agent learn about you');
+    lines.push('  agentfs compile    — generate native agent configs');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/generators/scaffold.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AgentFS public API barrel.
+ *
+ * Re-exports everything from the CLI entry point so that the package can also
+ * be used programmatically:
+ *
+ * ```ts
+ * import { main, VERSION } from 'create-agentfs';
+ * const code = await main(['node', 'agentfs', 'status']);
+ * ```
+ */
+export { main, VERSION } from './cli.js';
+export type { Subcommand } from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * AgentFS public API barrel.
+ *
+ * Re-exports everything from the CLI entry point so that the package can also
+ * be used programmatically:
+ *
+ * ```ts
+ * import { main, VERSION } from 'create-agentfs';
+ * const code = await main(['node', 'agentfs', 'status']);
+ * ```
+ */
+export { main, VERSION } from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/memory/confidence.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Confidence scoring engine for PATTERN entries in semantic memory.
+ *
+ * Implements the rules from docs/architecture.md Section 4:
+ *
+ *   New PATTERN  → confidence: 0.3  (DEFAULT_CONFIDENCE.initial)
+ *   Confirmed    → confidence += 0.2  (max 1.0)
+ *   Denied       → confidence -= 0.3
+ *   Inactive 30 days → confidence -= 0.1  (decay)
+ *   confidence < 0.1 → mark as superseded
+ *
+ * All functions are pure — they return a new `SemanticEntry` and never
+ * mutate the input.  Non-PATTERN entries are returned unchanged.
+ *
+ * @module memory/confidence
+ */
+import type { SemanticEntry } from '../types/index.js';
+/**
+ * Increases the confidence of a PATTERN entry by `confirmBoost` (default 0.2),
+ * capped at 1.0.
+ *
+ * Non-PATTERN entries are returned unchanged.
+ *
+ * @param entry - The entry to confirm.
+ * @returns A new entry with updated confidence.
+ */
+export declare function confirmPattern(entry: SemanticEntry): SemanticEntry;
+/**
+ * Decreases the confidence of a PATTERN entry by `denyPenalty` (default 0.3).
+ *
+ * If the result drops below `supersededThreshold` (0.1) the entry is
+ * automatically marked as superseded.
+ *
+ * Non-PATTERN entries are returned unchanged.
+ *
+ * @param entry - The entry to deny.
+ * @returns A new entry with updated confidence and status.
+ */
+export declare function denyPattern(entry: SemanticEntry): SemanticEntry;
+/**
+ * Applies time-based confidence decay to a PATTERN entry.
+ *
+ * Each full `decayDays`-period (default 30 days) of inactivity reduces
+ * confidence by `decayRate` (default 0.1).  Fractional periods are truncated.
+ *
+ * Examples:
+ * - 29 days inactive → 0 decay periods → no change
+ * - 30 days inactive → 1 decay period  → -0.1
+ * - 75 days inactive → 2 decay periods → -0.2
+ *
+ * Non-PATTERN entries are returned unchanged.
+ *
+ * @param entry             - The entry to decay.
+ * @param daysSinceLastSeen - Number of days since the pattern was last confirmed.
+ * @returns A new entry with decayed confidence (and possibly superseded status).
+ */
+export declare function decayPattern(entry: SemanticEntry, daysSinceLastSeen: number): SemanticEntry;
+/**
+ * Returns `true` when an entry has been marked as superseded.
+ *
+ * An entry is superseded when its `status` string starts with "superseded:".
+ * This covers both confidence-driven supersession and manual date-based
+ * supersession (e.g. `FACT: [superseded:2026-04-01] …`).
+ *
+ * @param entry - Any semantic entry.
+ * @returns Whether the entry is superseded.
+ */
+export declare function isSuperseded(entry: SemanticEntry): boolean;
+//# sourceMappingURL=confidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/memory/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA+CvD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAMlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAM/D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,iBAAiB,EAAE,MAAM,GACxB,aAAa,CAUf;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE1D"}