Method vault_intent_create

atomic-repository/src/repository/vault_intent.rs:105–247

Create a new vault intent. Allocates a JIRA-style ID (e.g., "PIMO-1") and creates an intent directory with an `intent.md` scaffold. The prefix is derived from the project directory name on first use (first 4 alphanumeric chars, uppercased). Intent paths are view-scoped and session-scoped: `intents/ / / /intent.md`

(
        &self,
        options: IntentCreateOptions,
    )

    /// Intent paths are view-scoped and session-scoped:
    /// `intents/<view>/<session>/<turn>/intent.md`
    pub fn vault_intent_create(
        &self,
        options: IntentCreateOptions,
    ) -> Result<IntentCreateResult, RepositoryError> {
        if !self.has_vault()? {
            return Err(RepositoryError::InvalidOperation {
                message: "Vault not initialized. Run `atomic vault init` first.".to_string(),
            });
        }

        let priority = options.priority.unwrap_or_else(|| "medium".to_string());
        let view_name = self.current_view().to_string();

        // Compute the session-scoped directory and file paths
        let intent_dir = self.intent_dir_for(options.session_id.as_deref(), options.turn_id);
        let intent_file = self.intent_file_for(options.session_id.as_deref(), options.turn_id);

        // Allocate ID inside a write transaction
        let intent_id;
        {
            let mut txn = self
                .pristine
                .write_txn()
                .map_err(|e| RepositoryError::Database(e.to_string()))?;
            let mut manifest = txn
                .get_vault_manifest()
                .map_err(|e| RepositoryError::Database(e.to_string()))?;

            // Set prefix on first use, derived from project directory name
            if manifest.intent_prefix.is_empty() {
                let project_name = self
                    .root
                    .file_name()
                    .and_then(|n| n.to_str())
                    .unwrap_or("vault");
                manifest.intent_prefix = VaultManifest::derive_intent_prefix(project_name);
                // Fallback if project name yields empty prefix
                if manifest.intent_prefix.is_empty() {
                    manifest.intent_prefix = "VAULT".to_string();
                }
            }

            intent_id = manifest.allocate_intent_id();

            // Add to manifest intents index
            manifest.intents.insert(
                intent_id.clone(),
                IntentSummary {
                    status: "backlog".to_string(),
                    priority: priority.clone(),
                    assignee: options.assignee.clone(),
                    goals: 0,
                    blocked_by: Vec::new(),
                    title: options.title.clone(),
                    vault_path: intent_file.clone(),
                },
            );