create-agentfs 0.1.1

package/dist/types/manifest.d.ts

@@ -0,0 +1,112 @@
+/**
+ * AgentFS Manifest — the heart of kernel space.
+ *
+ * Lives at `.agentos/manifest.yaml`. Defines what this vault is,
+ * which agents are supported, and how directories map to Linux FHS.
+ *
+ * @see docs/architecture.md Section 2 "Kernel Space"
+ */
+/** Vault profile type — determines directory layout and features. */
+export type Profile = 'personal' | 'company' | 'shared';
+/** Supported AI agent runtimes. */
+export type AgentRuntime = 'claude' | 'openclaw' | 'cursor';
+/** Security enforcement mode (AppArmor-style). */
+export type SecurityMode = 'enforce' | 'complain' | 'disabled';
+/**
+ * Linux FHS path keys — maps standard Linux paths to vault directories.
+ *
+ * Each key corresponds to a Linux FHS location:
+ * - `tmp` → `/tmp` (Inbox/)
+ * - `log` → `/var/log` (Daily/)
+ * - `spool` → `/var/spool` (Tasks/)
+ * - etc.
+ *
+ * @see docs/architecture.md Section 11 "FHS Mapping"
+ */
+export interface FhsPaths {
+    /** /tmp — entry point for new notes */
+    tmp: string;
+    /** /var/log — daily journals */
+    log: string;
+    /** /var/spool — task queues */
+    spool: string;
+    /** /home — active projects */
+    home: string;
+    /** /srv — content for publishing */
+    srv: string;
+    /** /usr/share — shared knowledge base */
+    usr_share: string;
+    /** /proc — active contacts (people) */
+    proc_people: string;
+    /** /etc — system configuration (.agentos) */
+    etc: string;
+    /** /var/archive — completed/archived items */
+    archive: string;
+    /** /home/contracts — client projects (personal profile) */
+    home_contracts?: string;
+    /** /usr/local/career — job search pipeline (personal profile) */
+    usr_local_career?: string;
+    /** /home/{user} — professional knowledge base (personal profile) */
+    home_user?: string;
+    /** /usr/share/media — media assets */
+    usr_share_media?: string;
+}
+/** Agent configuration within the manifest. */
+export interface AgentConfig {
+    /** Which agent is the primary runtime */
+    primary: AgentRuntime;
+    /** All supported agents (primary included) */
+    supported: AgentRuntime[];
+}
+/** Boot sequence configuration. */
+export interface BootConfig {
+    /** Ordered list of init.d/ scripts to load at boot */
+    sequence: string[];
+    /** Variable substitutions (e.g. `today: "$(date +%F)"`) */
+    variables?: Record<string, string>;
+}
+/** Frontmatter standards for vault files. */
+export interface FrontmatterConfig {
+    /** Fields that must be present in every file */
+    required: string[];
+    /** Recommended but optional fields */
+    standard?: string[];
+}
+/**
+ * Subagent completion status (Superpowers pattern).
+ *
+ * Written to `.agentos/proc/signals/` as status files for inter-agent communication.
+ */
+export type SubagentStatus = 'DONE' | 'DONE_WITH_CONCERNS' | 'BLOCKED' | 'NEEDS_CONTEXT';
+/** Lifecycle hook event names (inspired by OMC's 11-event model). */
+export type HookEvent = 'on-boot' | 'on-shutdown' | 'pre-compile' | 'post-compile' | 'on-commit' | 'on-file-create' | 'on-triage';
+/** Hook configuration — maps events to handler scripts. */
+export interface HooksConfig {
+    [event: string]: string[];
+}
+/**
+ * The full manifest schema — `.agentos/manifest.yaml`.
+ *
+ * This is the single source of truth for the vault.
+ * The compile pipeline reads this to generate native agent configs.
+ */
+export interface Manifest {
+    agentos: {
+        version: string;
+        profile: Profile;
+    };
+    vault: {
+        name: string;
+        owner: string;
+        created: string;
+    };
+    agents: AgentConfig;
+    paths: FhsPaths;
+    boot: BootConfig;
+    frontmatter: FrontmatterConfig;
+    /** Optional active modules */
+    modules?: string[];
+    /** Optional lifecycle hooks */
+    hooks?: HooksConfig;
+}
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qEAAqE;AACrE,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExD,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE5D,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,8CAA8C;IAC9C,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,oBAAoB,GACpB,SAAS,GACT,eAAe,CAAC;AAEpB,qEAAqE;AACrE,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,aAAa,GACb,aAAa,GACb,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,WAAW,CAAC;AAEhB,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB"}

package/dist/types/manifest.js

@@ -0,0 +1,10 @@
+/**
+ * AgentFS Manifest — the heart of kernel space.
+ *
+ * Lives at `.agentos/manifest.yaml`. Defines what this vault is,
+ * which agents are supported, and how directories map to Linux FHS.
+ *
+ * @see docs/architecture.md Section 2 "Kernel Space"
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/types/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types/memory.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Memory types — Tulving's cognitive taxonomy for AI agents.
+ *
+ * Three memory types:
+ * - Semantic: context-free facts (always loaded at boot)
+ * - Episodic: timestamped events (lazy-loaded by date)
+ * - Procedural: learned skills (lazy-loaded by name)
+ *
+ * @see docs/architecture.md Section 4 "Boot Sequence"
+ */
+/**
+ * Semantic memory entry types.
+ *
+ * - PREF: preferences ("no emoji in headings")
+ * - FACT: declarative facts ("[active] primary stack is K8s")
+ * - PATTERN: behavioral patterns with confidence ("[confidence:0.85] ...")
+ * - AVOID: anti-patterns ("don't suggest LangChain")
+ * - DIRECTIVE: imperative rules that must always be followed ("always run tests before commit")
+ */
+export type SemanticEntryType = 'PREF' | 'FACT' | 'PATTERN' | 'AVOID' | 'DIRECTIVE';
+/** Status of a semantic entry. */
+export type EntryStatus = 'active' | `superseded:${string}`;
+/**
+ * A single entry in semantic memory.
+ *
+ * Format in `semantic.md`:
+ * ```
+ * PREF: no emoji in headings
+ * FACT: [active] primary stack is Kubernetes + ArgoCD
+ * PATTERN: [confidence:0.85] more productive in the morning
+ * AVOID: don't suggest LangChain
+ * ```
+ */
+export interface SemanticEntry {
+    type: SemanticEntryType;
+    content: string;
+    status: EntryStatus;
+    /** Confidence score for PATTERN entries (0.0 - 1.0) */
+    confidence?: number;
+}
+/**
+ * Confidence scoring rules.
+ *
+ * - New pattern → 0.3
+ * - Confirmed → +0.2 (max 1.0)
+ * - Denied → -0.3
+ * - Inactive 30 days → -0.1 (decay)
+ * - Below 0.1 → superseded
+ */
+export interface ConfidenceConfig {
+    initial: number;
+    confirmBoost: number;
+    denyPenalty: number;
+    decayRate: number;
+    decayDays: number;
+    supersededThreshold: number;
+}
+/** Default confidence scoring configuration. */
+export declare const DEFAULT_CONFIDENCE: ConfidenceConfig;
+/** Episodic memory entry — one day's events. */
+export interface EpisodicEntry {
+    date: string;
+    events: string[];
+    decisions: string[];
+    lessons: string[];
+}
+/**
+ * Procedural memory — a learned skill/workflow.
+ *
+ * Follows SKILL.md pattern: frontmatter with triggers + description,
+ * body with steps and context. Agents can auto-match skills by trigger keywords.
+ */
+export interface ProceduralEntry {
+    name: string;
+    description: string;
+    steps: string[];
+    context: string;
+    /** Keywords that trigger this skill (e.g. ["deploy", "kubernetes", "rollout"]) */
+    triggers?: string[];
+    /** How often this skill was used (for distillation ranking) */
+    useCount?: number;
+    /** When this skill was last used (ISO date) */
+    lastUsed?: string;
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAEpF,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,cAAc,MAAM,EAAE,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,EAAE,gBAOhC,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/memory.js

@@ -0,0 +1,20 @@
+/**
+ * Memory types — Tulving's cognitive taxonomy for AI agents.
+ *
+ * Three memory types:
+ * - Semantic: context-free facts (always loaded at boot)
+ * - Episodic: timestamped events (lazy-loaded by date)
+ * - Procedural: learned skills (lazy-loaded by name)
+ *
+ * @see docs/architecture.md Section 4 "Boot Sequence"
+ */
+/** Default confidence scoring configuration. */
+export const DEFAULT_CONFIDENCE = {
+    initial: 0.3,
+    confirmBoost: 0.2,
+    denyPenalty: 0.3,
+    decayRate: 0.1,
+    decayDays: 30,
+    supersededThreshold: 0.1,
+};
+//# sourceMappingURL=memory.js.map

package/dist/types/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/types/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqDH,gDAAgD;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD,OAAO,EAAE,GAAG;IACZ,YAAY,EAAE,GAAG;IACjB,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,EAAE;IACb,mBAAmB,EAAE,GAAG;CACzB,CAAC"}

package/dist/types/security.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Security types — AppArmor-style Mandatory Access Control for AI agents.
+ *
+ * The security policy lives at `.agentos/security/policy.yaml`.
+ * It compiles into native enforcement rules per agent.
+ *
+ * @see docs/architecture.md Section 15 "Security Model"
+ */
+import type { SecurityMode } from './manifest.js';
+/** File access permission type. */
+export type FilePermission = 'r' | 'w' | 'rw' | 'x';
+/** Action to take on input validation match. */
+export type ValidationAction = 'warn' | 'quarantine' | 'block';
+/** File access control rules. */
+export interface FileAccessPolicy {
+    /** Default permission for all files */
+    default: FilePermission;
+    /** Glob patterns where agent can write freely */
+    allow_write: string[];
+    /** Glob patterns where agent needs user confirmation to write */
+    ask_write: string[];
+    /** Glob patterns agent cannot read */
+    deny_read: string[];
+    /** Glob patterns agent cannot write */
+    deny_write: string[];
+}
+/** Prompt injection detection pattern. */
+export interface ValidationPattern {
+    pattern: string;
+}
+/** Input validation configuration. */
+export interface InputValidationPolicy {
+    enabled: boolean;
+    scan_on_read: ValidationPattern[];
+    action: ValidationAction;
+    quarantine_path: string;
+}
+/** Exfiltration detection pattern. */
+export interface ExfilPattern {
+    regex: string;
+}
+/** Network/exfiltration control. */
+export interface NetworkPolicy {
+    deny_exfil_patterns: ExfilPattern[];
+    allowed_domains: string[];
+}
+/** Command control rules. */
+export interface CommandPolicy {
+    blocked: string[];
+    ask_before: string[];
+}
+/**
+ * Full security policy — `.agentos/security/policy.yaml`.
+ *
+ * Compiles into native enforcement:
+ * - Claude Code → `.claude/settings.json` permissions.deny[]
+ * - Others → advisory text in compiled output
+ */
+export interface SecurityPolicy {
+    version: string;
+    default_mode: SecurityMode;
+    file_access: FileAccessPolicy;
+    input_validation: InputValidationPolicy;
+    network: NetworkPolicy;
+    commands: CommandPolicy;
+}
+//# sourceMappingURL=security.d.ts.map

package/dist/types/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/types/security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;AAEpD,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;AAE/D,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,EAAE,cAAc,CAAC;IACxB,iDAAiD;IACjD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,mBAAmB,EAAE,YAAY,EAAE,CAAC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;CACzB"}

package/dist/types/security.js

@@ -0,0 +1,10 @@
+/**
+ * Security types — AppArmor-style Mandatory Access Control for AI agents.
+ *
+ * The security policy lives at `.agentos/security/policy.yaml`.
+ * It compiles into native enforcement rules per agent.
+ *
+ * @see docs/architecture.md Section 15 "Security Model"
+ */
+export {};
+//# sourceMappingURL=security.js.map

package/dist/types/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/types/security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types/setup.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Setup answers — collected from interactive prompts during `npx create-agentfs`.
+ *
+ * These answers drive all generators: filesystem, manifest, init.d, memory, etc.
+ *
+ * @see src/generators/ for consumers of this type
+ */
+import type { Profile, AgentRuntime } from './manifest.js';
+/**
+ * Answers collected from the interactive setup wizard.
+ *
+ * Every generator receives this as input — it's the contract
+ * between the prompts step and all downstream generators.
+ */
+export interface SetupAnswers {
+    /** Name of the vault (e.g. "my-notes", "company-kb") */
+    vaultName: string;
+    /** Owner name (person or team) */
+    ownerName: string;
+    /** Vault profile type */
+    profile: Profile;
+    /** Primary AI agent runtime */
+    primaryAgent: AgentRuntime;
+    /** All supported agent runtimes (includes primary) */
+    supportedAgents: AgentRuntime[];
+    /** Optional modules to enable */
+    modules: string[];
+    /** Target directory for the vault (defaults to cwd) */
+    targetDir: string;
+}
+/**
+ * Result of a single generator's execution.
+ * Used for the summary report at the end of scaffolding.
+ */
+export interface GeneratorResult {
+    /** What the generator created or skipped */
+    created: string[];
+    /** Files/dirs that already existed and were skipped */
+    skipped: string[];
+}
+/**
+ * Full scaffold result — aggregates all generator results.
+ */
+export interface ScaffoldResult {
+    /** Total directories created */
+    dirsCreated: number;
+    /** Total files created */
+    filesCreated: number;
+    /** Total items skipped (already existed) */
+    itemsSkipped: number;
+    /** Per-generator details */
+    details: Record<string, GeneratorResult>;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/types/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/types/setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,sDAAsD;IACtD,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C"}

package/dist/types/setup.js

@@ -0,0 +1,9 @@
+/**
+ * Setup answers — collected from interactive prompts during `npx create-agentfs`.
+ *
+ * These answers drive all generators: filesystem, manifest, init.d, memory, etc.
+ *
+ * @see src/generators/ for consumers of this type
+ */
+export {};
+//# sourceMappingURL=setup.js.map

package/dist/types/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/types/setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/utils/fhs-mapping.d.ts

@@ -0,0 +1,76 @@
+/**
+ * FHS Mapping Utility — Linux Filesystem Hierarchy Standard to vault path resolver.
+ *
+ * AgentFS maps standard Linux FHS paths to human-readable vault directories.
+ * This module provides per-profile default mappings and a resolution helper.
+ *
+ * @see docs/architecture.md Section 11 "FHS Mapping"
+ * @module fhs-mapping
+ */
+import type { FhsPaths, Profile } from '../types/index.js';
+/**
+ * Human-readable metadata for every FHS key.
+ *
+ * Each entry documents:
+ * - `linuxPath`   — the canonical Linux FHS location this key mirrors
+ * - `description` — semantic role in the vault context
+ *
+ * Agents and tooling can surface these descriptions in help text,
+ * validation errors, and generated documentation.
+ *
+ * @example
+ * ```ts
+ * const meta = FHS_DESCRIPTIONS.tmp;
+ * // { linuxPath: '/tmp', description: 'Entry point for new notes and captures' }
+ * ```
+ */
+export declare const FHS_DESCRIPTIONS: Record<keyof Required<FhsPaths>, {
+    linuxPath: string;
+    description: string;
+}>;
+/**
+ * Returns the default FHS → vault directory mapping for a given profile.
+ *
+ * The returned object is ready to be written into `manifest.yaml` under
+ * the `paths:` key. Profile-specific optional paths are included only when
+ * they apply to the chosen profile.
+ *
+ * Profile semantics:
+ * - `personal`  — solo engineer/creator; includes Work/, Career/, Engineering/
+ * - `company`   — team vault; home maps to Teams/, srv maps to Clients/
+ * - `shared`    — multi-user collaborative; home maps to Spaces/, usr_share maps to Shared/
+ *
+ * @param profile - The vault profile type.
+ * @returns A fully-populated `FhsPaths` object with sensible defaults.
+ *
+ * @example
+ * ```ts
+ * const paths = getDefaultPaths('personal');
+ * paths.tmp;            // 'Inbox'
+ * paths.home_contracts; // 'Work'
+ * ```
+ */
+export declare function getDefaultPaths(profile: Profile): FhsPaths;
+/**
+ * Resolves a FHS key to its vault-relative directory path.
+ *
+ * Looks up `fhsKey` in the provided `paths` object and returns the
+ * corresponding vault directory string. Throws a descriptive error when the
+ * key is present in the type but absent from the runtime object — this
+ * surfaces misconfigured manifests early rather than silently producing
+ * `undefined` paths downstream.
+ *
+ * @param fhsKey - A key from the `FhsPaths` interface (e.g. `'tmp'`, `'home'`).
+ * @param paths  - The resolved `FhsPaths` instance (e.g. from `manifest.paths`).
+ * @returns The vault-relative directory string for the given FHS key.
+ * @throws {Error} When `fhsKey` is an optional path not present in `paths`.
+ *
+ * @example
+ * ```ts
+ * const paths = getDefaultPaths('personal');
+ * resolveFhsPath('tmp', paths);            // 'Inbox'
+ * resolveFhsPath('home_contracts', paths); // 'Work'
+ * ```
+ */
+export declare function resolveFhsPath(fhsKey: keyof FhsPaths, paths: FhsPaths): string;
+//# sourceMappingURL=fhs-mapping.d.ts.map

package/dist/utils/fhs-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fhs-mapping.d.ts","sourceRoot":"","sources":["../../src/utils/fhs-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM3D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,MAAM,QAAQ,CAAC,QAAQ,CAAC,EACxB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAsD3C,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAkD1D;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAY9E"}